API version 1

- ‐

RW

string

mask

入力時の各桁毎の入力可能文字種を示します。


inputModeプロパティにINPUT_MASKを指定している場合のみ有効です。

subType プロパティが指定されている場合は、そちらが優先され、mask プロパティの設定は無視されます。

また、valueプロパティには、自動的な型変換が行われた結果の値が設定されます。 そのため、必ずしもmask プロパティに設定した入力形式が value プロパティに設定されるわけではありません。


初期値はUNSPECIFIEDです。システム規定値は空白文字列です。


以下のような入力文字種制御が可能です。

指定文字

入力可能文字

必須/任意

A

半角アルファベット(A~Z、a~z)

必須入力

a

半角アルファベット(A~Z、a~z)

省略可

N

半角英数(A~Z、a~z、0~9)

必須入力

n

半角英数(A~Z、a~z、0~9)

省略可

X、x

制限なし

省略可

9、D

半角数字(1~9)

必須入力

0、d

半角数字(1~9)

省略可

#

半角数字、符号(0~9、+、-)

省略可

H

半角16進数字(A~F、a~f、0~9)

必須入力

h

半角16進数字(A~F、a~f、0~9)

省略可

B

半角2進数字(0、1)

必須入力

b

半角2進数字(0、1)

省略可

>

以後の入力は半角英字を大文字に変換

<

以後の入力は半角英字を小文字に変換

!

大文字小文字変換を終了

\

続く文字をその文字自身とします

上記以外

指定文字そのものを固定表示します

末尾にセミコロンと1文字を入れた場合、未入力欄の表示文字の指定になります。未指定の場合はスペース表示となります。


設定例

mask設定値

動作

000.000.000.000;_

IPアドレス入力。空欄は _ で表示。

HH:HH:HH:HH:HH:HH;_

MACアドレス。空欄は _ で表示。

0000-00-00

年月日。空欄はスペースで表示。

>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#

ライセンス入力。入力した文字は大文字に変換されます。

関連項目

inputModeTextBox.format プロパティ


使用例 CRSダウンロード

Form SpreadStyleText_properties {
   x = 0;
   y = 0;
   width = 800;
   height = 600;

   Spread spread1 {
           x = 8;
           y = 8;
           width = 640;
           height = 440;
           maxColumns = 20;
           maxRows = 20;

           var s = new SpreadStyleText;

           #セルに入力可能な文字種をmaskで指定
           s.inputMode = SpreadStyleText.INPUT_MASK;

           #IPアドレス(空欄は_で表示)用maskを設定
           s.mask = "000.000.000.000;_";

           cell("A1").style = s;

   }
}