MESCIUS MultiRow for Windows Forms 12.0J
マスク型セル(MaskedTextBoxCell)


マスク型セル(MaskedTextBoxCell)は、.NET FrameworkのMaskedTextBoxコントロール(System.Windows.Forms.MaskedTextBox)と同等の機能を提供します。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プロパティで設定します。

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コントロールで処理されるキーの一覧です。

修飾子 キー マスク型セル 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 クラスのイベントを使用します。
標準コントロールとの比較
次の表は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
   
関連トピック

 

 


© MESCIUS inc. All rights reserved.