キーワードによる書式設定(GcMask型セル)

GcMask型セルでは、正規表現のキーワードを設定することで書式を設定することができます。フィールドオブジェクトによる書式設定のように柔軟なスタイル設定が不要な場合、1度のメソッド実行だけで書式を定義できるため、簡単な実装が可能です。

キーワードを使用して書式を設定するには、Fieldsプロパティが参照するMaskFieldCollectionInfoクラスのAddRangeメソッドのオーバーロードの１つを使用します。たとえば、郵便番号書式を設定するには、郵便番号を示す正規表現文字列は「\\D{3}-\\D{4}」（Visual Basicでは「\D{3}-\D{4}」）なので、AddRange メソッドのパラメータにこの文字列を設定します。

サンプルコード

以下のサンプルコードは、キーワードで書式を設定しています。

C#	コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType gmcell = new GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType(); // キーワードから書式を設定します。 gmcell.Fields.AddRange("\\D{3}-\\D{4}"); fpSpread1.ActiveSheet.Cells[0, 0].CellType = gmcell;

コードのコピー

GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType gmcell = new GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType();
// キーワードから書式を設定します。
gmcell.Fields.AddRange("\\D{3}-\\D{4}");
fpSpread1.ActiveSheet.Cells[0, 0].CellType = gmcell;

Visual Basic	コードのコピー
Dim gmcell = New GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType() ' キーワードから書式を設定します。 gmcell.Fields.AddRange("\D{3}-\D{4}") FpSpread1.ActiveSheet.Cells(0, 0).CellType = gmcell

Visual Basic

コードのコピー

Dim gmcell = New GrapeCity.Win.Spread.InputMan.CellType.GcMaskCellType()
' キーワードから書式を設定します。
gmcell.Fields.AddRange("\D{3}-\D{4}")
FpSpread1.ActiveSheet.Cells(0, 0).CellType = gmcell

なお、AddRange メソッドにより書式を設定する場合でも、自動的にフィールドオブジェクトに変換されているため、設定後に特定のフィールドスタイルを変更することは可能です。

次のサンプルコードは、キーワードにより設定した郵便番号書式の各フィールドのスタイルを設定する例です。

C#	コードのコピー
// キーワードから書式を設定します。 gmcell.Fields.AddRange("\\D{3}-\\D{4}"); gmcell.PaintByControl = true; // 各フィールドのスタイルを設定します。 gmcell.Fields[0].Font = new Font("メイリオ", 12); gmcell.Fields[1].ForeColor = Color.Gray; gmcell.Fields[2].Font = new Font("メイリオ", 9);

コードのコピー

// キーワードから書式を設定します。
gmcell.Fields.AddRange("\\D{3}-\\D{4}");
gmcell.PaintByControl = true;
// 各フィールドのスタイルを設定します。
gmcell.Fields[0].Font = new Font("メイリオ", 12);
gmcell.Fields[1].ForeColor = Color.Gray;
gmcell.Fields[2].Font = new Font("メイリオ", 9);

Visual Basic	コードのコピー
' キーワードから書式を設定します。 gmcell.Fields.AddRange("\D{3}-\D{4}") gmcell.PaintByControl = True ' 各フィールドのスタイルを設定します。 gmcell.Fields(0).Font = New Font("メイリオ", 12) gmcell.Fields(1).ForeColor = Color.Gray gmcell.Fields(2).Font = New Font("メイリオ", 9)

Visual Basic

コードのコピー

' キーワードから書式を設定します。
gmcell.Fields.AddRange("\D{3}-\D{4}")
gmcell.PaintByControl = True
' 各フィールドのスタイルを設定します。
gmcell.Fields(0).Font = New Font("メイリオ", 12)
gmcell.Fields(1).ForeColor = Color.Gray
gmcell.Fields(2).Font = New Font("メイリオ", 9)

キーワード一覧

Addrange メソッドで使用可能なキーワードは以下のとおりです

1. 主要なキーワード

半角	全角	説明
\A	\Ａ	大文字のアルファベットを表します。[A-Z]または[Ａ-Ｚ]と同等です。
\a	\ａ	小文字のアルファベットを表します。[a-z]または[ａ-ｚ]と同等です。
\D	\Ｄ	数字を表します。[0-9]または[０-９]と同等です。
\B	\Ｂ	2進数を表します。[0-1]または[０-１]と同等です。
\X	\Ｘ	16進数を表します。[0-9A-Fa-f]または[０-９Ａ-Ｆａ-ｆ]と同等です。
\W	\Ｗ	すべての英数字を表します。[a-zA-Z_0-9]または[ａ-ｚＡ-Ｚ＿０-９]と同等です。
\K	\Ｋ	カタカナ（促音・拗音の小書き表記あり）を表します。
\N	\Ｎ	カタカナ（促音・拗音の小書き表記なし）を表します。
\H	-	すべての半角文字を表します。
-	\Ｊ	ひらがな（促音・拗音の小書き表記あり）を表します。
-	\Ｇ	ひらがな（促音・拗音の小書き表記なし）を表します。
-	\Ｚ	すべての全角文字を表します。
-	\Ｔ	サロゲートペア文字を表します。
-	\Ｉ	JIS X 0208文字を表します。
-	\Ｍ	Shift JIS文字を表します。
-	\Ｖ	IVS(Ideographic Variation Sequence)文字を表します。

半角文字と全角文字は、その文字のShift-JISコードを使って識別されます。

2. 補助的なキーワード

メタ文字	説明
[]	[]内の文字のどれか１つにマッチすることを表します。
()	()内の文字列のどれか１つにマッチすることを表します。
\|	()内で使用し、文字列間の区切り文字として機能します。
{n}	直前のキーワードのn回の繰り返しを表します。
{n,}	直前のキーワードのn回以上の繰り返しを表します。
{n,m}	直前のキーワードのn回以上でm回以下の繰り返しを表します。
*	直前のキーワードの0回以上の繰り返しを表します。{0,}と同等です。
+	直前のキーワードの1回以上の繰り返しを表します。{1,}と同等です。
?	直前のキーワードの0回または1回の繰り返しを表します。{0,1}と同等です。
\（Chr(92)）	キーワードをリテラル文字として表示

以下にキーワードでの書式設定の例をあげます。

キーワード	表示例	説明
\Ｚ{0, 50}	あア漢１Ａａ	0文字以上、50文字以下のすべての全角を表します。
\D{3, 5}	1234	3文字以上、5文字以下のすべての半角数字を表します。
[1-3,a-c,A-C]{10}	1234	10文字の1,2,3,a,b,c,A,B,Cを表します。
[A-Z]{0, 65535}	ABCDE	半角大文字アルファベットを表します。\Aと同等です。
[H^a-z]{0, 65535}	12ABｱｲｳ	小文字のアルファベットを除くすべての半角文字を表します。
[^\T]{0, 65535}	あア漢１Ａａ	サロゲートぺア文字を除くすべての文字を表します。