バージョン

KeyActionMappings プロパティ (UltraGrid)

ユーザーのキー入力に応じたコントロールの動作を設定します。
シンタックス
'宣言
 
Public ReadOnly Property KeyActionMappings As GridKeyActionMappings
public GridKeyActionMappings KeyActionMappings {get;}
解説

KeyActionMappings プロパティを使用すると、ユーザーのキーボード入力を処理するためのメカニズムにアクセスできます。選択、移動、編集などのアクションに使用されるキーストロークはすべてテーブルベースのシステムに保存されており、このプロパティを使用して確認したり変更したりできます。KeyActionsMappings プロパティを使用すれば、コントロールのキーボード レイアウトをカスタマイズして、アプリケーションの対話性に関する独自の基準に合わせることができます。

たとえば、F8 キーを押したときにセルの間を移動できるようにしたい場合は、この動作を追加できます。アクションに関連付けるキーコードと特殊修飾キーを指定できるほか、特定のコンテキストでキーマッピングが適用されるかどうかを決定できます。

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

KeyCode ActionCode StateRequired StateDisallowed SpecialKeysRequired SpecialKeysDisallowed
右 NextCell セル InEdit AltCtrl
Tab NextCellByTab セル すべて
左 PrevCell セル InEdit AltCtrl
Tab PrevCellByTab セル Shift AltCtrl
Up AboveCell セル InEdit Alt
Down BelowCell セル InEdit Alt
Home FirstRowInBand Row セル AltCtrl
End LastRowInBand Row セル AltCtrl
右 FirstRowInGrid Row Alt
Down FirstRowInGrid Row Alt
Home FirstRowInGrid Row セル Ctrl Alt
End LastRowInGrid Row セル Ctrl Alt
右 ExpandRow RowExpandable Cell, RowExpanded Alt
左 CollapseRow RowExpanded セル Alt
右 NextRow Row Cell, RowExpandable Alt
右 NextRow Row, RowExpanded セル Alt
Tab NextRowByTab Row Cell, LastRowInGrid すべて
左 PrevRow Row Cell, RowExpanded Alt
Tab PrevRowByTab Row Cell, FirstRowInGrid Shift AltCtrl
Up AboveRow Row セル Alt
Down BelowRow Row セル Alt
Space ToggleCheckbox InEdit, IsCheckbox すべて
Space ToggleCellSel セル InEdit すべて
Space ToggleRowSel Row セル すべて
Space DeactivateCell セル Ctrl AltShift
Space ActivateCell Row セル Ctrl AltShift
右 NextCellInBand セル InEdit Ctrl Alt
左 PrevCellInBand セル InEdit Ctrl Alt
Home FirstCellInRow セル CellFirst, InEdit AltCtrl
End LastCellInRow セル CellLast, InEdit AltCtrl
Home FirstCellInBand CellFirst InEdit AltCtrl
End LastCellInBand CellLast InEdit AltCtrl
Home FirstCellInGrid セル InEdit Ctrl Alt
End LastCellInGrid セル InEdit Ctrl Alt
Prior PageUpCell セル InEdit Alt
Next PageDownCell セル InEdit Alt
Prior PageUpRow Row セル Alt
Next PageDownRow Row セル Alt
Esc UndoCell InEdit IsDroppedDown Alt
Esc UndoRow Row, RowDirty InEdit Alt
Enter ExpandRow GroupByRow IsDroppedDown, RowExpanded Alt
Enter CollapseRow RowExpanded, GroupByRow IsDroppedDown Alt
F4 ToggleDropdown HasDropdown, InEdit Alt
Up ToggleDropdown HasDropdown, InEdit Alt
Down ToggleDropdown HasDropdown, InEdit Alt
F2 ToggleEditMode セル SwapDroppedDown Alt
F4 EnterEditModeAndDropdown HasDropdown InEdit Alt
Up EnterEditModeAndDropdown HasDropdown InEdit Alt
Down EnterEditModeAndDropdown HasDropdown InEdit Alt
F6 NextRegion InEdit すべて
F6 PrevRegion InEdit Shift AltCtrl
Delete DeleteRows Row InEdit すべて
右 NextCellInBand Cell, InEdit, IsCheckbox
左 PrevCellInBand Cell, InEdit, IsCheckbox
Up AboveCell Cell, InEdit, IsCheckbox
Down BelowCell Cell, InEdit, IsCheckbox

使用例
Imports Infragistics.Win.UltraWinGrid

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

     Dim newMapping As GridKeyActionMapping

    ' グリッドにカスタムキーと動作マッピングを追加します 
    ' 編集モードではなく、グリッドがフォーカスを持つ場合、 
    ' 'Alt' キーが押されていなくて、ユーザーが 'H' キーを押すと、 
    ' 最初の行に
    ' 移動します 
    newMapping = New GridKeyActionMapping(Keys.H, UltraGridAction.FirstRowInGrid, UltraGridState.InEdit, 0, Infragistics.Win.SpecialKeys.Alt, 0)

    Me.ultraGrid1.KeyActionMappings.Add(newMapping)

    ' 注: この概念は UltraCombo コントロールにも適用されますが、
    ' コンボの KeyActionMappings は
    ' マッピング クラス、関連付ける状態および操作フラグの
    ' コレクションです
    ' (ComboKeyActionMapping、UltraComboAction、および
    ' UltraComboState など)

End Sub
using Infragistics.Win.UltraWinGrid;

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

	this.oleDbDataAdapter1.Fill( this.dataSet11 );

	// グリッドにカスタムキーと動作マッピングを追加します 
	// 編集モードではなく、グリッドがフォーカスを持つ場合、 
	// 'Alt' キーが押されていなくて、ユーザーが 'H' キーを押すと、 
	// 最初の行に
	// 移動します 
	this.ultraGrid1.KeyActionMappings.Add( 
		new GridKeyActionMapping( 
			// キー コード
			Keys.H,
			// 実行する操作
			UltraGridAction.FirstRowInGrid,
			// 操作の実行が禁止される状態
			UltraGridState.InEdit, 
			// 必要な状態 (なし)
			0, 
			// 操作の実行が禁止される特別なキー
			Infragistics.Win.SpecialKeys.Alt, 
			// 必要な特別なキー (なし)
			0 ) );

	// 注: この概念は UltraCombo コントロールにも適用されますが、
	// コンボの KeyActionMappings は
	// マッピング クラス、関連付ける状態および操作フラグの
	// コレクションです
	// (ComboKeyActionMapping、UltraComboAction、および
	// UltraComboState など)

}
参照