MaskedTextBox クラス
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _ <ComVisibleAttribute(True)> _ Public Class MaskedTextBox Inherits TextBoxBase
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] [ComVisibleAttribute(true)] public class MaskedTextBox : TextBoxBase
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] [ComVisibleAttribute(true)] public ref class MaskedTextBox : public TextBoxBase
解説MaskedTextBox クラスは、ユーザー入力を受け入れまたは拒否するための宣言構文をサポートする、拡張された TextBox コントロールです。Mask プロパティを使用すると、アプリケーションでカスタム検証ロジックを作成しなくても、次の入力を指定できます。
実行時に MaskedTextBox コントロールが表示される場合、マスクは一連のプロンプト文字およびオプションのリテラル文字として表されます。編集可能な各マスク位置は、必須またはオプションの入力を表し、単一のプロンプト文字を使用して表示されます。たとえば、シャープ記号 (#) は、数字入力のプレースホルダとしてよく使用されます。PromptChar プロパティを使用すると、カスタム プロンプト文字を指定できます。HidePromptOnLeave プロパティは、コントロールが入力フォーカスを失ったときにプロンプト文字が表示されるかどうかを決定します。
ユーザーがマスクされたテキスト ボックスに入力すると、有効な入力文字はそれぞれのプロンプト文字に順に置換されます。ユーザーが無効な文字を入力すると、置換は行われません。BeepOnError プロパティが true に設定されている場合、ビープ音が出され、MaskInputRejected イベントが発生します。このイベントを処理すると、独自のカスタム エラー ロジックを指定できます。
現在の挿入位置がリテラル文字の場合、複数のオプションを使用できます。
-
プロンプト文字以外の文字を入力すると、リテラルは自動的にスキップされ、入力文字は、次のプロンプト文字で表される次の編集可能な位置に自動的に適用されます。
-
AllowPromptAsInput プロパティが true の場合、プロンプト文字を入力すると、入力はプロンプト文字を上書きし、挿入位置はマスク内の次の位置に移動します。
MaskFull プロパティを使用すると、ユーザーが必須の入力をすべて入力したかどうかを検証できます。Text プロパティは、マスクおよび TextMaskFormat プロパティに従って書式設定されたユーザーの入力を常に取得します。
実際には、MaskedTextBox コントロールは、MaskedTextProvider プロパティで指定された System.ComponentModel.MaskedTextProvider クラスに対するすべてのマスク処理を遅延します。この標準のプロバイダは、サロゲートおよび垂直方向の組み合わせ文字を除くすべての Unicode 文字をサポートします。ただし、AsciiOnly プロパティを使用すると、入力を文字セット a ～ z、A ～ Z、および 0 ～ 9 に制限できます。
マスクは、ユーザーの入力が特定の型に対する有効な値を表すことを必ずしも保証していません。たとえば、年齢に対して -9 が入力されることがあります。その値の型のインスタンスを ValidatingType プロパティに割り当てると、ユーザーの入力が有効な値を表すかどうかを検証できます。TypeValidationCompleted イベントを監視すると、無効な値が含まれる場合にユーザーが MaskedTextBox からフォーカスを解除するかどうかを検出できます。型の検証が正常に行われると、TypeValidationEventArgs パラメータの ReturnValue プロパティを通じて値を表すオブジェクトを使用できます。
TextBox コントロールと同様、MaskedTextBox では、いくつかの一般的なショートカット キーが使用できません。たとえば、Ctrl + R (右揃え)、Ctrl + L (左揃え)、Ctrl + L (中央揃え) の各キーは使用できません。
Visual Basic 6.0 との互換性MaskedTextBox は、Visual Basic 6.0 のマスク エディット コントロール のほとんどの機能を保持するようにデザインされています。マスク エディット コントロールの一般的なプロパティと、MaskedTextBox での等価のプロパティの一覧を次の表に示します。
.gif)
使用例日付を受け入れるために MaskedTextBox を初期化し、MaskInputRejected イベントと TypeValidationCompleted イベントの両方を使用して、ユーザーに無効な入力であることを通知するコード例を次に示します。
Private Sub MaskedTextBox1_MaskInputRejected(ByVal sender As System.Object, ByVal e As System.Windows.Forms.MaskInputRejectedEventArgs) Handles MaskedTextBox1.MaskInputRejected If (Me.MaskedTextBox1.MaskFull) Then ToolTip1.ToolTipTitle = "Input Rejected - Too Much Data" ToolTip1.Show("You cannot enter any more data into the date field. Delete some characters in order to insert more data.", Me.MaskedTextBox1, Me.MaskedTextBox1.Location.X, Me.MaskedTextBox1.Location.Y, 5000) ElseIf (e.Position = Me.MaskedTextBox1.Mask.Length) Then ToolTip1.ToolTipTitle = "Input Rejected - End of Field" ToolTip1.Show("You cannot add extra characters to the end of this date field.", Me.MaskedTextBox1, Me.MaskedTextBox1.Location.X, Me.MaskedTextBox1.Location.Y, 5000) Else ToolTip1.ToolTipTitle = "Input Rejected" ToolTip1.Show("You can only add numeric characters (0-9) into this date field.", Me.MaskedTextBox1, Me.MaskedTextBox1.Location.X, Me.MaskedTextBox1.Location.Y, 5000) End If End Sub Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load Me.ToolTip1.IsBalloon = True Me.MaskedTextBox1.Mask = "00/00/0000" End Sub Private Sub MaskedTextBox1_KeyDown(ByVal sender As Object, ByVal e As KeyEventArgs) Handles MaskedTextBox1.KeyDown ' The balloon tip is visible for five seconds; if the user types any data before it disappears, collapse it ourselves. Me.ToolTip1.Hide(Me.MaskedTextBox1) End Sub
private void Form1_Load(object sender, EventArgs e) { maskedTextBox1.Mask = "00/00/0000"; maskedTextBox1.MaskInputRejected += new MaskInputRejectedEventHandler(maskedTextBox1_MaskInputRejected); maskedTextBox1.KeyDown += new KeyEventHandler(maskedTextBox1_KeyDown); } void maskedTextBox1_MaskInputRejected(object sender, MaskInputRejectedEventArgs e) { if (maskedTextBox1.MaskFull) { toolTip1.ToolTipTitle = "Input Rejected - Too Much Data"; toolTip1.Show("You cannot enter any more data into the date field. Delete some characters in order to insert more data.", maskedTextBox1, maskedTextBox1.Location.X, maskedTextBox1.Location.Y, 5000); } else if (e.Position == maskedTextBox1.Mask.Length) { toolTip1.ToolTipTitle = "Input Rejected - End of Field"; toolTip1.Show("You cannot add extra characters to the end of this date field.", maskedTextBox1, maskedTextBox1.Location.X, maskedTextBox1.Location.Y, 5000); } else { toolTip1.ToolTipTitle = "Input Rejected"; toolTip1.Show("You can only add numeric characters (0-9) into this date field.", maskedTextBox1, maskedTextBox1.Location.X, maskedTextBox1.Location.Y, 5000); } } void maskedTextBox1_KeyDown(object sender, KeyEventArgs e) { // The balloon tip is visible for five seconds; if the user types any data before it disappears, collapse it ourselves. toolTip1.Hide(maskedTextBox1); }
継承階層System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.TextBoxBase
System.Windows.Forms.MaskedTextBox
スレッド セーフプラットフォームWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。
バージョン情報参照- MaskedTextBox クラスのページへのリンク
