RowErrorTextNeeded イベント

行のエラーテキストが必要になると発生します。

構文

Public Event RowErrorTextNeeded As EventHandler(Of RowErrorTextNeededEventArgs)

public event EventHandler<RowErrorTextNeededEventArgs> RowErrorTextNeeded

イベントデータ

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

プロパティ	解説
ErrorText	現在のRowのエラーを表す文字列を取得または設定します。
RowIndex	Rowのインデックスを取得します。

解説

RowErrorTextNeededイベントは、GcMultiRowコントロールのDataSourceプロパティが設定されている場合、またはそのVirtualModeプロパティがtrueの場合にのみ発生します。RowErrorTextNeededイベントは、ユーザーが行の状態または行に含まれる値に基づいて行のエラーを判断する場合に役立ちます。
ユーザーがRowErrorTextNeededイベントを処理してハンドラ内でエラーテキストを指定すると、ShowRowErrorsプロパティまたはRowHeaderCell.ShowRowErrorプロパティがfalseに設定されている場合を除き、行ヘッダセルにエラーグリフが表示されます。ユーザーがマウスポインタをエラーグリフの上に移動すると、ツールチップにエラーテキストが表示されます。
RowErrorTextNeededイベントは、Row.ErrorTextプロパティの値が取得されたときにも発生します。
ユーザーはRowErrorTextNeededEventArgs.RowIndexプロパティを使用して行の状態または行に含まれる値を確認し、その情報に基づいてRowErrorTextNeededEventArgs.ErrorTextプロパティを変更できます。このプロパティは行のErrorTextプロパティの値で初期化されます（その後、このイベントの値によってオーバーライドされます）。

参照