MaskedTextBox.Text プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーに現在表示されているテキストを取得または設定します。
public:
virtual property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public override string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set
Public Overrides Property Text As String
プロパティ値
コントロールによって現在表示されているテキストを含む String 。 既定値は空の文字列です。
- 属性
例
次のコード例では、 Text プロパティの使用方法を示します。
Private Sub DisplayText()
Me.MaskedTextBox1.PasswordChar = CChar("*")
Me.MaskedTextBox1.Mask = "000-00-0000" ' United States Social Security Number
Me.MaskedTextBox1.Text = "999999999"
Debug.WriteLine("MaskedControl.Text: " & Me.MaskedTextBox1.Text) ' Displays: 999-99-9
Me.MaskedTextBox1.Text = ""
' Assigning text.
Me.MaskedTextBox1.AllowPromptAsInput = True
Me.MaskedTextBox1.Text = "999-99-9999" ' Works
Me.MaskedTextBox1.Text = "999999999" ' Works
Me.MaskedTextBox1.AllowPromptAsInput = False
'Me.MaskedTextBox1.Text = "999-99-9999" ' Does not work
End Sub
注釈
Text は、 MaskedTextBox クラスの既定のバインド プロパティです。
このプロパティを使用して取得された文字列は、 Mask や TextMaskFormatなどのコントロールの書式設定プロパティに従って書式設定されます。
ResetOnPrompt、ResetOnSpace、およびSkipLiteralsの値に応じて、リテラル文字の有無に関係なく文字列をTextに割り当てることができます。
Text は、 MaskedTextBoxの既定のバインド プロパティです。
MaskedTextBox では、書式設定されたテキスト値が変更されるたびに、 TextChanged イベントが発生します。 プロパティが異なると、この値が変更される可能性があります。 たとえば、 PasswordChar プロパティを変更しても、 TextChanged イベントは発生しませんが、 Mask プロパティを変更すると発生します。