Format プロパティ (GcCharMask)

入力可能な文字種を指定する書式を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property Format As String

public string Format {get; set;}

プロパティ値

以下のキーワードを組み合わせた文字列を指定します。全角文字が指定された場合は全角文字が、半角文字が指定された場合は半角文字がそれぞれ入力可能な文字種として指定されます。

全角	半角	説明
Ａ	A	大文字のアルファベット（A～Z）
ａ	a	小文字のアルファベット（a～z）
Ｋ	K	カタカナ（促音・拗音の小書き表記あり）
Ｎ	N	カタカナ（促音・拗音の小書き表記なし）
９	9	数字（0～9）
＃	#	数字および数字関連記号（0～9、+ - $ % \ , .）
＠	@	記号
Ｂ	B	２進数（0または1）
Ｘ	X	16進数（0～9、A～F、a-f）
Ｓ	S	空白文字
Ｊ	-	ひらがな（促音・拗音の小書き表記あり）
Ｇ	-	ひらがな（促音・拗音の小書き表記なし）
Ｚ	-	すべての全角文字
Ｔ	-	サロゲートペア文字
Ｄ	-	2バイト文字(サロゲートペア文字を除いた全角文字)
Ｉ	-	JIS X 0208文字で構成された文字
Ｍ	-	Shift JIS文字で構成された文字
-	H	すべての半角文字
-	^	指定した書式に含まれないすべての文字
-	\	エスケープ・シーケンス

解説

書式を指定するには、キーワードとリテラルを使用してマスクを作成します。この入力マスクは、リテラルのみで構成することはできません。

使用例

書式を設定した GcCharMask コントロールを作成するコード例を次に示します。この例では他に AutoConvert そして Format プロパティを使用して、特定の文字の入力を許可する GcCharMask コントロールを作成しています。

C#
Visual Basic

//  Please use the following namespace
//  using System.Windows.Forms;
//  using GrapeCity.Win.Editors;

public void InitializeGcCharMask()
{
    // Create an instance of a GcCharMask control.
    GcCharMask gcCharMask1 = new GcCharMask();

    //  Allow the  GcCharMask control to accept upper case alphabet(A-Z) and  SBCS space.
    gcCharMask1.Format = "AS";
    //  The GcCharMask control will not auto-convert invalid char to valid char.
    gcCharMask1.AutoConvert = false;

    // Create an instance of a GcCharMask control.
    GcCharMask gcCharMask12 = new GcCharMask();
    // Accept upper and lower case alphabet, as well as the symbols. Except '#', '@' and '*' chars.
    gcCharMask12.Format = @"aA@^\#\@*";
    // The GcCharMask will try to convert the invalid char to valid char automatically.
    gcCharMask12.AutoConvert = true;
}

'  Please use the following namespace
'  Imports System.Windows.Forms;
'  Imports GrapeCity.Win.Editors;

Public Sub InitializeGcCharMask()
    ' Create an instance of a GcCharMask control.
    Dim gcCharMask1 As New GcCharMask()

    '  Allow the  GcCharMask control to accept upper case alphabet(A-Z) and SBCS space.
    gcCharMask1.Format = "AS"
    '  The GcCharMask control will not auto-convert invalid char to valid char.
    gcCharMask1.AutoConvert = False

    ' Create an instance of a GcCharMask control.
    Dim gcCharMask12 As New GcCharMask()
    ' Accept upper and lower case alphabet, as well as the symbols. Except '#', '@' and '*' chars.
    gcCharMask12.Format = "aA@^\#\@*"
    ' The GcCharMask will try to convert the invalid char to valid char automatically.
    gcCharMask12.AutoConvert = True
End Sub

参照

GcCharMask クラス
 GcCharMask メンバ
 InvalidInput イベント
 AutoConvert プロパティ