C1InputMask コントロールは、有効なユーザー入力と無効なユーザー入力を区別するマスクを使用します。マスクを定義するには、C1InputMask スマートタグまたは C1InputMask デザイナなどの視覚的なデザイナを使用するか、プログラムで C1InputMask オブジェクトを使用します。
よく使用される C1InputMaskタスクについては、「C1InputMask タスク」トピックを参照してください。
C1InputMask のマスクタイプ
下の表に、マスクのいくつかの例とその動作を示します。
| マスク | 動作 |
|---|---|
| 00/00/0000 | 国際的な日付書式の日付（日、数字月、年）。「/」文字は、論理日付区切り記号で、アプリケーションの現在のカルチャに適切な日付区切り記号としてユーザーに表示されます。日付パターンを指定する場合、日付や時刻を入力するための充実したインタフェースを提供する C1InputDate コントロールを使用できることに注意してください。 |
| 00->L<LL-0000 | 米国書式の日付（日、省略月名、および年）。大文字の語頭の後に小文字が続く３文字の省略月名を表示します。 |
| (999) 000-0000 | 米国電話番号、局番（オプション）。ユーザーがオプション文字を入力しないときは、スペースを入力するか、最初の０で示される位置にマウスポインタを直接入れることができます。 |
| $999,999.00 | ０〜999999 範囲の通貨値。通貨、桁区切り、および小数点の各文字は実行時に、カルチャ固有の等価に置換されます。 |
MaskFormat は、C1InputMask コントロールのデフォルトプロパティです。編集マスクを定義する場合、コントロール内の各文字位置は特殊プレースホルダまたはリテラル文字のいずれかにマップします。リテラル文字（リテラル）は、使用されているデータのタイプについて視覚的なキューを提供します。たとえば、電話番号の局番を囲むカッコとダッシュは、リテラルです。例：(412) 123-4567。マスクの編集機能により、無効な文字がコントロールに入力されないようにして、ユーザーインタフェースをさらに強化することができます。
C1InputMask 文字
マスク入力を有効にするには、MaskFormat プロパティを、１つまたは複数のプレースホルダとリテラルで構成されるマスク文字列に設定します。下の表に、使用可能なプレースホルダを示します。
| マスク要素 | 説明 |
|---|---|
| 0 | 数字（必須）。この要素は ０〜９の１桁の数字を受け付けます。 |
| 9 | 数字またはスペース（オプション） |
| # | 数字またはスペース（オプション）。マスク内でこの位置が空白のとき、Text プロパティではスペースとして表示されます。プラス（+）とマイナス（-）符号が許容されます。 |
| L | 文字（必須）。入力を ASCII 文字 a-z と A-Z に制限します。このマスク要素は、正規表現の [a-zA-Z] と等価です。 |
| ? | 文字（オプション）。入力を ASCII 文字 a-z と A-Z に制限します。このマスク要素は、正規表現の [a-zA-Z]? と等価です。 |
| & | 文字（必須） |
| C | 文字（オプション）。任意の非制御文字。 |
| A | 英数字（オプション） |
| . | 小数点プレースホルダ。使用される実際の表示文字は、Culture プロパティに適切な小数点プレースホルダとなります。 |
| , | ３桁プレースホルダ。使用される実際の表示文字は、Culture プロパティに適切な３桁プレースホルダとなります。 |
| : | 時刻区切り文字。使用される実際の表示文字は、Culture プロパティに適切な時刻プレースホルダとなります。 |
| / | 日付区切り文字。使用される実際の表示文字は、Culture プロパティに適切な日付プレースホルダとなります。 |
| $ | 通貨記号。使用される実際の表示文字は、Culture プロパティに適切な通貨記号となります。 |
| < | シフトダウン。後続のすべての文字を小文字に変換します。 |
| > | シフトアップ。後続のすべての文字を大文字に変換します。 |
| | | 直前のシフトアップまたはシフトダウンを無効にします。 |
| H | すべての半角文字 |
| K | 半角カタカナ |
| ９ | 全角の数字 |
| Ｋ | 全角カタカナ |
| Ｊ | ひらがな |
| Ｚ | すべての全角文字 |
| \ | エスケープ。マスク文字をエスケープして、リテラルに変えます。「\\」は、バックスラッシュのエスケープシーケンスです。 |
| その他のすべての文字 | リテラル。すべての非マスク要素は、C1InputMask 内にそのまま表示されます。リテラルは常に、実行時にマスク内の静的位置を占め、ユーザーによって移動または削除できません。 |
C1InputMask が前のマスクでフィルタされたユーザー入力をすでに含んでいる場合に、マスクを変更すると、C1InputMask はその入力を新しいマスク定義に移植しようとします。
MaskFormat プロパティを設定するには、以下の手順に従います。
- C1InputMask コントロールを選択し、そのスマートタグをクリックして、［C1InputMask タスク］メニューを開きます。
- ［マスク］プロパティの横の〈...〉ボタンをクリックします。［定型入力］ダイアログボックスが表示されます。
- データ書式を選択して、［マスク］テキストボックスにマスクを定義します。［プレビュー］テキストボックスにマスクのプレビューが表示されることに注意してください。
- 〈OK〉をクリックして、［定型入力］ダイアログボックスを閉じます。