AutoConvert プロパティ (GcTextBox)

入力された文字をFormat プロパティに設定されてた入力マスクに従って自動的に変換するかどうかを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property AutoConvert As Boolean

public bool AutoConvert {get; set;}

プロパティ値

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

既定値はTrueです。

解説

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

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

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

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

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

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

使用例

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

C#
Visual Basic

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

public void InitializeTextBox()
{
    // Create an instance of a GcTextBox control.
    GcTextBox gcTextBox1 = new GcTextBox();

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

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

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

Public Sub InitializeTextBox()
    ' Create an instance of a GcTextBox control.
    Dim gcTextBox1 As New GcTextBox()

    ' Allow the GcTextBox control to accept only upper case alphabet(A-Z) and SBCS space.
    gcTextBox1.Format = "AS"
    ' The GcTextBox control will not try to convert invalid char to valid char automatically.
    gcTextBox1.AutoConvert = False

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

参照

GcTextBox クラス
 GcTextBox メンバ
 Format プロパティ