マスク型セル（MaskedTextBoxCell）は、.NET FrameworkのMaskedTextBoxコントロール（System.Windows.Forms.MaskedTextBox）と同等の機能を提供します。MaskedTextBoxCellを使用すると、ユーザーに書式付の入力を提供できます。
機能
MaskedTextBoxCellでは、基本セルの機能に加えて、次の機能を使用できます。
各機能の詳細はMaskedTextBoxCellクラスのリファレンスを参照してください。
- 書式付文字列の入力
- リテラル文字の表示
- パスワード文字の入力
各機能の詳細はMaskedTextBoxCellクラスのリファレンスを参照してください。
データ型
MaskedTextBoxCellはObject型の値を保持します。この型はMaskedTextBoxCell.ValueTypeプロパティで確認できます。入力と表示には、MaskedTextBoxCell.Maskプロパティの書式を元にString型に整形された値が使用されます。この型はMaskedTextBoxCell.FormattedValueTypeプロパティで確認できます。セルに値が読み出される場合の動作を変更するには、MaskedTextBoxCell.OnCellFormattingメソッドをオーバーライドします。セルから値が書き戻される場合の動作を変更するには、MaskedTextBoxCell.OnCellParsingメソッドをオーバーライドします。
セル編集コントロール
MaskedTextBoxCellの値はMaskedTextBoxEditingControlコントロールで編集できます。このコントロールはIEditingControlインタフェースとSystem.Windows.Forms.MaskedTextBoxクラスを継承しています。セル編集コントロールの型はMaskedTextBoxCell.EditTypeプロパティで確認できます。
スタイル
MaskedTextBoxCellはCellStyleクラスの次のメンバをサポートしています。セルのスタイルはMaskedTextBoxCell.Styleプロパティで設定します。
GDI+互換モードを有効にするには、MaskedTextBoxCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
| CellStyleメンバ | 非編集時 | 編集時 |
|---|---|---|
| BackColor | 有効 | 有効 |
| Border | 有効 | 有効 |
| DataSourceNullValue | 有効 | 有効 |
| DisabledBackColor | 有効 | - |
| DisabledForeColor | 有効 | - |
| Font | 有効 | 有効 |
| ForeColor | 有効 | 有効 |
| Format | 有効 | 有効 |
| FormatProvider | 有効 | 有効 |
| GradientColors | 有効 | - |
| GradientDirection | 有効 | - |
| GradientStyle | 有効 | - |
| Image | 有効 | - |
| ImageAlign | 有効 | - |
| ImeMode | 有効 | 有効 |
| ImeSentenceMode | 有効 | 有効 |
| InputScope | 有効 | 有効 |
| LineAdjustment | GDI+互換モードの場合のみ有効 | - |
| Margin | 有効 | 有効 |
| Multiline | 有効 | - |
| NullValue | 有効 | 有効 |
| Padding | 有効 | 有効 |
| PatternColor | 有効 | - |
| PatternStyle | 有効 | - |
| SelectionBackColor | 有効 | - |
| SelectionForeColor | 有効 | - |
| Tag | 有効 | 有効 |
| TextAdjustment | GDI+互換モードの場合のみ有効 | - |
| TextAlign | 有効 | 水平方向のみ有効 |
| TextAngle | GDI+互換モードの場合のみ有効 | - |
| TextEffect | 有効 | - |
| TextImageRelation | 有効 | - |
| TextIndent | 有効 | - |
| TextVertical | GDI+互換モードの場合のみ有効 | - |
| UseCompatibleTextRendering | 有効 | - |
| WordWrap | 有効 | - |
GDI+互換モードを有効にするには、MaskedTextBoxCell.Style.UseCompatibleTextRenderingプロパティをTrueに設定します。
ショートカットキー
次の表はMaskedTextBoxCellの編集時に処理されるキーとGcMultiRowコントロールで処理されるキーの一覧です。
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
| 修飾子 | キー | マスク型セル | GcMultiRow |
|---|---|---|---|
| なし | Keys.PageUp | - | 有効 |
| Keys.PageDown | - | 有効 | |
| Keys.End | 有効 | - | |
| Keys.Home | 有効 | - | |
| Keys.Left | 有効 | - | |
| Keys.Right | 有効 | - | |
| Keys.Up | 有効 | - | |
| Keys.Down | 有効 | - | |
| Keys.Insert | - | - | |
| Keys.Delete | 有効 | - | |
| Keys.BackSpace | 有効 | - | |
| Keys.Control | Keys.PageUp | - | - |
| Keys.PageDown | - | - | |
| Keys.End | - | 有効 | |
| Keys.Home | - | 有効 | |
| Keys.Left | 有効 | - | |
| Keys.Right | 有効 | - | |
| Keys.Up | - | 有効 | |
| Keys.Down | - | 有効 | |
| Keys.A | 有効 | - | |
| Keys.C | 有効 | - | |
| Keys.V | 有効 | - | |
| Keys.X | 有効 | - | |
| Keys.Shift | Keys.Left | 有効 | - |
| Keys.Right | 有効 | - | |
| Keys.Up | 有効 | - | |
| Keys.Down | 有効 | - | |
| Keys.Home | 有効 | - | |
| Keys.End | 有効 | - |
Keys.Control+Keys.Cは複数のセルが選択されている場合はGcMultiRowコントロールによって処理されます。
イベント
セルの内容領域のクリックに対応した処理を実装するには、GcMultiRow.CellContentClickイベントを使用します。ダブルクリックの場合はGcMultiRow.CellContentDoubleClickイベントです。
セルの値が変更されたときの処理を実装するには、GcMultiRow.CellEditedFormattedValueChangedイベントを使用します。
MaskedTextBoxCell を編集中のイベントに対応した処理は、MaskedTextBoxEditingControl クラスのイベントを使用します。
セルの値が変更されたときの処理を実装するには、GcMultiRow.CellEditedFormattedValueChangedイベントを使用します。
MaskedTextBoxCell を編集中のイベントに対応した処理は、MaskedTextBoxEditingControl クラスのイベントを使用します。
標準コントロールとの比較
次の表はMaskedTextBoxCellとSystem.Windows.Forms.MaskedTextBoxコントロールの主要なプロパティの比較です。
| MaskedTextBoxCell | MaskedTextBox |
|---|---|
| AllowPromptAsInput | AllowPromptAsInput |
| AsciiOnly | AsciiOnly |
| BeepOnError | BeepOnError |
| Culture | Culture |
| CutCopyMaskFormat | CutCopyMaskFormat |
| Style.FormatProvider | FormatProvider |
| DisplayTextMaskFormat | なし |
| なし | HidePromptOnLeave |
| InsertKeyMode | InsertKeyMode |
| なし | IsOverwriteMode |
| Mask | Mask |
| MaskCompleted | MaskCompleted |
| MaskedTextProvider | MaskedTextProvider |
| MaskFull | MaskFull |
| PasswordChar | PasswordChar |
| PromptChar | PromptChar |
| RejectInputOnFirstFailure | RejectInputOnFirstFailure |
| ResetOnPrompt | ResetOnPrompt |
| ResetOnSpace | ResetOnSpace |
| なし | SelectedText |
| SkipLiterals | SkipLiterals |
| DisplayText | Text |
| Style.TextAlign | TextAlign |
| なし | TextLength |
| TextMaskFormat | TextMaskFormat |
| UseSystemPasswordChar | UseSystemPasswordChar |
| なし | ValidatingType |