サロゲート文字の検証（SurrogateCharValidator）

SurrogateCharValidatorを使用すると、セルにサロゲート文字が入力されているかどうかを検証できます。

デザイナによる設定

デザイナでサロゲート文字の検証を設定するには、次のように操作します。この例では、文字列型セルに全角カタカナ以外の文字列が入力されたときに検証エラーを表示します。

値を検証するセルを選択する。(例: textBoxCell1)
プロパティウィンドウでValidatorsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidatorコレクションエディタで左上のコンボボックスから「SurrogateCharValidator」を選択し、［追加］をクリックする。
[メンバ]リストでSurrogateCharValidatorが選択されていることを確認する。
画面右のプロパティグリッドでActionsプロパティを選択し、［...］ボタンをクリックする。
表示されたCellValidateActionコレクションエディタでLineNotifyを追加する。
［OK］ボタンをクリックしてCellValidateActionコレクションエディタを閉じる。
［OK］ボタンをクリックしてCellValidatorコレクションエディタを閉じる。
デザイナのドキュメントウィンドウのタブを「実行時」に切り替える。
環境依存文字（例：「しかる」の変換結果の１つ）を入力してセルを移動したときに検証エラーになることを確認する。

コーディングによる設定

次のコードは、セルにサロゲート文字が入力された場合に検証エラーを表示します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow

Dim TextBoxCell1 As New TextBoxCell()
Dim SurrogateCharValidator1 As New SurrogateCharValidator()
SurrogateCharValidator1.Actions.Add(New LineNotify())
TextBoxCell1.Validators.Add(SurrogateCharValidator1)

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

using GrapeCity.Win.MultiRow;

TextBoxCell textBoxCell1 = new TextBoxCell();
SurrogateCharValidator surrogateCharValidator1 = new SurrogateCharValidator();
surrogateCharValidator1.Actions.Add(new LineNotify());
textBoxCell1.Validators.Add(surrogateCharValidator1);

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