GrapeCity.Win.MultiRow.v80 アセンブリ > GrapeCity.Win.MultiRow 名前空間 > GcMultiRow クラス : CellTouchToolBarNeeded イベント |
Public Event CellTouchToolBarNeeded As EventHandler(Of CellTouchToolBarNeededEventArgs)
public event EventHandler<CellTouchToolBarNeededEventArgs> CellTouchToolBarNeeded
イベント ハンドラが、このイベントに関連するデータを含む、CellTouchToolBarNeededEventArgs 型の引数を受け取りました。次の CellTouchToolBarNeededEventArgs プロパティには、このイベントの固有の情報が記載されます。
プロパティ | 解説 |
---|---|
CellIndex | 親Section内でのセルのインデックスを取得します。 GrapeCity.Win.MultiRow.CellEventArgsから継承されます。 |
CellName | セルの名前を取得します。 GrapeCity.Win.MultiRow.CellEventArgsから継承されます。 |
RowIndex | イベントが発生したオーナーRowのインデックスを取得します。 GrapeCity.Win.MultiRow.CellEventArgsから継承されます。 |
Scope | イベントが発生したセルの領域を取得します。 GrapeCity.Win.MultiRow.CellEventArgsから継承されます。 |
SectionIndex | イベントが発生したオーナーSectionのインデックスを取得します。 GrapeCity.Win.MultiRow.CellEventArgsから継承されます。 |
TouchToolBar | GcMultiRow.CellTouchToolBarNeeded イベントを発生させたセルのタッチツールバーを取得または設定します。 |
このイベントは、VirtualMode プロパティが true の場合、または DataSource プロパティが null 参照 (Visual Basicでは Nothing) でない場合にのみ発生します。
CellTouchToolBarNeeded イベントを処理すると、ユーザーがセルの長押しまたは既に選択されたセルをタップしたときに、ハンドラで指定したタッチツールバーが表示されます。これは、セルの現在の状態または値に基づいて決定されたタッチツールバーを表示する場合に役立ちます。
CellTouchToolBarNeeded イベントは、Cell.TouchToolBar プロパティの値が取得されたとき(プログラムによって取得されたとき、またはユーザーがセルの長押しまたは既に選択されたセルをタップしたとき)にも発生します。
CellEventArgs.CellIndex プロパティと CellEventArgs.RowIndex プロパティを使用してしてセルの状態または値を確認し、その情報に基づいて CellTouchToolBarNeededEventArgs.TouchToolBar プロパティを変更できます。このプロパティはセルの Cell.TouchToolBar プロパティの値で初期化されます(その後、このイベントの値によってオーバーライドされます)。
大量のデータを操作しているとき、複数のセルの Cell.TouchToolBar 値を設定するとパフォーマンスペナルティが生じますが、CellTouchToolBarNeeded イベントを処理することでこのような事態を回避できます。
また、個々のセルではなく個々のセクションにタッチツールバーを指定することもできます。そのためには、セクションの Section.TouchToolBar プロパティを設定するか、GcMultiRowコントロールの SectionTouchToolBarNeeded イベントを処理します。セルの Cell.TouchToolBar プロパティを設定すると、セクションの Section.TouchToolBar プロパティの設定がオーバーライドされます。また、CellTouchToolBarNeeded イベントは、 SectionTouchToolBarNeeded イベントとセクションの Section.TouchToolBar プロパティ設定の両方をオーバーライドします。ただし、セクションのタッチツールバーがオーバーライドされないように、セルのタッチツールバーに null 参照 (Visual Basicでは Nothing) を指定することもできます。