KeyActionMappings プロパティ (UltraTree)

TreeKeyActionMapping クラスのインスタンス (各インスタンスは特定のキーストロークに関連付けられたアクションを定義します) を含む TreeKeyActionMappings インスタンスを返します。

シンタックス

Visual Basic
C#

'宣言
 
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

使用例

Visual Basic

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 ) );

}

参照

UltraTree クラス
 UltraTree メンバ

Windows Forms | ヘルプ トピック

KeyActionMappings プロパティ (UltraTree)

参照

Windows Forms | ヘルプトピック