バージョン

KeyActionMappings プロパティ (UltraTree)

TreeKeyActionMapping クラスのインスタンス (各インスタンスは特定のキーストロークに関連付けられたアクションを定義します) を含む TreeKeyActionMappings インスタンスを返します。
シンタックス
'宣言
 
Public ReadOnly Property KeyActionMappings As TreeKeyActionMappings
public TreeKeyActionMappings KeyActionMappings {get;}
解説

コントロールのデフォルトのキーボード動作は、UltraTree コントロールがインスタンス化されるときの TreeKeyActionMappings コレクションの内容によって決まります。デフォルトのマッピングを削除したり、カスタムのマッピングを追加したりすることで、キーボード動作を変更できます。

KeyActionMapping オブジェクトを変更、削除、または追加することで、コントロールのキーボード動作を変更できます。

次の表は、UltraTree コントロールのデフォルトのキーマッピングをリストしたものです。

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
NextNode NodeHasChildren InEdit, NodeExpandable, ActiveCell なし AltCtrl
ParentNode NodeChild InEdit, NodeExpanded, ActiveCell なし AltCtrl
Up PrevNode なし InEdit, ActiveCell なし AltCtrl
Down NextNode なし InEdit, ActiveCell なし AltCtrl
Home FirstNode なし InEdit, ActiveCell なし AltCtrl
End LastNode なし InEdit, ActiveCell なし AltCtrl
ExpandNode NodeExpandable InEdit, ActiveCell なし Alt
CollapseNode NodeExpanded InEdit, ActiveCell なし Alt
Prior PageUp なし InEdit, ActiveCell なし AltCtrl
Next PageDown なし InEdit, ActiveCell なし AltCtrl
Esc ExitEditMode InEdit CellInEditMode なし Alt
Enter ExitEditModeAndSave InEdit CellInEditMode なし AltCtrl
F2 EnterEditMode なし InEdit, ActiveCell なし Alt
F2 ExitEditModeAndSave InEdit CellInEditMode なし Alt
Multiply ExpandAllNode なし InEdit, ActiveCell なし すべて
Add ExpandNode NodeExpandable InEdit, ActiveCell なし Alt
Subtract CollapseNode NodeExpanded InEdit, ActiveCell なし Alt
Back ParentNode NodeChild InEdit, ActiveCell なし AltCtrl
Space ToggleSelection なし InEdit, ActiveCell Ctrl Alt
Space ClearAllSelectedNodes なし InEdit, ActiveCell なし AltCtrl
Space SelectActiveNode なし InEdit, ActiveCell なし AltCtrl
Space ToggleCheckbox IsCheckbox InEdit, ActiveCell なし AltCtrl
Space CheckOptionButton IsOptionButton InEdit, ActiveCell なし AltCtrl
Delete DeleteNodes なし InEdit, ActiveCell なし AltCtrl
ExpandNode NodeExpandable InEdit, ActiveCell Ctrl Alt
CollapseNode NodeExpanded InEdit, ActiveCell Ctrl Alt
Up PrevNodeNoSelect なし InEdit, ActiveCell Ctrl Alt
Down NextNodeNoSelect なし InEdit, ActiveCell Ctrl Alt
Home FirstNodeNoSelect なし InEdit, ActiveCell Ctrl Alt
End LastNodeNoSelect なし InEdit, ActiveCell Ctrl Alt
Prior PageUpNoSelect なし InEdit, ActiveCell Ctrl Alt
Next PageDownNoSelect なし InEdit, ActiveCell Ctrl Alt
X Cut AllowCut InEdit, ActiveCell Ctrl AltShift
C Copy AllowCopy InEdit, ActiveCell Ctrl AltShift
V 貼り付け AllowPaste InEdit, ActiveCell Ctrl AltShift
Delete Cut AllowCut InEdit, ActiveCell Shift AltCtrl
Insert Copy AllowCopy InEdit, ActiveCell Ctrl AltShift
Insert 貼り付け AllowPaste InEdit, ActiveCell Shift AltCtrl
NoAction なし InEdit, NodeChild, NodeExpanded, ActiveCell なし AltCtrl
NoAction なし InEdit, NodeHasChildren, ActiveCell なし AltCtrl
ParentNode NodeChild, NodeExpanded InEdit, NodeHasChildren, ActiveCell なし AltCtrl
NextNode ActiveCell, ActiveCellIsInLastLogicalColumn CellInEditMode, NextNodeDisplaysCells なし すべて
Down NextNode ActiveCell, ActiveCellIsOnLastLogicalRow CellInEditMode, NextNodeDisplaysCells なし すべて
PrevNode ActiveCell, ActiveCellIsInFirstLogicalColumn CellInEditMode, PreviousNodeDisplaysCells なし すべて
Up PrevNode ActiveCell, ActiveCellIsOnFirstLogicalRow CellInEditMode, PreviousNodeDisplaysCells なし すべて
Home FirstCellInNode ActiveCell CellInEditMode, FirstCellActive なし すべて
End LastCellInNode ActiveCell CellInEditMode, LastCellActive なし すべて
Home FirstCellInNodesCollection FirstCellActive CellInEditMode なし すべて
End LastCellInNodesCollection LastCellActive CellInEditMode なし すべて
Home FirstCellInTree ActiveCell CellInEditMode Ctrl AltShift
End LastCellInTree ActiveCell CellInEditMode Ctrl AltShift
End LastCellInTree ActiveCell CellInEditMode Ctrl AltShift
NextCell ActiveCell CellInEditMode なし すべて
PreviousCell ActiveCell CellInEditMode なし すべて
Up AboveCell ActiveCell CellInEditMode なし すべて
Down BelowCell ActiveCell CellInEditMode なし すべて
F2 EnterEditModeOnCell ActiveCell CellInEditMode なし すべて
F2 ExitEditModeOnCellSaveChanges ActiveCell, CellInEditMode なし なし すべて
Esc UndoCellEdit ActiveCell, CellInEditMode なし なし すべて
Esc UndoNodeEdit HasNodeChangesPending InEdit, CellInEditMode なし すべて
Tab SelectNextControl LastCellActive, LastNodeActive TabKeyNavigatesToNextCell, TabKeyNavigatesToNextControl なし すべて
Tab SelectPreviousControl FirstCellActive, FirstNodeActive TabKeyNavigatesToNextCell, TabKeyNavigatesToNextControl Shift AltCtrl
Tab NextCellEnterEditMode ActiveCell なし なし すべて
Tab PreviousCellEnterEditMode ActiveCell なし Shift AltCtrl
Space DeactivateCell ActiveCell CellInEditMode Ctrl AltShift
Space FirstCellInNode ActiveNodeDisplaysCells ActiveCell Ctrl AltShift

