メッセージボックスによる通知（MessageBoxNotify）

MessageBoxNotifyを使用すると、検証エラーをメッセージボックスの表示で通知します。メッセージボックスのタイトル、テキスト、アイコンは変更できます。

デザイナによる設定

デザイナでセルの検証と共にValueProcessを使用するには、次のように操作します。

値を検証するセルを選択する。(例: textBoxCell1)
プロパティウィンドウでValidatorsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidatorコレクションエディタで左上のコンボボックスから「RequiredFieldValidator」を選択し、［追加］をクリックする。
画面右のプロパティグリッドでActionsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidateActionコレクションエディタでMessageBoxNotifyを追加する。
[メンバ]リストでMessageBoxNotifyが選択されていることを確認する。
画面右のプロパティグリッドでCaptionプロパティにタイトルを入力する。
画面右のプロパティグリッドでDoActionReasonプロパティにCellValidationgを設定する。
画面右のプロパティグリッドでIconプロパティにHandを設定する。
画面右のプロパティグリッドでMessageプロパティに説明を入力する。
［OK］ボタンをクリックしてCellValidateActionコレクションエディタを閉じる。
［OK］ボタンをクリックしてCellValidatorコレクションエディタを閉じる。
デザイナのドキュメントウィンドウのタブを「実行時」に切り替える。
textBoxCell1を変更せずに次のセルに移動して検証エラーが表示されることを確認する。

コーディングによる設定

次のコードは、文字列型セルの値が空白のとき検証エラーとしてメッセージボックスを表示します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow

Dim TextBoxCell1 As New TextBoxCell()
Dim RequiredFieldValidator1 As New RequiredFieldValidator()
Dim MessageBoxNotify1 As New MessageBoxNotify()
MessageBoxNotify1.Caption = "タイトル"
MessageBoxNotify1.DoActionReason = ValidateReasons.CellValidating
MessageBoxNotify1.Icon = MessageBoxIcon.Hand
MessageBoxNotify1.Message = "エラー"
RequiredFieldValidator1.Actions.Add(MessageBoxNotify1)
TextBoxCell1.Validators.Add(RequiredFieldValidator1)

Dim cells As Cell() = {TextBoxCell1}
GcMultiRow1.Template = Template.CreateGridTemplate(cells)
GcMultiRow1.RowCount = 10

using GrapeCity.Win.MultiRow;

TextBoxCell textBoxCell1 = new TextBoxCell();
RequiredFieldValidator requiredFieldValidator1 = new RequiredFieldValidator();
MessageBoxNotify messageBoxNotify1 = new MessageBoxNotify();
messageBoxNotify1.Caption = "タイトル";
messageBoxNotify1.DoActionReason = ValidateReasons.CellValidating;
messageBoxNotify1.Icon = MessageBoxIcon.Hand;
messageBoxNotify1.Message = "エラー";
requiredFieldValidator1.Actions.Add(messageBoxNotify1);
textBoxCell1.Validators.Add(requiredFieldValidator1);

Cell[] cells = { textBoxCell1 };
gcMultiRow1.Template = Template.CreateGridTemplate(cells);
gcMultiRow1.RowCount = 10;

MessageBoxNotifyで表示されるメッセージボックスのボタンはOKのみになります。