バージョン

マスク

xamMaskedEditor™ と xamMaskedEditor コントロール ベースのエディター (たとえば、xamCurrencyEditor™、xamNumericEditor™、および xamDateTimeEditor™) は、Mask プロパティを公開しています。以下の表は、マスク構文がサポートするすべての可能なマスク文字とトークンをリストしています。

Note

注: これらのマスクのサブセットのみが特定のエディターに関連します。また、使用するマスクは、エディターの ValueType に依存します。

マスク文字 説明

#

数字のプレースホルダ。文字は数字 (0~9) である必要があり、入力は必須です。例: (###)-###-####。

.

小数のプレースホルダ。実際に使用される文字は、システムの国際設定によって小数のプレースホルダに指定されたものです。この文字はマスク用のリテラルとして扱われます。

,

千の位の区切り記号。実際に使用される文字は、システムの国際設定によって千の位の区切り文字に指定されたものです。この文字はマスク用のリテラルとして扱われます。

:

時刻の区切り文字。実際に使用される文字は、システムの国際設定によって時刻の区切り文字に指定されたものです。この文字はマスク用のリテラルとして扱われます。

/

日付の区切り文字。実際に使用される文字は、システムの国際設定によって日付の区切り文字に指定されたものです。この文字はマスク用のリテラルとして扱われます。

\

マスク文字列内の次の文字をリテラルとして扱います。これにより、マスクに '#'、'&'、'A'、'?' やその他の特別な意味を持つ文字を含めることができます。この文字はマスク用のリテラルとして扱われます。

&

文字のプレースホルダ。このプレースホルダに有効な値は、32 から 126 および 128 から 255 (キーボード入力文字および外国語の記号文字) の範囲の ANSI 文字です。

>

以降の文字をすべて大文字に変換します。

<

以降の文字をすべて小文字に変換します。

英数字のプレースホルダ。例:a-z、A-Z、0-9。文字の入力は必須です。

a

英数字のプレースホルダ。例:a-z、A-Z、0-9。文字の入力は必須ではありません。

9

数字のプレースホルダ。文字は数字 (0 から 9) である必要がありますが、入力は必須ではありません。

h

16 進の数字のプレースホルダ。文字は、16 進の数字でなければなりません (0-9 または a-f)。入力は必須です。A-F の桁は小文字に変換されます。

H

'h' のプレースホルダと同じですが、a-f の桁は大文字に変換されます。

-

マイナス記号の後に一連の 'n' によって数字セクションを定義した場合 (例:"-nn,nnn.nn") は、負の数を指定できることを示します。'n' が後に続かない場合はリテラルと見なされます。マイナス記号は数が実際に負の場合のみ表示されます。

+

プラス記号の後に一連の 'n' によって数字セクションを定義した場合 (例:"nn,nnn.nn") は、負の数を指定できることを示します。"-"との違いは、数が正か負かに基づいて常に '' または '-' 記号が表示されるという点です。

C

文字またはスペースのプレースホルダ。文字の入力は必須ではありません。これは「&」プレースホルダとまったく同様に機能し、Microsoft Access との互換性を確保します。

?

文字のプレースホルダ。例:a-z または A-Z を表します。文字の入力は必須ではありません。

n

数字のプレースホルダ。n のグループを使用して、数字が右から左に入力される数字セクションを作成できます。文字は数字 (0 から 9) である必要がありますが、入力は必須ではありません。

{char:n:s}

{char:n:s} マスクによって、受け入れられる任意の文字セットによってプレースホルダを定義できます。マスク内の 'n' は、マスク内の文字プレースホルダの数を指定します。's' は、受け入れ可能な文字のセットを指定します。

以下はこのマスクの例の一部です。

  • {char:1:abc} - このマスクは、'a'、'b' または 'c' の文字のみを受け入れる単一文字のプレースホルダを持ちます。

  • {char:4:abc} - 4 文字のプレースホルダが作成される点を除き上記と同じです。

  • {char:8:0-9a-f} - 0-9 および a-f 文字を許可する 8 文字のプレースホルダ (有効な 16 進数文字)。

mm, dd, yy

これら 3 つの特殊トークンを組み合わせて日付マスクを定義できます。mm は月、dd は日、yy は 2 桁形式の年、yyyy は 4 桁形式の年を表します。例: mm/dd/yyyy、yyyy/mm/dd、mm/yy。

hh, mm, ss, tt

これら 3 つの特殊トークンを組み合わせて時刻マスクを定義できます。hh は時、mm は分、ss は秒、tt は AM/PM を表します。例: hh:mm、hh:mm tt、hh:mm:ss。

{date:s}

{date} トークンは、短い日付形式を入力するためのプレースホルダです。日付マスクは、基になるカルチャ設定を使用して生成されます。

{time}

{time} トークンは、短い時刻形式を入力するためのプレースホルダです。短い時刻形式には通常、秒部分は含まれません。時刻マスクは、基になるカルチャ設定を使用して生成されます。

{longtime}

{longtime} トークンは、長い時刻形式を入力するためのプレースホルダです。長い時刻形式には通常、秒部分が含まれます。長い時刻マスクは、基になるカルチャ設定を使用して生成されます。

{double:-i.f:c}

{double:i.f:c} は、浮動小数点の入力を許可するマスクのプレースホルダです。i.f の i と f は、それぞれ整数部分の桁数と小数部分の桁数を指定します。マスクの :c 部分はオプションで、値の整数部分と小数部分を連続して入力することを指定します。たとえば、マスクに :c を指定した場合、12.34 と入力するためには、ユーザーは「1234」とキー入力します。小数点区切り文字を入力しない点に注意してください。このように設定すると、ユーザーは小数点区切り文字を入力する必要がなくなります。i.f の前の "-" (マイナス) 記号もオプションです。"-" 記号がある場合は、負の値を使用できることを示しています。"-" 記号が含まれていない場合には負の値以外の値しか使用できません。

{currency:-i.f:c}

元になる書式プロバイダーまたはカルチャーの現在の書式設定情報に基づいてマスクが構成される点以外は {double:i.f:c} と同じです。通常は通貨記号を含み、桁区切り文字も表示します。

{number:min-max}

{number:min-max} は、最小から最大までの範囲の値を受け入れることができる数字部分のためのプレースホルダです。例: {number:0-255}、{number:-10-10}.

リテラル

上記以外の記号はすべてリテラルとして (つまり、その記号自体として) 表示されます。

また、次の表にある記号が、基になるカルチャ設定の対応する記号にマップされることを示すために、{LOC} 文字シーケンスを使用してマスクをエスケープすることもできます。

マスク文字 説明

$

通貨記号。

/

日付の区切り文字。

:

時刻の区切り文字。

,

千の位の区切り記号。

.

小数点区切り文字。

+

正の記号。

-

負の記号。