TextBoxBase 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
實作文字控制項所需的基本功能。
public ref class TextBoxBase abstract : System::Windows::Forms::Control
public abstract class TextBoxBase : System.Windows.Forms.Control
[System.ComponentModel.DefaultBindingProperty("Text")]
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class TextBoxBase : System.Windows.Forms.Control
[System.ComponentModel.DefaultBindingProperty("Text")]
public abstract class TextBoxBase : System.Windows.Forms.Control
type TextBoxBase = class
inherit Control
[<System.ComponentModel.DefaultBindingProperty("Text")>]
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextBoxBase = class
inherit Control
[<System.ComponentModel.DefaultBindingProperty("Text")>]
type TextBoxBase = class
inherit Control
Public MustInherit Class TextBoxBase
Inherits Control
- 繼承
- 衍生
- 屬性
範例
以下程式碼範例使用 TextBox,一個衍生類別,建立帶有垂直滾動條的多行 TextBox 控制項。 此範例也使用 AcceptsTab、 AcceptsReturn和 WordWrap 屬性,使多行文字框控制項在建立文字文件時變得有用。
public:
void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox^ textBox1 = gcnew TextBox;
// Set the Multiline property to true.
textBox1->Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1->ScrollBars = ScrollBars::Vertical;
// Allow the RETURN key in the TextBox control.
textBox1->AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1->AcceptsTab = true;
// Set WordWrap to true to allow text to wrap to the next line.
textBox1->WordWrap = true;
// Set the default text of the control.
textBox1->Text = "Welcome!" + Environment::NewLine + "Second Line";
}
public void CreateMyMultilineTextBox()
{
// Create an instance of a TextBox control.
TextBox textBox1 = new TextBox();
// Set the Multiline property to true.
textBox1.Multiline = true;
// Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical;
// Allow the RETURN key in the TextBox control.
textBox1.AcceptsReturn = true;
// Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = true;
// Set WordWrap to true to allow text to wrap to the next line.
textBox1.WordWrap = true;
// Set the default text of the control.
textBox1.Text = "Welcome!" + Environment.NewLine + "Second Line";
}
Public Sub CreateMyMultilineTextBox()
' Create an instance of a TextBox control.
Dim textBox1 As New TextBox()
' Set the Multiline property to true.
textBox1.Multiline = True
' Add vertical scroll bars to the TextBox control.
textBox1.ScrollBars = ScrollBars.Vertical
' Allow the RETURN key in the TextBox control.
textBox1.AcceptsReturn = True
' Allow the TAB key to be entered in the TextBox control.
textBox1.AcceptsTab = True
' Set WordWrap to true to allow text to wrap to the next line.
textBox1.WordWrap = True
' Set the default text of the control.
textBox1.Text = "Welcome!" & Environment.NewLine & "Second Line"
End Sub
備註
此類別實作文本操作控制的核心特性,如 TextBox 和 RichTextBox。 這些功能包括文字選擇、 剪貼簿 功能、多行文字控制支援,以及許多事件。
給實施者的注意事項
你通常不會從 繼承。TextBoxBase 要建立自己的文字控制類別,繼承 或 TextBoxRichTextBox。
屬性
| 名稱 | Description |
|---|---|
| AcceptsTab |
取得或設定一個值,指示在多行文字框控制中按 TAB 鍵時,是否在控制鍵中輸入 TAB 字元,而非將焦點移至制表序列中的下一個控制項。 |
| AccessibilityObject |
讓被 AccessibleObject 指派到控制室。 (繼承來源 Control) |
| AccessibleDefaultActionDescription |
取得或設定控制項的預設動作描述,供無障礙客戶端應用程式使用。 (繼承來源 Control) |
| AccessibleDescription |
取得或設定無障礙客戶端應用程式所使用的控制項描述。 (繼承來源 Control) |
| AccessibleName |
取得或設定無障礙客戶端應用程式所使用的控制項名稱。 (繼承來源 Control) |
| AccessibleRole |
取得或設定控制的可及角色。 (繼承來源 Control) |
| AllowDrop |
取得或設定一個值,指示控制器是否能接受使用者拖曳到的資料。 (繼承來源 Control) |
| Anchor |
取得或設定控制項綁定容器的邊緣,並決定控制項如何與父控制項進行調整大小。 (繼承來源 Control) |
| AutoScrollOffset |
取得或設定,將此控制捲動至。ScrollControlIntoView(Control) (繼承來源 Control) |
| AutoSize |
會取得或設定一個值,指示當指派給控制項的字型被更改時,控制鍵的高度是否會自動調整。 |
| BackColor |
取得或設定控制點的背景色。 |
| BackgroundImage |
此性質對此類別無關。 |
| BackgroundImageLayout |
此性質對此類別無關。 |
| BindingContext |
取得或設定 BindingContext 控制。 (繼承來源 Control) |
| BorderStyle |
取得或設定文字框控制的邊界類型。 |
| Bottom |
取得控制項底部邊緣與容器用戶端區域頂部邊緣之間的距離(像素)。 (繼承來源 Control) |
| Bounds |
取得或設定控制項的大小與位置,包括非用戶端元素,以像素為單位,相對於父控制項。 (繼承來源 Control) |
| CanEnableIme |
會取得一個值,表示該屬性是否 ImeMode 能被設定為主動值,以支援 IME。 |
| CanFocus |
會獲得一個值,表示控制點是否能獲得焦點。 (繼承來源 Control) |
| CanRaiseEvents |
判斷事件是否能在控制組上引發。 (繼承來源 Control) |
| CanSelect |
會得到一個值,表示是否可以選擇該控制項。 (繼承來源 Control) |
| CanUndo |
會取得一個值,表示使用者是否能在文字框控制中還原先前的操作。 |
| 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 |
當控制句柄建立時,會取得所需的建立參數。 |
| Cursor |
當滑鼠指標位於控制器上時,會顯示或設定游標。 (繼承來源 Control) |
| DataBindings |
取得控制項的資料綁定。 (繼承來源 Control) |
| DataContext |
取得或設定資料上下文以進行資料綁定。 這是一個環境音屬性。 (繼承來源 Control) |
| DefaultCursor |
取得或設定控制鍵的預設游標。 |
| DefaultImeMode |
可獲得控制項所支援的預設輸入法編輯器(IME)模式。 (繼承來源 Control) |
| DefaultMargin |
取得預設控制點間設定的像素空間。 (繼承來源 Control) |
| DefaultMaximumSize |
取得控制項預設最大大小的長度與高度(像素數)。 (繼承來源 Control) |
| DefaultMinimumSize |
取得控制項預設最小大小的長度與高度(像素)。 (繼承來源 Control) |
| DefaultPadding |
取得控制項內容的預設內部間距(像素)。 (繼承來源 Control) |
| DefaultSize |
會得到預設大小的控制器。 |
| DesignMode |
取得值,這個值表示 Component 目前是否處於設計模式。 (繼承來源 Component) |
| DeviceDpi |
取得目前顯示控制項所在顯示器的 DPI 值。 (繼承來源 Control) |
| DisplayRectangle |
取得代表控制器顯示區域的矩形。 (繼承來源 Control) |
| Disposing |
會取得一個值,表示基底 Control 類別是否正在處理中。 (繼承來源 Control) |
| Dock |
取得或設定哪些控制邊界對接到其父控制,並決定控制點如何與父控制進行調整大小。 (繼承來源 Control) |
| DoubleBuffered |
取得或設定一個值,指示控制繪製是否在緩衝區中完成,然後再顯示控制項。 此性質對此類別無關。 |
| Enabled |
取得或設定一個值,表示控制項是否能回應使用者互動。 (繼承來源 Control) |
| Events |
取得附加至這個 Component之事件處理程序的清單。 (繼承來源 Component) |
| Focused |
會得到一個值,表示控制器是否有輸入焦點。 (繼承來源 Control) |
| Font |
取得或設定控制項顯示文字的字型。 (繼承來源 Control) |
| FontHeight |
取得或設定控制鍵字型的高度。 (繼承來源 Control) |
| ForeColor |
取得或設定控制鍵的前景色。 |
| Handle |
它會得到控制項綁定的視窗把手。 (繼承來源 Control) |
| HasChildren |
會取得一個值,表示該控制是否包含一個或多個子控制項。 (繼承來源 Control) |
| Height |
取得或設定控制點的高度。 (繼承來源 Control) |
| HideSelection |
會取得或設定一個值,指示當控制項失去焦點時,文字框中所選文字是否仍被高亮。 |
| ImeMode |
取得或設定控制器的輸入法編輯器(IME)模式。 (繼承來源 Control) |
| ImeModeBase |
取得或設定控制項的輸入法編輯器(IME)模式。 |
| InvokeRequired |
會獲得一個值,表示呼叫者在呼叫控制項時是否必須呼叫呼叫方法,因為呼叫者使用的執行緒與該控制項建立的執行緒不同。 (繼承來源 Control) |
| IsAccessible |
取得或設定一個值,指示該控制項是否對無障礙應用程式可見。 (繼承來源 Control) |
| IsAncestorSiteInDesignMode |
顯示該控制點的前祖是否被設置在 DesignMode 中。 這個屬性是唯讀的。 (繼承來源 Control) |
| IsDisposed |
會有一個值,表示控制權是否已被處理掉。 (繼承來源 Control) |
| IsHandleCreated |
會得到一個值,表示該控制項是否有與其相關的 handle。 (繼承來源 Control) |
| IsMirrored |
會得到一個值,表示該控制是否為鏡像。 (繼承來源 Control) |
| LayoutEngine |
會取得控制點的佈局引擎的快取實例。 (繼承來源 Control) |
| Left |
取得或設定控制項左邊與容器客戶端區域左邊之間的距離(像素)。 (繼承來源 Control) |
| Lines |
取得或設定文字框中的文字行數控制。 |
| Location |
取得或設定控制器左上角相對於容器左上角的座標。 (繼承來源 Control) |
| Margin |
取得或設定控制區之間的空格。 (繼承來源 Control) |
| MaximumSize |
取得或設定的上限是可以指定的上限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| MaxLength |
取得或設定使用者在文字框控制中可輸入或貼上的最大字元數。 |
| MinimumSize |
取得或設定的尺寸是可指定的下限 GetPreferredSize(Size) 。 (繼承來源 Control) |
| Modified |
取得或設定一個值,表示自使用者建立控制項或其內容設定後,已修改過該文字框控制項。 |
| Multiline |
取得或設定一個值,指示此值是否為多行文字框控制項。 |
| Name |
取得或設定控制的名稱。 (繼承來源 Control) |
| Padding |
此性質對此類別無關。 |
| Parent |
取得或設定控制的父容器。 (繼承來源 Control) |
| PreferredHeight |
會取得文字框的偏好高度。 |
| PreferredSize |
大小相當於一個長方形區域,控制器可以放進去。 (繼承來源 Control) |
| ProductName |
取得包含控制項的組件產品名稱。 (繼承來源 Control) |
| ProductVersion |
取得包含控制項的組裝版本。 (繼承來源 Control) |
| ReadOnly |
會取得或設定一個值,指示文字框中的文字是否為唯讀。 |
| RecreatingHandle |
會取得一個值,表示該控制項目前是否正在重新建立其句柄。 (繼承來源 Control) |
| Region |
取得或設定與控制項相關的視窗區域。 (繼承來源 Control) |
| RenderRightToLeft |
已淘汰.
已淘汰.
該物業現已過時。 (繼承來源 Control) |
| ResizeRedraw |
會取得或設定一個值,表示控制項在調整時是否會自行重新繪製。 (繼承來源 Control) |
| Right |
取得控制器右邊與容器用戶端區域左邊之間的距離(像素)。 (繼承來源 Control) |
| RightToLeft |
取得或設定一個值,指示 control 元素是否對齊以支援使用右至左字型的區域。 (繼承來源 Control) |
| ScaleChildren |
會得到一個決定子控制項縮放的值。 (繼承來源 Control) |
| SelectedText |
取得或設定一個值,表示目前控制項中選取的文字。 |
| SelectionLength |
取得或設定文字框中選取的字元數。 |
| SelectionStart |
取得或設定文字框中選取的文字起始點。 |
| ShortcutsEnabled |
取得或設定一個值,表示該捷徑是否啟用。 |
| ShowFocusCues |
會得到一個值,指示控制器是否應該顯示焦點矩形。 (繼承來源 Control) |
| ShowKeyboardCues |
會取得一個值,表示使用者介面是否處於顯示或隱藏鍵盤加速器的適當狀態。 (繼承來源 Control) |
| Site |
取得或設定控制點。 (繼承來源 Control) |
| Size |
設定控制器的高度與寬度。 (繼承來源 Control) |
| TabIndex |
取得或設定容器內控制項的制表順序。 (繼承來源 Control) |
| TabStop |
取得或設定一個值,指示使用者是否能使用 TAB 鍵將焦點分配給此控制項。 (繼承來源 Control) |
| Tag |
取得或設定包含控制項資料的物件。 (繼承來源 Control) |
| Text |
在文字框中取得或設定目前的文字。 |
| TextLength |
控制鍵裡會顯示文字長度。 |
| Top |
取得或設定控制面板頂端與容器用戶端區域頂端之間的距離(以像素為單位)。 (繼承來源 Control) |
| TopLevelControl |
取得沒有其他 Windows Forms 控制項的父控制。 通常,這是控制所包含的最 Form 外層。 (繼承來源 Control) |
| UseWaitCursor |
取得或設定一個值,指示是否使用等待游標來控制目前的控制項及所有子控制項。 (繼承來源 Control) |
| Visible |
取得或設定一個值,表示該控制項及其所有子控制項是否被顯示。 (繼承來源 Control) |
| Width |
設定或設定控制寬度。 (繼承來源 Control) |
| WindowTarget |
此性質對此類別無關。 (繼承來源 Control) |
| WordWrap |
表示多行文字框控制項是否會在必要時自動將單字包裹到下一行開頭。 |
方法
事件
| 名稱 | Description |
|---|---|
| AcceptsTabChanged |
當房產價值 AcceptsTab 變動時,會發生這種情況。 |
| AutoSizeChanged |
這個活動與本班無關。 |
| BackColorChanged |
發生於 BackColor 屬性的值變更時。 (繼承來源 Control) |
| BackgroundImageChanged |
發生於 BackgroundImage 屬性的值變更時。 這個活動與本班無關。 |
| BackgroundImageLayoutChanged |
發生於 BackgroundImageLayout 屬性的值變更時。 這個活動與本班無關。 |
| BindingContextChanged |
發生於 BindingContext 屬性的值變更時。 (繼承來源 Control) |
| BorderStyleChanged |
當房產價值 BorderStyle 變動時,會發生這種情況。 |
| CausesValidationChanged |
發生於 CausesValidation 屬性的值變更時。 (繼承來源 Control) |
| ChangeUICues |
當焦點或鍵盤使用者介面(UI)提示改變時,會發生這種情況。 (繼承來源 Control) |
| Click |
當點擊文字框時會發生。 |
| 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 設定在父控制器或表單的 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 變動時,會發生這種情況。 |
| ImeModeChanged |
當房產發生變化時 ImeMode 。 (繼承來源 Control) |
| Invalidated |
當控制器顯示需要重新繪製時,會發生這種情況。 (繼承來源 Control) |
| KeyDown |
當按鍵時,控制器處於焦點狀態時會發生。 (繼承來源 Control) |
| KeyPress |
當按鍵在控制鍵處於焦點狀態時,按下字元、空白鍵或退格鍵時會發生。 (繼承來源 Control) |
| KeyUp |
當控制鍵處於對焦狀態時放開鍵時會發生。 (繼承來源 Control) |
| Layout |
當控制項應該重新定位其子控制項時,會發生這種情況。 (繼承來源 Control) |
| Leave |
當輸入焦點離開控制器時會發生。 (繼承來源 Control) |
| LocationChanged |
發生於 Location 屬性值變更時。 (繼承來源 Control) |
| LostFocus |
當控制失焦時會發生。 (繼承來源 Control) |
| MarginChanged |
當對照組的邊界改變時會發生。 (繼承來源 Control) |
| ModifiedChanged |
當房產價值 Modified 變動時,會發生這種情況。 |
| MouseCaptureChanged |
當控制組失去滑鼠捕捉時會發生。 (繼承來源 Control) |
| MouseClick |
當滑鼠點擊控制鍵時會發生。 |
| MouseDoubleClick |
當滑鼠雙擊控制鍵時會發生。 (繼承來源 Control) |
| MouseDown |
當滑鼠指標放在控制器上,按下滑鼠按鈕時會發生。 (繼承來源 Control) |
| MouseEnter |
當滑鼠指標進入控制鍵時會發生。 (繼承來源 Control) |
| MouseHover |
當滑鼠指標放在控制器上時會發生。 (繼承來源 Control) |
| MouseLeave |
當滑鼠指標離開控制鍵時會發生。 (繼承來源 Control) |
| MouseMove |
當滑鼠指標移到控制器上時會發生。 (繼承來源 Control) |
| MouseUp |
當滑鼠指標放在控制器上方並放開滑鼠按鈕時,會發生這種情況。 (繼承來源 Control) |
| MouseWheel |
當滑鼠滾輪移動時,控制器仍保持對焦。 (繼承來源 Control) |
| Move |
當控制桿移動時會發生。 (繼承來源 Control) |
| MultilineChanged |
當房產價值 Multiline 變動時,會發生這種情況。 |
| PaddingChanged |
這個活動與本班無關。 |
| Paint |
當控制鍵重新繪製時會發生。 這個活動與本班無關。 |
| ParentChanged |
當房產價值變動時 Parent 發生。 (繼承來源 Control) |
| PreviewKeyDown |
當按鍵在該控制鍵上時,會發生在事件發生 KeyDown 前。 (繼承來源 Control) |
| QueryAccessibilityHelp |
當 AccessibleObject 提供無障礙應用程式協助時,會發生這種情況。 (繼承來源 Control) |
| QueryContinueDrag |
發生在拖放操作期間,使拖曳源判斷是否應該取消拖放操作。 (繼承來源 Control) |
| ReadOnlyChanged |
當房產價值 ReadOnly 變動時,會發生這種情況。 |
| RegionChanged |
發生於 Region 屬性的值變更時。 (繼承來源 Control) |
| Resize |
當控制大小被調整時會發生。 (繼承來源 Control) |
| RightToLeftChanged |
當房產價值變動時 RightToLeft 發生。 (繼承來源 Control) |
| SizeChanged |
當房產價值變動時 Size 發生。 (繼承來源 Control) |
| StyleChanged |
當控制風格改變時會發生。 (繼承來源 Control) |
| SystemColorsChanged |
當系統顏色改變時會發生。 (繼承來源 Control) |
| TabIndexChanged |
當房產價值變動時 TabIndex 發生。 (繼承來源 Control) |
| TabStopChanged |
當房產價值變動時 TabStop 發生。 (繼承來源 Control) |
| TextChanged |
當房產價值變動時 Text 發生。 (繼承來源 Control) |
| Validated |
當控制驗證完成時發生。 (繼承來源 Control) |
| Validating |
當對照組進行驗證時會發生。 (繼承來源 Control) |
| VisibleChanged |
當房產價值變動時 Visible 發生。 (繼承來源 Control) |
明確介面實作
| 名稱 | Description |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引發 DragDrop 事件。 (繼承來源 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引發 DragEnter 事件。 (繼承來源 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引發 DragLeave 事件。 (繼承來源 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引發 DragOver 事件。 (繼承來源 Control) |