使用例
Imports Infragistics.Win.UltraWinTree

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load

    Dim newAction As TreeKeyActionMapping

    ' ユーザーが ('Alt' キーを押さずに) 'X' キーを押したときに、
    ' アクティブ ノードの展開状態を切り替えるために
    ' 2 つの KeyActionMappings を追加します

    ' 最初のマッピングは、展開可能なノードが
    ' 展開されていない状態で、編集モードではない場合、
    ' ユーザーが 'X' キーを押すと、ノードを展開します
    newAction = New TreeKeyActionMapping( _
       Keys.X, _
       UltraTreeAction.ExpandNode, _
       UltraTreeState.InEdit Or UltraTreeState.NodeExpanded, _
       UltraTreeState.NodeExpandable, _
       Infragistics.Win.SpecialKeys.Alt, _
         0)

    Me.ultraTree1.KeyActionMappings.Add(newAction)

    ' 最初のマッピングの状態は、ノードが展開されていて、
    ' 編集モードでない場合にユーザーが 'X' キーを押すと、 
    ' ノードを縮小します
    newAction = New TreeKeyActionMapping( _
       Keys.X, _
       UltraTreeAction.CollapseNode, _
       UltraTreeState.InEdit, _
       UltraTreeState.NodeExpanded, _
       Infragistics.Win.SpecialKeys.Alt, _
         0)

    Me.ultraTree1.KeyActionMappings.Add(newAction)

End Sub
using System.Diagnostics;
using Infragistics.Win.UltraWinTree;

private void Form1_Load(object sender, System.EventArgs e)
{

	// ユーザーが ('Alt' キーを押さずに) 'X' キーを押したときに、
	// アクティブ ノードの展開状態を切り替えるために
	// 2 つの KeyActionMappings を追加します

	// 最初のマッピングは、展開可能なノードが
	// 展開されていない状態で、編集モードではない場合、
	// ユーザーが 'X' キーを押すと、ノードを展開します
	 this.ultraTree1.KeyActionMappings.Add(
		new TreeKeyActionMapping( 
					// キー コード
					Keys.X,
					// 実行する操作
					UltraTreeAction.ExpandNode,
					// 操作の実行が禁止される状態
					UltraTreeState.InEdit | UltraTreeState.NodeExpanded, 
					// 要求される状態 
					UltraTreeState.NodeExpandable, 
					// 操作の実行が禁止される特別なキー
					Infragistics.Win.SpecialKeys.Alt, 
					// 要求される特別なキー (なし)
					0 ) );

	// 最初のマッピングは、展開されているノードが
	// 編集モードではない場合に、ユーザーが 'X' キーを押すと、 
	// ノードを縮小します
	this.ultraTree1.KeyActionMappings.Add(
		new TreeKeyActionMapping( 
					// キー コード
					Keys.X,
					// 実行する操作
					UltraTreeAction.CollapseNode,
					// 操作の実行が禁止される状態
					UltraTreeState.InEdit, 
					// 要求される状態
					UltraTreeState.NodeExpanded, 
					// 操作の実行が禁止される特別なキー
					Infragistics.Win.SpecialKeys.Alt, 
					// 必要な特別なキー (なし)
					0 ) );

}
参照