AllowSpace プロパティ (GcCharMask)

入力可能なスペースの種類を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property AllowSpace As AllowSpace

public AllowSpace AllowSpace {get; set;}

プロパティ値

入力可能なスペースの種類を指定するAllowSpace列挙体。既定値はBothです。

解説

AllowSpace プロパティは、テキストに入力可能なスペースの種類を指定する場合に使用します。

AllowSpaceがNoneモードの場合、このGcCharMaskにはスペースは入力できません。AllowSpace.Narrowは、SBCSスペースを入力できることを意味します。AllowSpace.Wideは、DBCSスペースを入力できることを意味します。AllowSpace.Bothは、すべての種類のスペースを入力できることを意味します。

AutoConvert プロパティがtrueで、AllowSpaceがAllowSpace.Wideの場合は、ユーザーがこのコントロールにSBCSスペースを入力したとき、SBCSスペースは自動的にDBCSスペースに変換されます。これは他の設定でも同じです。また、Format プロパティは常にこのAllowSpace プロパティと組み合わせて使用されます。

使用例

書式を設定した GcCharMask コントロールを作成するコード例を次に示します。この例では他に AllowSpace、 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 SBCS space only in the GcCharMask control.
    gcCharMask1.AllowSpace = AllowSpace.Narrow;
    //  Allow the  GcCharMask control to accept upper case alphabet(A-Z).
    gcCharMask1.Format = "A";
    //  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 SBCS space only in the GcCharMask control.
    gcCharMask1.AllowSpace = AllowSpace.Narrow
    '  Allow the  GcCharMask control to accept upper case alphabet(A-Z).
    gcCharMask1.Format = "A"
    '  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 メンバ
 AutoConvert プロパティ
 Format プロパティ