AutoConvert プロパティ (GcComboBox)

入力された文字を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 イベントが発生します。

使用例

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

C#
Visual Basic

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

public void InitializeGcComboBox()
{
    // Create an instance of a GcComboBox control.
    GcComboBox gcComboBox1 = new GcComboBox();

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

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

}

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

Public Sub InitializeGcComboBox()
    ' Create an instance of a GcComboBox control.
    Dim gcComboBox1 As New GcComboBox()

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

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

End Sub

参照

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