MaskedTextBox 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用遮罩區別適當及不適當的使用者輸入。
public ref class MaskedTextBox : System::Windows::Forms::TextBoxBase[System.ComponentModel.DefaultBindingProperty("Text")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class MaskedTextBox : System.Windows.Forms.TextBoxBase[System.ComponentModel.DefaultBindingProperty("Text")]
public class MaskedTextBox : System.Windows.Forms.TextBoxBase[<System.ComponentModel.DefaultBindingProperty("Text")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type MaskedTextBox = class
inherit TextBoxBase[<System.ComponentModel.DefaultBindingProperty("Text")>]
type MaskedTextBox = class
inherit TextBoxBasePublic Class MaskedTextBox
Inherits TextBoxBase- 繼承
- 屬性
範例
下列程式碼範例會 MaskedTextBox 初始化 以接受日期，並使用 MaskInputRejected 和 TypeValidationCompleted 事件來警示使用者輸入無效。
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, 0, -20, 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, 0, -20, 5000);
}
else
{
toolTip1.ToolTipTitle = "Input Rejected";
toolTip1.Show("You can only add numeric characters (0-9) into this date field.", maskedTextBox1, 0, -20, 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);
}
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, 0, -20, 5000)
Else
ToolTip1.ToolTipTitle = "Input Rejected"
ToolTip1.Show("You can only add numeric characters (0-9) into this date field.", Me.MaskedTextBox1, 0, -20, 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
備註
類別 MaskedTextBox 是增強 TextBox 型控制項，可支援宣告式語法來接受或拒絕使用者輸入。 Mask您可以使用 屬性來指定下列輸入，而不需在應用程式中撰寫任何自訂驗證邏輯：
必要的輸入字元。
選擇性輸入字元。
遮罩中指定位置預期的輸入類型;例如，數位或字母或英數位元。
遮罩應該直接出現在 MaskedTextBox 中的字元;例如，電話號碼中的連字號 () ，或價格中的貨幣符號。
輸入字元的特殊處理;例如，將字母字元轉換成大寫。
MaskedTextBox當控制項在執行時間顯示時，它會以一系列的提示字元和選擇性常值字元來表示遮罩。 每個可編輯的遮罩位置，代表必要或選擇性的輸入，都會以單一提示字元顯示。 例如，數位記號 (#) 通常用於數值字元輸入的預留位置。 您可以使用 PromptChar 屬性來指定自訂提示字元。 屬性 HidePromptOnLeave 會決定當使用者失去輸入焦點時，是否看到提示字元。
當使用者在遮罩文字方塊中輸入輸入時，有效的輸入字元會以循序方式取代其各自的提示字元。 如果使用者輸入不正確輸入字元，則不會發生取代，但如果 屬性設定 true 為 ，則會發出 BeepOnError beep，並 MaskInputRejected 引發 事件。 您可以藉由處理此事件來提供自己的自訂錯誤邏輯。
當目前的插入點位於常值字元時，使用者有一些選項：
如果輸入提示字元以外的字元，則會自動略過常值，並將輸入字元套用至下一個可編輯的位置，由下一個提示字元表示。
如果輸入提示字元且 AllowPromptAsInput 屬性為 true，則輸入會過度輸入提示字元，並將插入點移至遮罩中的下一個位置。
一如往常，方向鍵可用來巡覽至先前或後續的位置。
您可以使用 MaskFull 屬性來確認使用者是否已輸入所有必要的輸入。 屬性 Text 一律會根據遮罩和 TextMaskFormat 屬性來擷取使用者輸入的格式。
控制項 MaskedTextBox 實際上會將所有遮罩處理延遲至 System.ComponentModel.MaskedTextProvider 屬性所 MaskedTextProvider 指定的類別。 此標準提供者支援 Surrogate 和垂直合併字元以外的所有 Unicode 字元;不過， AsciiOnly 屬性可用來限制字元的輸入設定 a-z、A-Z 和 0-9。
遮罩不一定保證使用者的輸入將代表指定類型的有效值;例如，-9 可以輸入年份的年齡。 您可以藉由將該數值型別的實例指派給 ValidatingType 屬性，以確認使用者的輸入是否代表有效的值。 您可以藉由監視 TypeValidationCompleted 事件，來偵測使用者是否從中包含無效值時移除焦點 MaskedTextBox 。 如果類型驗證成功，表示值的 物件將可透過 ReturnValue 參數的 TypeValidationEventArgs 屬性取得。
和 控制項一 TextBox 樣，數個常見的鍵盤快速鍵無法搭配 使用 MaskedTextBox 。 特別是，CTRL-R (右對齊文字) 、CTRL-L (靠左對齊文字) ，而 CTRL-L (置中文字) 沒有作用。
與 Visual Basic 6.0 的相容性
MaskedTextBox 是設計來保留 Visual Basic 6.0 中遮罩編輯控制項的大部分功能。 下表列出遮罩編輯控制項上的一般屬性，並在 上 MaskedTextBox 提供其對等專案。
| 遮罩編輯控制項 (Visual Basic 6.0) 屬性 | 對等 MaskedTextBox (.NET Framework) 屬性 |
|---|---|
AllowPrompt 屬性 |
AllowPromptAsInput |
AutoTab 屬性 |
None |
ClipMode 屬性 |
CutCopyMaskFormat |
ClipText 屬性 |
Text當 設定為 ExcludePromptAndLiterals) 時 TextMaskFormat ( |
Format 屬性 |
None |
FormattedText 屬性 |
Text當 設定為 IncludePromptAndLiterals) 時 TextMaskFormat ( |
Mask 屬性 |
Mask |
PromptChar 屬性 |
PromptChar |
PromptInclude 屬性 |
ResetOnPrompt |
ValidationError 事件 |
MaskInputRejected |
警告
控制項 MaskedTextBox 不支援多行設定或復原功能。 不過，雖然已保留與這些功能相關聯的成員，以便與 TextBoxBase 基類相容，但其實作不會執行任何動作。
建構函式
| MaskedTextBox() |
使用預設值初始化 MaskedTextBox 類別的新執行個體。 |
| MaskedTextBox(MaskedTextProvider) |
使用指定的自訂遮罩語言提供者，初始化 MaskedTextBox 類別的新執行個體。 |
| MaskedTextBox(String) |
使用指定的輸入遮罩，初始化 MaskedTextBox 類別的新執行個體。 |
屬性
| AcceptsTab |
取得或設定值，判斷要如何針對多行組態處理 Tab 鍵。 MaskedTextBox 不支援這個屬性。 |
| AccessibilityObject |
取得指定給控制項的 AccessibleObject。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定協助用戶端應用程式所使用的控制項的預設動作描述。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定協助工具用戶端應用程式使用之控制項的描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定協助工具用戶端應用程式使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制項的可存取角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定值，指出控制項是否能接受使用者拖放上來的資料。 (繼承來源 Control) |
| AllowPromptAsInput |
取得或設定值，指出使用者是否可以輸入 PromptChar 做為有效資料。 |
| Anchor |
取得或設定控制項繫結至的容器邊緣，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| AsciiOnly |
取得或設定值，指出 MaskedTextBox 控制項是否接受 ASCII 字元集之外的字元。 |
| AutoScrollOffset |
取得或設定此控制項在 ScrollControlIntoView(Control) 中要捲動到哪一個位置。 (繼承來源 Control) |
| AutoSize |
取得或設定值，指出當指定給控制項的字型變更時，控制項的高度是否要自動調整。 (繼承來源 TextBoxBase) |
| BackColor |
取得或設定控制項的背景色彩。 (繼承來源 TextBoxBase) |
| BackgroundImage |
這個屬性與這個類別無關。 (繼承來源 TextBoxBase) |
| BackgroundImageLayout |
這個屬性與這個類別無關。 (繼承來源 TextBoxBase) |
| BeepOnError |
取得或設定值，指出遮罩文字方塊控制項是否會針對其所拒絕的每一個使用者按鍵輸入發出系統嗶聲。 |
| BindingContext |
取得或設定控制項的 BindingContext。 (繼承來源 Control) |
| BorderStyle |
取得或設定文字方塊控制項的框線樣式。 (繼承來源 TextBoxBase) |
| Bottom |
取得控制項下邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Bounds |
取得或設定控制項 (包括其非工作區項目) 相對於父控制項之大小和位置 (單位為像素)。 (繼承來源 Control) |
| CanEnableIme |
取得值，這個值表示 ImeMode 屬性是否可以設定為使用中的值，以啟用 IME 支援。 (繼承來源 TextBoxBase) |
| CanFocus |
取得指示控制項是否能取得焦點的值。 (繼承來源 Control) |
| CanRaiseEvents |
判斷是否可以在控制項上引發事件。 (繼承來源 Control) |
| CanSelect |
取得指示能否選取控制項的值。 (繼承來源 Control) |
| CanUndo |
取得值，指出使用者是否能復原先前的作業。 MaskedTextBox 不支援這個屬性。 |
| Capture |
取得或設定值，指出控制項是否捕捉住滑鼠。 (繼承來源 Control) |
| CausesValidation |
取得或設定值，指出控制項取得焦點時，是否會在任何需要驗證的控制項上執行驗證。 (繼承來源 Control) |
| ClientRectangle |
取得表示控制項工作區的矩形。 (繼承來源 Control) |
| ClientSize |
取得或設定控制項工作區的高度和寬度。 (繼承來源 Control) |
| CompanyName |
取得包含控制項之應用程式的公司名稱或建立者。 (繼承來源 Control) |
| Container |
取得包含 IContainer 的 Component。 (繼承來源 Component) |
| ContainsFocus |
取得指示控制項 (或其子控制項之一) 目前是否擁有輸入焦點的值。 (繼承來源 Control) |
| ContextMenu |
取得或設定與控制項關聯的捷徑功能表。 (繼承來源 Control) |
| ContextMenuStrip |
取得或設定與這個控制項相關的 ContextMenuStrip。 (繼承來源 Control) |
| Controls |
取得控制項中包含的控制項集合。 (繼承來源 Control) |
| Created |
取得值，指出是否已經建立控制項。 (繼承來源 Control) |
| CreateParams |
建立控制代碼時，取得必要的建立參數。 |
| Culture |
取得或設定與遮罩文字方塊有關的文化特性資訊。 |
| Cursor |
取得或設定滑鼠指標移至控制項上時顯示的游標。 (繼承來源 Control) |
| CutCopyMaskFormat |
取得或設定值，這個值可判斷是否會將常值和提示字元複製到剪貼簿中。 |
| DataBindings |
取得控制項的資料繫結 (Data Binding)。 (繼承來源 Control) |
| DataContext |
取得或設定資料系結用途的資料內容。 這是環境屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制項的預設游標。 (繼承來源 TextBoxBase) |
| DefaultImeMode |
取得控制項支援的預設輸入法 (IME) 模式。 (繼承來源 Control) |
| DefaultMargin |
取得控制項之間的預設指定間距 (單位為像素)。 (繼承來源 Control) |
| DefaultMaximumSize |
取得指定為控制項的預設大小之最大值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultMinimumSize |
取得指定為控制項的預設大小之最小值的長度和高度 (單位為像素)。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的內部間距 (單位為像素)。 (繼承來源 Control) |
| DefaultSize |
取得控制項的預設大小。 (繼承來源 TextBoxBase) |
| DesignMode |
取得值，指出 Component 目前是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項的顯示裝置的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得表示控制項顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
取得值，指出基底 Control 類別是否正在處置的過程中。 (繼承來源 Control) |
| Dock |
取得或設定停駐在其父控制項的控制項框線，並決定控制項隨其父代重新調整大小的方式。 (繼承來源 Control) |
| DoubleBuffered |
取得或設定值，指出控制項繪製是否在顯示該控制項之前於緩衝區內完成。 這個屬性與這個類別無關。 (繼承來源 TextBoxBase) |
| Enabled |
取得或設定值，指出控制項是否可回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加在這個 Component 上的事件處理常式清單。 (繼承來源 Component) |
| Focused |
取得指示控制項是否擁有輸入焦點的值。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示之文字字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制項字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制項的前景色彩。 (繼承來源 TextBoxBase) |
| FormatProvider |
取得或設定當執行型別驗證時所用的 IFormatProvider。 |
| Handle |
取得控制項要繫結的目標視窗控制代碼。 (繼承來源 Control) |
| HasChildren |
取得指示控制項是否包含一或多個子控制項的值。 (繼承來源 Control) |
| Height |
取得或設定控制項的高度。 (繼承來源 Control) |
| HidePromptOnLeave |
取得或設定值，指出當遮罩文字方塊失去焦點時，是否會隱藏輸入遮罩中的提示字元。 |
| HideSelection |
取得或設定值，指出當控制項遺失駐點時，這個值會表示文字方塊控制項中選取的文字是否還是會以反白顯示。 (繼承來源 TextBoxBase) |
| ImeMode |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制項的輸入法 (IME) 模式。 (繼承來源 TextBoxBase) |
| InsertKeyMode |
取得或設定遮罩文字方塊控制項的文字插入模式。 |
| InvokeRequired |
取得一個值。這個值會指示是否由於呼叫端是在建立控制項之執行緒以外的執行緒，因此在進行控制項的方法呼叫時，應呼叫叫用 (Invoke) 方法。 (繼承來源 Control) |
| IsAccessible |
取得或設定值，指出可及性應用程式是否見得到控制項。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
指出這個控制項的其中一個上階是否已月臺，以及該月臺在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
取得指示控制項是否已經處置的值。 (繼承來源 Control) |
| IsHandleCreated |
取得指示控制項是否有相關控制代碼的值。 (繼承來源 Control) |
| IsMirrored |
取得值，指出是否左右反轉控制項。 (繼承來源 Control) |
| IsOverwriteMode |
取得值，指出新的使用者輸入是否會覆寫現有的輸入。 |
| LayoutEngine |
取得控制項之配置引擎的快取執行個體。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| Lines |
取得或設定多行組態中的文字行。 MaskedTextBox 不支援這個屬性。 |
| Location |
取得或設定對應至控制項容器左上角之控制項左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制項之間的空格。 (繼承來源 Control) |
| Mask |
取得或設定執行階段所要使用的輸入遮罩。 |
| MaskCompleted |
取得值，指出所有必要的輸入是否已經輸入到輸入遮罩中。 |
| MaskedTextProvider |
取得與遮罩文字方塊控制項的這個執行個體有關的遮罩提供者的複製品。 |
| MaskFull |
取得值，指出所有必要和選擇性的輸入是否已經輸入到輸入遮罩中。 |
| MaximumSize |
取得或設定 GetPreferredSize(Size) 可以指定的上限大小。 (繼承來源 Control) |
| MaxLength |
取得或設定使用者能夠輸入或貼入文字方塊控制項中的最大字元數。 MaskedTextBox 不支援這個屬性。 |
| MinimumSize |
取得或設定 GetPreferredSize(Size) 可以指定的下限大小。 (繼承來源 Control) |
| Modified |
取得或設定值，指出在建立控制項或者上次設定其內容後，文字方塊控制項被使用者修改過。 (繼承來源 TextBoxBase) |
| Multiline |
取得或設定值，指出這是否為多行文字方塊控制項。 MaskedTextBox 不完全支援這個屬性。 |
| Name |
取得或設定控制項的名稱。 (繼承來源 Control) |
| Padding |
這個屬性與這個類別無關。 (繼承來源 TextBoxBase) |
| Parent |
取得或設定控制項的父容器。 (繼承來源 Control) |
| PasswordChar |
取得或設定要顯示來代替使用者輸入的字元。 |
| PreferredHeight |
取得文字方塊的慣用高度。 (繼承來源 TextBoxBase) |
| PreferredSize |
取得能夠容納控制項的矩形區域的大小。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件的產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組件的版本。 (繼承來源 Control) |
| PromptChar |
取得或設定用來表示 MaskedTextBox 中沒有使用者輸入的字元。 |
| ReadOnly |
取得或設定值，指出文字方塊中的文字是否為唯讀。 |
| RecreatingHandle |
取得指示控制項目前是否正重新建立其控制代碼的值。 (繼承來源 Control) |
| Region |
取得或設定與控制項關聯的視窗區域。 (繼承來源 Control) |
| RejectInputOnFirstFailure |
取得或設定值，指出到達第一個無效字元後，使用者輸入的剖析動作是否應該停止。 |
| RenderRightToLeft |
已淘汰.
已淘汰.
此屬性現在已過時。 (繼承來源 Control) |
| ResetOnPrompt |
取得或設定值，判斷應如何處理符合提示字元的輸入字元。 |
| ResetOnSpace |
取得或設定值，判斷應如何處理空格輸入字元。 |
| ResizeRedraw |
取得或設定值，指出控制項重設大小時，是否會重繪本身。 (繼承來源 Control) |
| Right |
取得控制項右邊緣和其容器工作區 (Client Area) 左邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定值，指出控制項的項目是否對齊，以支援使用由右至左字型的地區設定。 (繼承來源 Control) |
| ScaleChildren |
取得值，以判斷子控制項的縮放。 (繼承來源 Control) |
| SelectedText |
取得或設定 MaskedTextBox 控制項中的目前選取項目。 |
| SelectionLength |
取得或設定文字方塊中所選取的字元數。 (繼承來源 TextBoxBase) |
| SelectionStart |
取得或設定文字方塊中選取文字的起點。 (繼承來源 TextBoxBase) |
| ShortcutsEnabled |
取得或設定值，指出是否啟用定義的快速鍵。 (繼承來源 TextBoxBase) |
| ShowFocusCues |
取得指示控制項是否應顯示焦點矩形 (Focus Rectangle) 的值。 (繼承來源 Control) |
| ShowKeyboardCues |
取得值，指出使用者介面是否處於可顯示或隱藏鍵盤快速鍵的適當狀態下。 (繼承來源 Control) |
| Site |
取得或設定控制項的站台。 (繼承來源 Control) |
| Size |
取得或設定控制項的高度和寬度。 (繼承來源 Control) |
| SkipLiterals |
取得或設定值，指出是否允許使用者重新輸入常值。 |
| TabIndex |
取得或設定控制項容器中的控制項定位順序。 (繼承來源 Control) |
| TabStop |
取得或設定值，指出使用者是否能使用 TAB 鍵，將焦點 (Focus) 給予這個控制項。 (繼承來源 Control) |
| Tag |
取得或設定物件，其包含控制項相關資料。 (繼承來源 Control) |
| Text |
取得或設定目前顯示給使用者的文字。 |
| TextAlign |
取得或設定文字在遮罩文字方塊控制項中的對齊方式。 |
| TextLength |
取得顯示文字的長度。 |
| TextMaskFormat |
取得或設定值，這個值可判斷是否會將常值和提示字元包含在格式化的字串中。 |
| Top |
取得或設定控制項上邊緣和其容器工作區 (Client Area) 上邊緣之間的距離 (單位為像素)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Form 父控制項的父控制項。 通常，這會是內含控制項最外層的 Form。 (繼承來源 Control) |
| UseSystemPasswordChar |
取得或設定值，指出是否應該使用作業系統提供的密碼字元。 |
| UseWaitCursor |
取得或設定值，指出是否將等待游標用於目前控制項和所有子控制項。 (繼承來源 Control) |
| ValidatingType |
取得或設定用來驗證使用者的資料輸入之資料型別。 |
| Visible |
取得或設定值，這個值指出是否顯示控制項及其所有子控制項。 (繼承來源 Control) |
| Width |
取得或設定控制項的寬度。 (繼承來源 Control) |
| WindowTarget |
這個屬性與這個類別無關。 (繼承來源 Control) |
| WordWrap |
取得或設定值，指出多行文字方塊控制項是否會在必要時自動將文字換行到下一行的開頭。 MaskedTextBox 不支援這個屬性。 |
方法
事件
| AcceptsTabChanged |
發生於 AcceptsTab 屬性的值已變更時。 MaskedTextBox 不會引發這個事件。 |
| AutoSizeChanged |
這個事件與這個類別無關。 (繼承來源 TextBoxBase) |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 這個事件與這個類別無關。 (繼承來源 TextBoxBase) |
| BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性的值變更時。 這個事件與這個類別無關。 (繼承來源 TextBoxBase) |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| BorderStyleChanged |
發生於 BorderStyle 屬性的值已變更時。 (繼承來源 TextBoxBase) |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
發生於焦點或鍵盤使用者介面 (UI) 提示變更時。 (繼承來源 Control) |
| Click |
發生於按一下文字方塊時。 (繼承來源 TextBoxBase) |
| ClientSizeChanged |
發生於 ClientSize 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuChanged |
發生於 ContextMenu 屬性的值變更時。 (繼承來源 Control) |
| ContextMenuStripChanged |
發生於 ContextMenuStrip 屬性的值變更時。 (繼承來源 Control) |
| ControlAdded |
發生於加入新控制項至 Control.ControlCollection 時。 (繼承來源 Control) |
| ControlRemoved |
發生於從 Control.ControlCollection 移除控制項時。 (繼承來源 Control) |
| CursorChanged |
發生於 Cursor 屬性的值變更時。 (繼承來源 Control) |
| DataContextChanged |
發生於 DataContext 屬性的值變更時。 (繼承來源 Control) |
| Disposed |
當 Dispose() 方法的呼叫處置元件時，就會發生。 (繼承來源 Component) |
| DockChanged |
發生於 Dock 屬性的值變更時。 (繼承來源 Control) |
| DoubleClick |
發生於按兩下控制項時。 (繼承來源 Control) |
| DpiChangedAfterParent |
發生於某個控制項的父控制項或表單已變更之後，以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
| DpiChangedBeforeParent |
發生於某個控制項的父控制項或表單發生 DPI 變更事件之前，以程式設計方式變更其 DPI 設定時。 (繼承來源 Control) |
| DragDrop |
發生於拖放作業完成時。 (繼承來源 Control) |
| DragEnter |
發生於將物件拖曳至控制項邊框時。 (繼承來源 Control) |
| DragLeave |
發生於將物件拖出控制項界限時。 (繼承來源 Control) |
| DragOver |
發生於將物件拖曳至控制項邊框上方時。 (繼承來源 Control) |
| EnabledChanged |
發生於 Enabled 屬性值變更時。 (繼承來源 Control) |
| Enter |
發生於輸入控制項時。 (繼承來源 Control) |
| FontChanged |
發生在 Font 屬性值變更時。 (繼承來源 Control) |
| ForeColorChanged |
發生在 ForeColor 屬性值變更時。 (繼承來源 Control) |
| GiveFeedback |
發生於拖曳作業時。 (繼承來源 Control) |
| GotFocus |
發生於控制項取得焦點時。 (繼承來源 Control) |
| HandleCreated |
發生於為控制項建立控制代碼時。 (繼承來源 Control) |
| HandleDestroyed |
發生於終結控制項的控制代碼時。 (繼承來源 Control) |
| HelpRequested |
發生於使用者要求控制項的說明時。 (繼承來源 Control) |
| HideSelectionChanged |
發生於 HideSelection 屬性的值已變更時。 (繼承來源 TextBoxBase) |
| ImeModeChanged |
發生於 ImeMode 屬性變更時。 (繼承來源 Control) |
| Invalidated |
發生於控制項的顯示需要重新繪製時。 (繼承來源 Control) |
| IsOverwriteModeChanged |
發生在插入模式已變更之後。 |
| KeyDown |
發生於按下按鍵且焦點在控制項時。 (繼承來源 Control) |
| KeyPress |
發生於 控制項有焦點，並按下字元空格鍵或退格鍵時。 (繼承來源 Control) |
| KeyUp |
發生於放開按鍵且焦點在控制項時。 (繼承來源 Control) |
| Layout |
發生於控制項應重新調整其子控制項位置時。 (繼承來源 Control) |
| Leave |
發生於輸入焦點離開控制項時。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
發生於控制項遺失焦點時。 (繼承來源 Control) |
| MarginChanged |
發生於控制項的邊界變更時。 (繼承來源 Control) |
| MaskChanged |
發生在輸入遮罩已變更後。 |
| MaskInputRejected |
發生於使用者的輸入或指派的字元不符合輸入遮罩的對應格式項目時。 |
| ModifiedChanged |
發生於 Modified 屬性的值已變更時。 (繼承來源 TextBoxBase) |
| MouseCaptureChanged |
發生於控制項遺失滑鼠捕捉時。 (繼承來源 Control) |
| MouseClick |
發生於使用滑鼠按一下控制項時。 (繼承來源 TextBoxBase) |
| MouseDoubleClick |
發生於以滑鼠按兩下控制項時。 (繼承來源 Control) |
| MouseDown |
發生於滑鼠指標位於控制項上並按下滑鼠按鍵時。 (繼承來源 Control) |
| MouseEnter |
發生於滑鼠指標進入控制項時。 (繼承來源 Control) |
| MouseHover |
發生於滑鼠指標停留在控制項上時。 (繼承來源 Control) |
| MouseLeave |
發生於滑鼠指標離開控制項時。 (繼承來源 Control) |
| MouseMove |
發生於滑鼠指標移至控制項上時。 (繼承來源 Control) |
| MouseUp |
發生於滑鼠指標位於控制項上並放開滑鼠按鍵時。 (繼承來源 Control) |
| MouseWheel |
發生於滑鼠滾輪移動且焦點在控制項時。 (繼承來源 Control) |
| Move |
發生於控制項移動時。 (繼承來源 Control) |
| MultilineChanged |
這個事件通常發生於 Multiline 屬性已變更時，但它不是由 MaskedTextBox 引發的。 |
| PaddingChanged |
這個事件與這個類別無關。 (繼承來源 TextBoxBase) |
| Paint |
發生於重繪控制項時。 這個事件與這個類別無關。 (繼承來源 TextBoxBase) |
| ParentChanged |
發生在 Parent 屬性值變更時。 (繼承來源 Control) |
| PreviewKeyDown |
發生於焦點位於這個控制項上時並按下鍵盤按鍵的 KeyDown 事件之前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
發生於 AccessibleObject 為協助工具應用程式提供說明時。 (繼承來源 Control) |
| QueryContinueDrag |
發生於拖放作業時，讓拖曳來源能夠決定是否應取消拖放作業。 (繼承來源 Control) |
| ReadOnlyChanged |
發生於 ReadOnly 屬性的值已變更時。 (繼承來源 TextBoxBase) |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
發生於重設控制項大小時。 (繼承來源 Control) |
| RightToLeftChanged |
發生在 RightToLeft 屬性值變更時。 (繼承來源 Control) |
| SizeChanged |
發生在 Size 屬性值變更時。 (繼承來源 Control) |
| StyleChanged |
發生於控制項樣式變更時。 (繼承來源 Control) |
| SystemColorsChanged |
發生於系統色彩變更時。 (繼承來源 Control) |
| TabIndexChanged |
發生在 TabIndex 屬性值變更時。 (繼承來源 Control) |
| TabStopChanged |
發生在 TabStop 屬性值變更時。 (繼承來源 Control) |
| TextAlignChanged |
發生於文字對齊方式變更時。 |
| TextChanged |
發生在 Text 屬性值變更時。 (繼承來源 Control) |
| TypeValidationCompleted |
發生於 MaskedTextBox 完成了目前使用 ValidatingType 屬性的值之剖析作業後。 |
| Validated |
發生於控制項完成驗證時。 (繼承來源 Control) |
| Validating |
發生於驗證控制項時。 (繼承來源 Control) |
| VisibleChanged |
發生在 Visible 屬性值變更時。 (繼承來源 Control) |
明確介面實作
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |
適用於
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應