ButtonToolClick イベント

メニュー内のボタン ツールがクリックされたときに発生します。

シンタックス

Visual Basic

'宣言
 
Public Event ButtonToolClick As ButtonToolClickEventHandler

C#

public event ButtonToolClickEventHandler ButtonToolClick

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、ButtonToolClickEventArgs 型の引数を受け取りました。次の ButtonToolClickEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
ColumnFilter	現在のフィルター操作と関連付けられた列フィルターを返します。
Handled System.ComponentModel.HandledEventArgsから継承されます。
Tool	クリックされたツールを返します。

解説

このイベントは、登録済みの Infragistics.Win.UltraWinGrid.SpecialFilterOperand に自動的に作成されるボタンを含む FilterButtonTool から派生するすべてのツールに対して発生します。このイベントを処理済みにマークすると、関連付けられた列へのフィルターの適用を含む、デフォルト論理が実行されるのを禁止します。

使用例

Visual Basic

Imports Infragistics.Win.SupportDialogs.FilterUIProvider

Private Sub ultraGridFilterUIProvider1_ButtonToolClick(ByVal sender As Object, ByVal e As ButtonToolClickEventArgs) 
    Dim operandTool As FilterOperandTool = TryCast(e.Tool, FilterOperandTool) 
    If operandTool IsNot Nothing AndAlso operandTool.Operand.Name = "Quarter1" Then 
        ' Prevent the operand for "Quarter 1" from doing any filtering and notify the user as such 
        e.Handled = True 
        MessageBox.Show("You don't want Quarter 1; it's colder. Wait for a warmer quarter") 
    End If 
End Sub

C#

using Infragistics.Win.SupportDialogs.FilterUIProvider;

private void ultraGridFilterUIProvider1_ButtonToolClick(object sender, ButtonToolClickEventArgs e)
{
    FilterOperandTool operandTool = e.Tool as FilterOperandTool;
    if (operandTool != null && operandTool.Operand.Name == "Quarter1")
    {
        // Prevent the operand for "Quarter 1" from doing any filtering and notify the user as such
        e.Handled = true;
        MessageBox.Show("You don't want Quarter 1; it's colder.  Wait for a warmer quarter");
    }
}