AutoConvert プロパティ (GcMask)

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

構文

Visual Basic (宣言)
C#

Public Property AutoConvert As Boolean

public bool AutoConvert {get; set;}

プロパティ値

文字を自動変換するにはTrue、それ以外はFalse。既定値はTrueです。

解説

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

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

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

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

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

参照

GcMask クラス
 GcMask メンバ