PowerTools InputMan for Windows Forms 8.0J
Format プロパティ (GcComboBox)
使用例 

入力可能な文字種を指定する書式を取得または設定します。
構文
Public Property Format As String
public string Format {get; set;}

プロパティ値

書式文字列を表すString値。

以下のキーワードを組み合わせた文字列を指定します。全角文字が指定された場合は全角文字が、半角文字が指定された場合は 半角文字がそれぞれ入力可能な文字種として指定されます。

全角 半角 説明
A 大文字のアルファベット(A〜Z)
a 小文字のアルファベット(a〜z)
K カタカナ(促音・拗音の小書き表記あり)
N カタカナ(促音・拗音の小書き表記なし)
9 数字(0〜9)
# 数字および数字関連記号(0〜9、+ - $ % \ , .)
@ 記号
B 2進数(0または1)
X 16進数(0〜9、A〜F、a-f)
S 空白文字
- ひらがな(促音・拗音の小書き表記あり)
- ひらがな(促音・拗音の小書き表記なし)
- すべての全角文字
- サロゲート ペア文字
- 2バイト文字(サロゲート ペア文字を除いた全角文字)
- JIS X 0208文字で構成された文字
- Shift JIS文字で構成された文字
- IVS(Ideographic Variation Sequence)文字
- H すべての半角文字
- ^ 指定した書式に含まれないすべての文字
- \ エスケープ・シーケンス

既定値はString.Emptyです。
解説

Format プロパティで設定した以外の文字種が入力されたときは、 InvalidInput イベントが発生します。

また、コントロールへの入力を制御するために、Format プロパティのほかに次のプロパティが用意されています。

Text プロパティに渡す文字列は、 Format プロパティで設定した入力マスクと正確に一致する必要があります。一致しない場合には、キーボードで入力した内容 またはコードで設定した内容は、Text プロパティに反映されません。 ただし、AutoConvert プロパティによって自動修正が可能な場合は 除きます。また、Format プロパティを変更すると、Text プロパティは自動的に空の文字列に設定されます。

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

 

 


© 2004-2015 GrapeCity inc. All rights reserved.