MaskedTextBox.MaskFull プロパティ

.NET Framework クラス ライブラリ リファレンス

MaskedTextBox.MaskFull プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

必須およびオプションの入力がすべて入力マスクに入力されたかどうかを示す値を取得します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public ReadOnly Property
 MaskFull As Boolean

Visual Basic (使用法)

Dim instance As MaskedTextBox
Dim value As Boolean

value = instance.MaskFull

C#

public bool MaskFull { get;
 }

C++

public:
property bool MaskFull {
    bool get ();
}

J#

/** @property */
public boolean get_MaskFull ()

JScript

public function get MaskFull
 () : boolean

プロパティ値
必須およびオプションの入力がすべて入力された場合は true。それ以外の場合は false。

解説

MaskInputRejected イベント ハンドラ内で MaskFull プロパティを使用すると、マスク内に残りの入力がないためユーザーの入力が拒否されたかどうかを確認できます。必須の入力要素だけが入力されたかどうかを確認するには、MaskCompleted プロパティを使用します。

使用例

MaskInputRejected イベントを処理し、ToolTip を使用して、マスク内のすべての位置が使用された後でデータの入力が試行された場合にユーザーに通知するコード例を次に示します。

Visual Basic

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

C#

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);
}

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MaskedTextBox クラス
MaskedTextBox メンバ
System.Windows.Forms 名前空間
MaskedTextBox.MaskCompleted プロパティ
MaskedTextBox.Mask プロパティ
Text
MaskChanged
MaskInputRejected