AutoConvert プロパティ (GcCharMask)

入力された文字をフィールドの設定に従って自動的に変換するかどうかを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property AutoConvert As Boolean

public bool AutoConvert {get; set;}

プロパティ値

値	説明
True	文字を自動変換します。
False	文字の自動変換をしません。

既定値はTrueです。

解説

AutoConvert プロパティをTrueに設定すると、変換可能な文字はすべて入力マスクに従って自動的に変換されます。たとえば入力マスクが"A"に設定されていると、小文字を入力しても自動的に大文字に変換されます。また、全角文字だけが許可されている場合は、入力された半角文字は全角文字に変換されます。

以下にAutoConvert プロパティの設定によってコントロール内部で行われる自動変換の手順を示します。

小文字から大文字、または大文字から小文字への変換を行います。
手順１の変換が行われない場合、全角から半角、または半角から全角への変換を行います。
手順２の変換が行われない場合、全角大文字から半角小文字、全角小文字から半角大文字、半角大文字から全角小文字、半角小文字から全角大文字のいずれかの変換を行います。

半角カタカナ、全角カタカナ、およびひらがなは、次のように変換されます。

半角カタカナは全角カタカナに変換。変換できない場合はひらがなに変換。
全角カタカナは半角カタカナに変換。変換できない場合はひらがなに変換。
ひらがなは全角カタカナに変換。変換できない場合は半角カタカナに変換。

AutoConvert プロパティをFalseに設定すると、入力マスクの範囲外の文字が入力された場合は InvalidInput イベントが発生します。

使用例

書式を設定した 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 メンバ
 Format プロパティ