KeyActionMappings プロパティ (UltraCombo)

ユーザーのキー入力に応じたコントロールの動作を設定します。

シンタックス

Visual Basic

'宣言
 
Public ReadOnly Property KeyActionMappings As ComboKeyActionMappings

C#

public ComboKeyActionMappings KeyActionMappings {get;}

解説

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

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

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

KeyCode	ActionCode	StateRequired	StateDisallowed	SpecialKeysRequired	SpecialKeysDisallowed
Up	PrevRow	Row			Alt
Down	NextRow	Row			Alt
Up	FirstRow		Row		Alt
Down	FirstRow		Row		Alt
右	FirstRow		Row, HasEdit		Alt
左	FirstRow		Row, HasEdit		Alt
Home	FirstRow	IsDroppedDown			AltCtrl
End	LastRow	IsDroppedDown			AltCtrl
右	NextRow	Row	HasEdit		Alt
左	PrevRow	Row	HasEdit		Alt
Prior	PageUp	Row			Alt
Next	PageDown	Row			Alt
Esc	CloseDropdown	IsDroppedDown			Alt
Enter	CloseDropdown	IsDroppedDown			Alt
F4	ToggleDropdown				Alt
Up	ToggleDropdown			Alt
Down	ToggleDropdown			Alt

使用例

Visual Basic

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

C#

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 など)

}