3段階の境界線による通知

ThreeStateBorderNotify オブジェクトは、入力値が有効な場合、無効な場合および未入力の場合の３つのステータスに応じてコントロールの境界線によりエラーの内容を通知します。

未検証の状態	有効値が入力された状態	不正値が入力された状態

プロパティ

ThreeStateBorderNotify オブジェクトは、次のプロパティを使用して3段階の境界線による通知方法を設定します。

InvalidLineColor プロパティ
入力された値が不正なときに表示する境界線の色を取得または設定します。既定値はRed です。
InvalidLineStyle プロパティ
入力された値が不正なときに表示する境界線の種類を取得または設定します。既定値はLineDashStyle.Solid です。
InvalidLineWidth プロパティ
入力された値が不正なときに表示する境界線の太さを取得または設定します。設定できる範囲は1～3の間です。既定値は1 です。
ValidLineColor プロパティ
正しい値が入力されたときに表示する境界線の色を取得または設定します。
ValidLineStyle プロパティ
正しい値が入力されたときに表示する境界線の種類を取得または設定します。既定値はLineDashStyle.None です。
ValidLineWidth プロパティ
正しい値が入力されたときに表示する境界線の太さを取得または設定します。設定できる範囲は1～3の間です。既定値は1 です。

InvalidLineStyle およびValidLineStyle プロパティは、LineDashStyle 列挙型で以下の値を設定できます。

プロパティ値	説明
None	なし
Solid
Dashed
Doted
DashDot
DashDotDot

サンプルコード

次のサンプルコードは、汎用検証コンポーネントの検証アクションに3段階の境界線による通知を設定する例です。

Visual Basic
C#

Imports GrapeCity.Win.Editors

' アクション（境界線通知）を作成します。 
Dim ThreeStateBorderNotify1 As New ThreeStateBorderNotify()
' 入力された値が不正なときに表示する境界線を設定します。
ThreeStateBorderNotify1.InvalidLineColor = Color.Red
ThreeStateBorderNotify1.InvalidLineStyle = LineDashStyle.Dashed
ThreeStateBorderNotify1.InvalidLineWidth = 2
' 正しい値が入力されたときに表示する境界線を設定します。
ThreeStateBorderNotify1.ValidLineColor = Color.Green
ThreeStateBorderNotify1.ValidLineStyle = LineDashStyle.Solid
ThreeStateBorderNotify1.ValidLineWidth = 2

' TextBox1に作成した検証アクションを設定します。
GcCommonValidator1.GetValidateActions(TextBox1).AddRange(New ValidateAction() {ThreeStateBorderNotify1})

using GrapeCity.Win.Editors;

// アクション（境界線通知）を作成します。 
ThreeStateBorderNotify threeStateBorderNotify1 = new ThreeStateBorderNotify();
// 入力された値が不正なときに表示する境界線を設定します。
threeStateBorderNotify1.InvalidLineColor = Color.Red;
threeStateBorderNotify1.InvalidLineStyle = LineDashStyle.Dashed;
threeStateBorderNotify1.InvalidLineWidth = 2;
// 正しい値が入力されたときに表示する境界線を設定します。
threeStateBorderNotify1.ValidLineColor = Color.Green;
threeStateBorderNotify1.ValidLineStyle = LineDashStyle.Solid;
threeStateBorderNotify1.ValidLineWidth = 2;

// textBox1に作成した検証アクションを設定します。
gcCommonValidator1.GetValidateActions(textBox1).AddRange(new ValidateAction[] {threeStateBorderNotify1});

参照

検証コンポーネント

検証機能と設定方法

検証アクション