PerformAction メソッド

ユーザーによるコントロールの操作をシミュレートします。

シンタックス

Visual Basic

'宣言
 
Public Overridable Function PerformAction( _
   ByVal actionCode As UltraTreeAction, _
   ByVal shift As Boolean, _
   ByVal control As Boolean _
) As Boolean

C#

public virtual bool PerformAction( 
   UltraTreeAction actionCode,
   bool shift,
   bool control
)

パラメータ

actionCode

実行されるユーザー アクションを決定する UltraTreeAction 列挙体の値。

shift

シフト キーが押されたように動作が実行されるかどうかを指定するブール値。これは主に、シフト キーを押しながらグリッドの行の範囲を選択する時に既存の選択が拡張される場合に選択が関与および決定される動作に影響を与えます。

control

コントロール キーが押されたように動作が実行されるかどうかを指定するブール値。これは主に、コントロール キーを押しながらグリッドの行を選択する時に既存の選択が維持される場合に選択が関与および決定される動作に影響を与えます。

戻り値の型

アクションが問題なく完了した場合は True。アクションが失敗した場合は False。

解説

このメソッドは、ユーザーが実行できるアクションをシミュレートするために使用します。

アクションの多くは、特定の状況においてのみ適切です。アクションが不適切な場合、そのアクションは実行されません。たとえば、DeleteRows アクション (37 - KeyActionDeleteRows) を実行することによって行を削除しようとしても、行が選択されていない場合には、何の影響もありません。同様に、ドロップダウン切り替え動作 (14 - KeyActionToggleDropdown) を実行してセルのドロップダウンリストを切り替える操作は、列がそれに関連付けられたドロップダウンを持たない場合は無視されます。

CurrentState プロパティを使用して、アクションが実行されようとしているときにコントロールの状態を決定します。

使用例

Visual Basic

Imports Infragistics.Win.UltraWinTree

Private Sub button16_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles button16.Click

    Dim state As UltraTreeState

    ' ツリー コントロールの現在の状態を取得します
    state = Me.ultraTree1.CurrentState

    ' 状態ビット フラグをチェックし、InEdit ビットが設定されているかどうかを確認します
    ' ノードが編集モードでない場合のみ実行します
    If (state And UltraTreeState.InEdit) = 0 Then
        ' 編集モードではないため、
        ' アクティブなノードはチェックボックスであるかどうかを決定するビットをチェックします 
        ' その場合、ノードのチェック状態をトグルするために
        ' 操作の実行を呼び出します
        If (state And UltraTreeState.IsCheckbox) = UltraTreeState.IsCheckbox Then
            Me.ultraTree1.PerformAction(UltraTreeAction.ToggleCheckbox, False, False)
        End If

    End If

End Sub

C#

using Infragistics.Win.UltraWinTree;

private void button16_Click(object sender, System.EventArgs e)
{
	// ツリー コントロールの現在の状態を取得します
	UltraTreeState state = this.ultraTree1.CurrentState;

	// 状態ビット フラグをチェックし、InEdit ビットが設定されているかどうかを確認します
	// ノードが編集モードではない場合のみに実行します
	if ( ( state & UltraTreeState.InEdit ) == 0 )
	{
		// 編集モードではないため、
		// アクティブなノードはチェックボックスであるかどうかを決定するビットをチェックします 
		// その場合に、ノードのチェック状態をトグルするために
		// 操作の実行を呼び出します
		if ( ( state & UltraTreeState.IsCheckbox ) == UltraTreeState.IsCheckbox )
			this.ultraTree1.PerformAction( UltraTreeAction.ToggleCheckbox, false, false );
	}
		
}