TextBox 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示 Windows 文本框控件。
public ref class TextBox : System::Windows::Forms::TextBoxBasepublic class TextBox : System.Windows.Forms.TextBoxBase[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class TextBox : System.Windows.Forms.TextBoxBasetype TextBox = class
inherit TextBoxBase[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TextBox = class
inherit TextBoxBasePublic Class TextBox
Inherits TextBoxBase- 继承
- 派生
- 属性
示例
下面的代码示例使用垂直滚动条创建多行 TextBox 控件。 此示例使用AcceptsTab和AcceptsReturnDock属性使多行文本框控件可用于创建文本文档。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Linq;
using System.Text;
using System.Windows.Forms;
public class Form1 : Form
{
private TextBox textBox1;
public Form1()
{
InitializeComponent();
}
private void InitializeComponent()
{
this.textBox1 = new System.Windows.Forms.TextBox();
this.SuspendLayout();
//
// textBox1
//
this.textBox1.AcceptsReturn = true;
this.textBox1.AcceptsTab = true;
this.textBox1.Dock = System.Windows.Forms.DockStyle.Fill;
this.textBox1.Multiline = true;
this.textBox1.ScrollBars = System.Windows.Forms.ScrollBars.Vertical;
//
// Form1
//
this.ClientSize = new System.Drawing.Size(284, 264);
this.Controls.Add(this.textBox1);
this.Text = "TextBox Example";
this.ResumeLayout(false);
this.PerformLayout();
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Linq
Imports System.Text
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Dim textBox1 As TextBox
Public Sub New()
InitializeComponent()
End Sub
Private Sub InitializeComponent()
Me.textBox1 = New System.Windows.Forms.TextBox()
Me.SuspendLayout()
'
' textBox1
'
Me.textBox1.AcceptsReturn = True
Me.textBox1.AcceptsTab = True
Me.textBox1.Dock = System.Windows.Forms.DockStyle.Fill
Me.textBox1.Multiline = True
Me.textBox1.ScrollBars = System.Windows.Forms.ScrollBars.Vertical
'
' Form1
'
Me.ClientSize = New System.Drawing.Size(284, 264)
Me.Controls.Add(Me.textBox1)
Me.Text = "TextBox Example"
Me.ResumeLayout(False)
Me.PerformLayout()
End Sub
End Class
注解
TextBox使用控件，用户可以在应用程序中输入文本。 此控件具有标准 Windows 文本框控件中未找到的其他功能，包括多行编辑和密码字符掩码。
通常， TextBox 控件用于显示或接受作为输入的单个文本行。 可以使用 Multiline 和 ScrollBars 属性来启用要显示或输入的多行文本。 设置 AcceptsTab 属性 AcceptsReturn 以 true 在多行 TextBox 控件中启用更大的文本操作。
可以通过将MaxLength属性设置为特定数量的字符来限制在控件中TextBox输入的文本量。 TextBox 控件还可用于接受密码和其他敏感信息。 可以使用该 PasswordChar 属性屏蔽在控件的单行版本中输入的字符。 CharacterCasing使用属性可让用户仅键入大写、仅小写或将大写和小写字符组合到控件中TextBox。
若要滚动该控件的内容 TextBox ，直到光标（插入符号）位于控件的可见区域中，可以使用该方法 ScrollToCaret 。 若要在文本框中选择一系列文本，可以使用该方法 Select 。
若要限制控件中 TextBox 输入的文本，可以为事件创建事件处理程序 KeyDown ，以验证控件中输入的每个字符。 还可以通过将属性设置为
构造函数
| 名称 | 说明 |
|---|---|
| TextBox() |
初始化 TextBox 类的新实例。 |
属性
| 名称 | 说明 |
|---|---|
| AcceptsReturn |
获取或设置一个值，该值指示在多行 TextBox 控件中按 Enter 是创建控件中的新文本行还是激活窗体的默认按钮。 |
| AcceptsTab |
获取或设置一个值，该值指示在多行文本框控件中按 TAB 键是否键入控件中的 TAB 字符，而不是将焦点移动到 Tab 键顺序中的下一个控件。 (继承自 TextBoxBase) |
| AccessibilityObject |
AccessibleObject获取分配给控件的控件。 (继承自 Control) |
| AccessibleDefaultActionDescription |
获取或设置控件的默认操作说明，以供辅助功能客户端应用程序使用。 (继承自 Control) |
| AccessibleDescription |
获取或设置辅助功能客户端应用程序使用的控件的说明。 (继承自 Control) |
| AccessibleName |
获取或设置辅助功能客户端应用程序使用的控件的名称。 (继承自 Control) |
| AccessibleRole |
获取或设置控件的可访问角色。 (继承自 Control) |
| AllowDrop |
获取或设置一个值，该值指示控件是否可以接受用户拖动到其中的数据。 (继承自 Control) |
| Anchor |
获取或设置控件绑定到的容器的边缘，并确定控件的父级如何调整其大小。 (继承自 Control) |
| AutoCompleteCustomSource |
获取或设置 StringCollection 在 AutoCompleteSource 属性设置为 |
| AutoCompleteMode |
获取或设置一个选项，该选项控制自动完成的工作原理 TextBox。 |
| AutoCompleteSource |
获取或设置一个值，该值指定用于自动完成的完整字符串的源。 |
| AutoScrollOffset |
获取或设置此控件滚动到的位置 ScrollControlIntoView(Control)。 (继承自 Control) |
| AutoSize |
获取或设置一个值，该值指示在更改分配给控件的字体时控件的高度是否自动调整。 (继承自 TextBoxBase) |
| BackColor |
获取或设置控件的背景色。 (继承自 TextBoxBase) |
| BackgroundImage |
此属性与此类无关。 (继承自 TextBoxBase) |
| BackgroundImageLayout |
此属性与此类无关。 (继承自 TextBoxBase) |
| BindingContext |
获取或设置 BindingContext 控件。 (继承自 Control) |
| BorderStyle |
获取或设置文本框控件的边框类型。 (继承自 TextBoxBase) |
| Bottom |
获取控件的下边缘与其容器工作区的上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Bounds |
获取或设置控件的大小和位置，包括其相对于父控件的非client 元素（以像素为单位）。 (继承自 Control) |
| CanEnableIme |
获取一个值，该值指示属性是否可以 ImeMode 设置为活动值，以启用 IME 支持。 (继承自 TextBoxBase) |
| CanFocus |
获取一个值，该值指示控件是否可以接收焦点。 (继承自 Control) |
| CanRaiseEvents |
确定是否可以在控件上引发事件。 (继承自 Control) |
| CanSelect |
获取一个值，该值指示是否可以选择控件。 (继承自 Control) |
| CanUndo |
获取一个值，该值指示用户是否可以撤消文本框控件中的上一操作。 (继承自 TextBoxBase) |
| Capture |
获取或设置一个值，该值指示控件是否已捕获鼠标。 (继承自 Control) |
| CausesValidation |
获取或设置一个值，该值指示控件是否导致验证在收到焦点时需要验证的任何控件上执行。 (继承自 Control) |
| CharacterCasing |
获取或设置控件是否 TextBox 在键入字符时修改字符大小写。 |
| 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 |
获取或设置控件的默认游标。 (继承自 TextBoxBase) |
| DefaultImeMode |
获取控件支持的默认输入法编辑器 （IME） 模式。 |
| 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) |
| Handle |
获取控件绑定到的窗口句柄。 (继承自 Control) |
| HasChildren |
获取一个值，该值指示控件是否包含一个或多个子控件。 (继承自 Control) |
| Height |
获取或设置控件的高度。 (继承自 Control) |
| HideSelection |
获取或设置一个值，该值指示当控件失去焦点时，文本框控件中的选定文本是否保持突出显示状态。 (继承自 TextBoxBase) |
| ImeMode |
获取或设置控件的输入法编辑器 （IME） 模式。 (继承自 Control) |
| ImeModeBase |
获取或设置控件的输入法编辑器 （IME） 模式。 (继承自 TextBoxBase) |
| InvokeRequired |
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用调用方法，因为调用方与创建控件的线程不同。 (继承自 Control) |
| IsAccessible |
获取或设置一个值，该值指示控件是否对辅助功能应用程序可见。 (继承自 Control) |
| IsAncestorSiteInDesignMode |
指示此控件的上级位置之一是否位于 DesignMode 中。 此属性为只读。 (继承自 Control) |
| IsDisposed |
获取一个值，该值指示控件是否已释放。 (继承自 Control) |
| IsHandleCreated |
获取一个值，该值指示控件是否具有与之关联的句柄。 (继承自 Control) |
| IsMirrored |
获取一个值，该值指示控件是否镜像。 (继承自 Control) |
| LayoutEngine |
获取控件布局引擎的缓存实例。 (继承自 Control) |
| Left |
获取或设置控件左边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| Lines |
获取或设置文本框控件中的文本行。 (继承自 TextBoxBase) |
| Location |
获取或设置控件左上角相对于其容器左上角的坐标。 (继承自 Control) |
| Margin |
获取或设置控件之间的间距。 (继承自 Control) |
| MaximumSize |
获取或设置可指定上限 GetPreferredSize(Size) 的大小。 (继承自 Control) |
| MaxLength |
获取或设置用户可键入或粘贴到文本框控件中的最大字符数。 (继承自 TextBoxBase) |
| MinimumSize |
获取或设置可以指定的下限 GetPreferredSize(Size) 的大小。 (继承自 Control) |
| Modified |
获取或设置一个值，该值指示自创建控件或其内容上次设置后，用户已修改文本框控件。 (继承自 TextBoxBase) |
| Multiline |
获取或设置一个值，该值指示这是否为多行 TextBox 控件。 |
| Multiline |
获取或设置一个值，该值指示这是否是多行文本框控件。 (继承自 TextBoxBase) |
| Name |
获取或设置控件的名称。 (继承自 Control) |
| Padding |
此属性与此类无关。 (继承自 TextBoxBase) |
| Parent |
获取或设置控件的父容器。 (继承自 Control) |
| PasswordChar |
获取或设置用于屏蔽单行 TextBox 控件中密码字符的字符。 |
| PlaceholderText |
获取或设置控件没有文本且没有焦点时显示的文本。 |
| PreferredHeight |
获取文本框的首选高度。 (继承自 TextBoxBase) |
| PreferredSize |
获取控件可以容纳到的矩形区域的大小。 (继承自 Control) |
| ProductName |
获取包含控件的程序集的产品名称。 (继承自 Control) |
| ProductVersion |
获取包含控件的程序集的版本。 (继承自 Control) |
| ReadOnly |
获取或设置一个值，该值指示文本框中的文本是否为只读。 (继承自 TextBoxBase) |
| RecreatingHandle |
获取一个值，该值指示控件当前是否正在重新创建其句柄。 (继承自 Control) |
| Region |
获取或设置与控件关联的窗口区域。 (继承自 Control) |
| RenderRightToLeft |
已过时.
已过时.
此属性现已过时。 (继承自 Control) |
| ResizeRedraw |
获取或设置一个值，该值指示控件在调整大小时是否重新绘制自身。 (继承自 Control) |
| Right |
获取控件右边缘与其容器工作区的左边缘之间的距离（以像素为单位）。 (继承自 Control) |
| RightToLeft |
获取或设置一个值，该值指示控件的元素是否对齐以支持使用从右到左字体的区域设置。 (继承自 Control) |
| ScaleChildren |
获取一个值，该值确定子控件的缩放。 (继承自 Control) |
| ScrollBars |
获取或设置应在多行 TextBox 控件中显示的滚动条。 |
| SelectedText |
获取或设置一个值，该值指示控件中当前选定的文本。 (继承自 TextBoxBase) |
| SelectionLength |
获取或设置在文本框的可编辑部分选择的字符数。 |
| SelectionLength |
获取或设置在文本框中选择的字符数。 (继承自 TextBoxBase) |
| SelectionStart |
获取或设置文本框中所选文本的起点。 (继承自 TextBoxBase) |
| ShortcutsEnabled |
获取或设置一个值，该值指示是否启用定义的快捷方式。 (继承自 TextBoxBase) |
| ShowFocusCues |
获取一个值，该值指示控件是否应显示焦点矩形。 (继承自 Control) |
| ShowKeyboardCues |
获取一个值，该值指示用户界面是否处于适当的状态以显示或隐藏键盘加速器。 (继承自 Control) |
| Site |
获取或设置控件的站点。 (继承自 Control) |
| Size |
获取或设置控件的高度和宽度。 (继承自 Control) |
| TabIndex |
获取或设置控件在其容器中的 Tab 键顺序。 (继承自 Control) |
| TabStop |
获取或设置一个值，该值指示用户是否可以使用 TAB 键向此控件提供焦点。 (继承自 Control) |
| Tag |
获取或设置包含有关控件的数据的对象。 (继承自 Control) |
| Text |
获取或设置与此控件关联的文本。 |
| TextAlign |
获取或设置文本在控件中的 TextBox 对齐方式。 |
| TextLength |
获取控件中的文本长度。 (继承自 TextBoxBase) |
| Top |
获取或设置控件上边缘与其容器工作区上边缘之间的距离（以像素为单位）。 (继承自 Control) |
| TopLevelControl |
获取其他 Windows 窗体控件未父控件的父控件。 通常，这是控件包含在的最外层 Form 。 (继承自 Control) |
| UseSystemPasswordChar |
获取或设置一个值，该值指示控件中的 TextBox 文本是否应显示为默认密码字符。 |
| UseWaitCursor |
获取或设置一个值，该值指示是否对当前控件和所有子控件使用等待游标。 (继承自 Control) |
| Visible |
获取或设置一个值，该值指示是否显示控件及其所有子控件。 (继承自 Control) |
| Width |
获取或设置控件的宽度。 (继承自 Control) |
| WindowTarget |
此属性与此类无关。 (继承自 Control) |
| WordWrap |
指示多行文本框控件是否在必要时自动将单词包装到下一行的开头。 (继承自 TextBoxBase) |
方法
活动
显式接口实现
| 名称 | 说明 |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
引发 DragDrop 事件。 (继承自 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
引发 DragEnter 事件。 (继承自 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
引发 DragLeave 事件。 (继承自 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
引发 DragOver 事件。 (继承自 Control) |
