'宣言 Public Event BeforeCellListDropDown As CancelableCellEventHandler
public event CancelableCellEventHandler BeforeCellListDropDown
イベント ハンドラが、このイベントに関連するデータを含む、CancelableCellEventArgs 型の引数を受け取りました。次の CancelableCellEventArgs プロパティには、このイベントの固有の情報が記載されます。
プロパティ | 解説 |
---|---|
Cancel System.ComponentModel.CancelEventArgsから継承されます。 | |
Cell | 対象となるセルへの参照を返します。 |
cell 引数は、ドロップダウン リストがドロップダウンされるセルのプロパティの設定やそのメソッドの呼び出しに使用できる、UltraGridCell オブジェクトへの参照を返します。この参照を使用して、返されるセルのプロパティまたはメソッドにアクセスできます。
cancel 引数を使用して、セルのドロップダウン リストがドロップダウンされないようにプログラミングできます。一定の条件が満たされない限り、ドロップダウン リストがドロップダウンされないようにすることが可能です。
このイベントは、ユーザーによる操作、またはプログラム操作でセルのドロップダウン リストがドロップダウンされようとする時に生成されます。セルのドロップダウン リストは、セルの DroppedDown プロパティを True に設定することでプログラムでドロップダウンすることができます。
このイベントは、列の Style プロパティが 4 (StyleDropDown)、5 (StyleDropDownList)、6 (StyleDropDownValidate)、または 8 (StyleDropDownCalendar) に設定されているセルに限って生成されます。
ドロップダウン リストを格納するために列の ValueList プロパティを ValueList オブジェクトに設定します。
セルのドロップダウン リストがドロップダウンされると、AfterCellListCloseUp イベントが生成されます。
Imports Infragistics.Shared Imports Infragistics.Win Imports Infragistics.Win.UltraWinGrid Private Sub UltraGrid1_BeforeCellListDropDown(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinGrid.CancelableCellEventArgs) Handles ultraGrid1.BeforeCellListDropDown ' セルのドロップダウン矢印をクリックするなど、ユーザーがセルで ' ドロップダウンを開くときに、BeforeCellListDropDown が発生します ' 以下のコードは、値リストの項目の数が 0 の場合、UltraGrid でドロップダウンを ' 開けないようにするため、イベントをキャンセルします If Not Nothing Is e.Cell.Column.ValueList AndAlso e.Cell.Column.ValueList.ItemCount <= 0 Then e.Cancel = True End If End Sub
using Infragistics.Shared; using Infragistics.Win; using Infragistics.Win.UltraWinGrid; using System.Diagnostics; private void ultraGrid1_BeforeCellListDropDown(object sender, Infragistics.Win.UltraWinGrid.CancelableCellEventArgs e) { // セルのドロップダウン矢印をクリックするなど、ユーザーがセルで // ドロップダウンを開くときに、BeforeCellListDropDown が発生します // 以下のコードは、値リストの項目の数が 0 の場合、UltraGrid でドロップダウンを // 開けないようにするため、イベントをキャンセルします if ( null != e.Cell.Column.ValueList && e.Cell.Column.ValueList.ItemCount <= 0 ) { e.Cancel = true; } }