winfrom控件基本知识

 

数据显示控件

DataGridView 控件

DataGridView 控件提供用来显示数据的可自定义表。使用 DataGridView 类，能够自定

义单元格、行、列和边框。

在可自定义的网格中显示数据。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class DataGridView : Control, ISupportInitialize

备注

DataGridView 控件提供用来显示数据的可自定义表。使用 DataGridView 类，能够经过

使用 DefaultCellStyle、ColumnHeadersDefaultCellStyle、CellBorderStyle 和 GridColor 等属

性对单元格、行、列和边框进行自定义。有关更多信息，请参见 Windows 窗体 DataGridView

控件中的基本格式设置和样式设置。

可使用 DataGridView 控件来显示有基础数据源或没有基础数据源的数据。若是没有

指定数据源，能够建立包含数据的列和行，并将它们直接添加到 DataGridView。或者，能够

设置 DataSource 和 DataMember 属性，以便将 DataGridView 绑定到数据源，并自动用数

据填充该控件。有关更多信息，请参见在 Windows 窗体 DataGridView 控件中显示数据。

在处理大量数据时，能够将 VirtualMode 属性设置为 true，以便显示可用数据的子集。

虚拟模式要求实现用来填充 DataGridView 控件的数据缓存。有关更多信息，请参见

Windows 窗体 DataGridView 控件中的数据显示模式。

有关 DataGridView 控件中可用功能的其余信息，请参见 DataGridView 控件（Windows

窗体）。

虽然 DataGridView 控件替代了之前版本的 DataGrid 控件并增长了功能，可是为了实

现向后兼容并考虑到未来的使用（若是您选择的话），仍然保留了 DataGrid 控件。

 

数据绑定和定位控件

BindingSource 组件

经过提供当前项管理、更改通知和其余服务，来简化将窗体上的控件绑定到数据的过程。

封装窗体的数据源。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

Public class BindingSource : Component, IBindingListView, IBindingList,

IList,ICollection,IEnumerable,ITypedList,ICancelAddNew,ISupportInitializeNotification,

ISupportInitialize, ICurrencyManagerProvider

备注

BindingSource 组件有两种用途。首先，它经过提供一个间接寻址层、当前项管理、更

改通知和其余服务简化了窗体中控件到数据的绑定。这是经过将 BindingSource 组件附加到

数据源而后将窗体中的控件绑定到 BindingSource 组件来实现的。与数据的全部进一步交

互，包括定位、排序、筛选和更新，都经过调用 BindingSource 组件实现。

第二，BindingSource 组件能够做为一个强类型的数据源。一般，基础数据源的类型通

过如下机制之一固定：

使用 Add 方法可将某项添加到 BindingSource 组件中。

将 DataSource 属性设置为一个列表、单个对象或类型。

这两种机制都建立一个强类型列表。 BindingSource 支持由其 DataSource 和

DataMember 属性指示的简单数据绑定和复杂数据绑定。

BindingSource 提供了用于访问基础数据的成员。经过 Current 属性能够检索当前项，

经过 List 属性能够检索整个列表。经过 Current、RemoveCurrent、EndEdit、CancelEdit、Add

和 AddNew 方法可支持对当前项的编辑操做。尽管对于全部基础数据源类型会自动处理当

前项管理，但该类公开了许多容许自定义的事件，例如 CurrentItemChanged 和

DataSourceChanged。

绑定到 BindingSource 组件的数据源也可使用 BindingNavigator 类定位和管理，该类

提供像 VCR 同样的用户界面 (UI) 用于定位列表中的项。尽管 BindingNavigator 能够绑定

到任何数据源，但它被设计为经过其 BindingNavigator.BindingSource 属性与 BindingSource

组件集成。

BindingSource 类的默认属性为 DataSource。默认事件为 CurrentChanged。

 

 

BindingNavigator 控件

提供工具栏式的界面来定位和操做窗体上的数据。

表示窗体上绑定到数据的控件的导航和操做用户界面 (UI)。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class BindingNavigator : ToolStrip, ISupportInitialize

备注

BindingNavigator 控件表示在窗体上定位和操做数据的标准化方法。多数状况下，

BindingNavigator 与 BindingSource 控件成对出现，用于浏览窗体上的数据记录，并与它们

交互。在这些状况下， BindingSource 属性被设置为做为数据源的关联

System.Windows.Forms.BindingSource 组件。

默认状况下，BindingNavigator 控件的用户界面 (UI) 由一系列 ToolStrip 按钮、文本框

和静态文本元素组成，用于进行大多数常见的数据相关操做（如添加数据、删除数据和在数

据中导航）。每一个控件均可以经过 BindingNavigator 控件的关联成员进行检索或设置。相似

地，还与以编程方式执行相同功能的 BindingSource 类的成员存在一一对应关系，以下表所

示。

UI 控件 BindingNavigator 成员 BindingSource 成员

移到最前 MoveFirstItem MoveFirst

前移一步 MovePreviousItem MovePrevious

当前位置 PositionItem Current

统计 CountItem Count

移到下一条记录 MoveNextItem MoveNext

移到最后 MoveLastItem MoveLast

新添 AddNewItem AddNew

删除 DeleteItem RemoveCurrent

将 BindingNavigator 控件添加到窗体并绑定到数据源（例如 BindingSource）时，将自C#从入门到精通

动在此表中创建关系。

BindingNavigator 的全部构造函数都调用 AddStandardItems 方法以将标准的 UI 控件

集与导航工具栏关联起来。可以使用如下技术之一自定义此工具栏：

建立带有 BindingNavigator(Boolean) 构造函数的 BindingNavigator，此构造函数接受

Boolean 型的 addStandardItems 参数，并将此参数设置为 false。而后将须要的 ToolStripItem

对象添加到 Items 集合。

若是须要进行大量的自定义设置，或者将重复使用自定义设计，应从 BindingNavigator

派生一个类并重写 AddStandardItems 方法以定义附加标准项或替换标准项。

 

文本编辑控件

TextBox 控件

显示设计时输入的文本，它可由用户在运行时编辑或以编程方式更改。

表示 Windows 文本框控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class TextBox : TextBoxBase

备注

使用 TextBox 控件，用户能够在应用程序中输入文本。此控件具备标准 Windows 文本

框控件所没有的附加功能，包括多行编辑和密码字符屏蔽。

一般，TextBox 控件用于显示单行文本或将单行文本做为输入来接受。可使用

Multiline 和 ScrollBars 属性，从而可以显示或输入多行文本。经过将 AcceptsTab 和

AcceptsReturn 属性设置为 true，可在多行 TextBox 控件中更加灵活地操做文本。

经过将 MaxLength 属性设置为一个特定的字符数，能够限制输入到 TextBox 控件中的

文本数量。TextBox 控件还可用于接受密码和其余敏感信息。可使用 PasswordChar 属性

屏蔽在控件的单行版本中输入的字符。使用 CharacterCasing 属性可以使用户在 TextBox 控件

中只能输入大写字符、只能输入小写字符，或者输入大小写字符的组合。

若要限制某些文本不被输入到 TextBox 控件，能够为 KeyDown 事件建立一个事件处

理程序，以便验证在控件中输入的每一个字符。也能够经过将 ReadOnly 属性设置为 true 来

限制 TextBox 控件中的全部数据项输入。

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE 平台说明：

在 Pocket PC 应用程序中，单行文本框中的选项卡显示为括号，但当 Multiline 设置为 true

时正常显示。

RichTextBox 控件

使文本可以以纯文本或 RTF 格式显示。

表示 Windows 多格式文本框控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class RichTextBox : TextBoxBase

备注

用户能够经过 RichTextBox 控件输入和编辑文本。该控件还提供比标准 TextBox 控件

更高级的格式设置功能。能够将文本直接分配给该控件，或者从 RTF 格式文件或纯文本文

件加载文本。能够为控件内的文本分配字符和段落格式设置。

RichTextBox 控件提供许多可对控件内任何文本部分应用格式设置的属性。若要更改文

本的格式设置，必须首先选定此文本。只能为选定的文本分配字符和段落格式设置。对选定

的文本内容进行设置后，在选定内容后输入的全部文本也用相同的设置进行格式设置，直到

更改设置或选定控件文档的不一样部分为止。SelectionFont 属性使您得以将文本以粗体或斜体

显示。还可使用此属性更改文本的大小和字样。SelectionColor 属性使您得以更改文本的

颜色。若要建立项目符号列表，可使用 SelectionBullet 属性。还能够经过设置

SelectionIndent、SelectionRightIndent 和 SelectionHangingIndent 属性调整段落格式设置。

RichTextBox 控件提供具备打开和保存文件的功能的方法。LoadFile 方法使您得以将现

有的 RTF 或 ASCII 文本文件加载到控件中。还能够从已打开的数据流加载数据。SaveFile

使您得以将文件保存到 RTF 或 ASCII 文本中。与 LoadFile 方法类似，还可使用

SaveFile 方法保存到开放式数据流。RichTextBox 控件还提供查找文本字符串的功能。Find

方法被重载，能够同时查找控件文本内的文本字符串以及特定字符。

也能够将 RichTextBox 控件初始化为内存中存储的数据。例如，能够将 Rtf 属性初始

化为包含要显示文本的字符串，包括肯定如何设置该文本格式的 RTF 代码。

若是控件内的文本包含连接（如到网站的连接），则可使用 DetectUrls 属性适当地显

示控件文本中的连接。而后能够处理 LinkClicked 事件以执行与该连接关联的任务。

SelectionProtected 属性使您得以保护控件内的文本不被用户操做。当控件中有受保护的文本

时，能够处理 Protected 事件以肯定用户什么时候曾试图修改受保护的文本，并提醒用户该文本

是受保护的，或向用户提供标准方式供其操做受保护的文本。

已使用 TextBox 控件的应用程序很容易就能够调整为使用 RichTextBox 控件。可是，

RichTextBox 控件没有与 TextBox 控件相同的 64K 字符容量限制。与字处理应用程序（如

Microsoft Word）相似，RichTextBox 一般用于提供文本操做和显示功能。

 

MaskedTextBox 控件

约束用户输入的格式

使用掩码区分正确和不正确的用户输入。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class MaskedTextBox : TextBoxBase

备注

MaskedTextBox 类是一个加强型的 TextBox 控件，它支持用于接受或拒绝用户输入的

声明性语法。经过使用 Mask 属性，无需在应用程序中编写任何自定义验证逻辑，便可指定

下列输入：

必需的输入字符。

可选的输入字符。

掩码中的给定位置所需的输入类型；例如，只容许数字、只容许字母或者容许字母和数字。

掩码的原义字符，或者应直接出如今 MaskedTextBox 中的字符；例如，电话号码中的

连字符 (-)，或者价格中的货币符号。

输入字符的特殊处理；例如，将字母字符转换为大写字母。

当 MaskedTextBox 控件在运行时显示时，会将掩码表示为一系列提示字符和可选的原

义字符。表示一个必需或可选输入的每一个可编辑掩码位置都显示为单个提示字符。例如，数

字符号 (#) 一般用做数字字符输入的占位符。可使用 PromptChar 属性来指定自定义提示

字符。HidePromptOnLeave 属性决定当控件失去输入焦点时用户可否看到提示字符。

当用户在掩码文本框中键入内容时，有效的输入字符将按顺序替换其各自的提示字符。

若是用户键入无效的字符，将不会发生替换。在这种状况下，若是 BeepOnError 属性设置为

true，将发出警告声，并引起 MaskInputRejected 事件。能够经过处理此事件来提供您本身的

自定义错误处理逻辑。

若是当前插入点位于原义字符处，用户将有多种选择：

若是键入提示字符之外的字符，将自动跳过该原义字符，输入字符将应用于下一个提示

字符所表示的下一个可编辑位置。

若是键入提示字符，而且 AllowPromptAsInput 属性为 true，输入将覆盖提示字符，插

入点将移至掩码中的下一个位置。

始终可使用箭头键来定位到上一个或下一个位置。

可使用 MaskFull 属性来验证用户是否输入了全部必需的输入内容。Text 属性将始终检索按照掩码和 TextMaskFormat 属性设置格式的用户输入。

实际上，MaskedTextBox 控件将全部掩码处理工做交给由 MaskedTextProvider 属性指定的 System.ComponentModel.MaskedTextProvider 类来完成。此标准提供程序支持除代理项和纵向组合字符之外的全部 Unicode 字符；可是，可使用 AsciiOnly 属性将输入限定为字符集 a-z、A-Z 和 0-9 内的字符。

掩码不能保证用户输入必定会表示给定类型的有效值，例如，输入的年龄值可能为 -9。经过将值的类型的实例赋给 ValidatingType 属性，能够确保用户输入表示一个有效值。经过监视 TypeValidationCompleted 事件，能够检测当 MaskedTextBox 包含无效值时，用户是否

将焦点从该控件移开。若是键入验证成功，能够经过 TypeValidationEventArgs 参数的ReturnValue 属性使用表示该值的对象。

与 TextBox 控件同样，几个通用键盘快捷键不能用于 MaskedTextBox。尤为是 Ctrl-R（右对齐文本）、Ctrl-L（左对齐文本）和 Ctrl-E（文本居中）都无效。

 

信息显示控件

Label 控件

显示用户没法直接编辑的文本。

表示标准 Windows 标签。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class Label : Control

备注

Label 控件一般用于提供控件的描述性文字。例如，可以使用 Label 为 TextBox 控件添

加描述性文字，以便将控件中所需的数据类型通知用户。Label 控件还可用于为 Form 添加

描述性文字，以便为用户提供有帮助做用的信息。例如，可将 Label 添加到 Form 的顶部，为用户提供关于如何将数据输入窗体上的控件中的说明。Label 控件还可用于显示有关应用程序状态的运行时信息。例如，可将 Label 控件添加到窗体，以便在处理一列文件时显示每一个文件的状态。Label 参与窗体的 Tab 键顺序，但不接收焦点（Tab 键顺序中的下一个控件接收焦点）。例如，若是 UseMnemonic 属性设置为 true，而且在控件的 Text 属性中指定助记键字符（“and”符 (&) 以后的第一个字符），则当用户按下 Alt+ 助记键时，焦点移动到 Tab 键顺序中的下一个控件。该功能为窗体提供键盘导航。除了显示文本外，Label 控件还可以使用Image 属性显示图像，或使用 ImageIndex 和 ImageList 属性组合显示图像。

LinkLabel 控件

将文本显示为 Web 样式的连接，并在用户单击该特殊文本时触发事件。该文本一般是

到另外一个窗口或网站的连接。

表示可显示超连接的 Windows 标签控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

 

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class LinkLabel : Label, IButtonControl

备注

ToolStripLabel 控件替换并向 Label 和 LinkLabel 控件添加功能。可是，Label 和 LinkLabel

控件均被保留下来，以实现向后兼容性和供之后使用（若是选用的话）。

LinkLabel 控件除了可显示超连接之外，它与 Label 控件相似。在控件的文本中能够指

定多个超连接。每一个超连接可在应用程序内执行不一样的任务。例如，可以使用超连接在 Microsoft

Internet Explorer 中显示网站或加载与应用程序关联的日志文件。

在 LinkLabel 控件中显示的每一个超连接都是 LinkLabel.Link 类的一个实例。

LinkLabel.Link 类定义超连接的显示信息、状态和位置。另外，LinkLabel.Link 类的 LinkData

属性使您得以将信息（如要显示的 URL）与超连接关联。当用户单击控件内的超连接时，

引 发 LinkClicked 事件，表示所单击的超连接的 LinkLabel.Link 对象做为

LinkLabelLinkClickedEventArgs 对象（该对象做为参数传递）的一部分传递给事件处理程序。

可使用此对象获取与用户所单击的超连接关联的 LinkLabel.Link 对象。LinkLabel 控件内

包含的全部超连接都存储在控件的 LinkLabel.LinkCollection 类实例中。

有两种方法可将超连接添加到 LinkLabel 控件中。最快捷的方法是指定 LinkArea，并

将其分配给 LinkArea 属性。这使您得以在控件的文本内指定单个超连接。若要添加多个超

连接，可以使用 LinkLabel.LinkCollection 类的 Add 方法，用户能够经过 Links 属性访问该

集合来使用此方法。

建立 LinkLabel 控件时，将向 LinkLabel.LinkCollection 添加包含 LinkLabel 控件内的

所有文本的默认超连接。可使用 LinkArea 属性指定新的连接区域来重写此默认连接；或

者使用 LinkLabel.LinkCollection 的 Add 方法指定连接。也可以使用 LinkLabel.LinkCollection

类的 Remove 方法来移除默认超连接。

LinkLabel 提供许多属性，这些属性使您得以定义控件中超连接的显示外观。

ActiveLinkColor、DisabledLinkColor、LinkColor 和 VisitedLinkColor 属性定义在各类状态下

显示超连接时所使用的颜色。LinkBehavior 属性定义与超连接关联的下划线的显示方式。

StatusStrip 控件

一般在父窗体的底部使用有框架的区域显示有关应用程序的当前状态的信息。

表示 Windows 状态栏控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）C#控件查询手册 王牌2

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class StatusStrip : ToolStrip

备注

虽然 StatusStrip 对之前版本的 StatusBar 控件进行替换和扩展，可是考虑到向后兼容性

和未来的使用（若是您选择），仍然保留了 StatusBar。

StatusStrip 控件显示关于正在 Form 上查看的对象或该对象的组件的信息，或显示与该

对象在应用程序中操做相关的上下文信息。一般 StatusStrip 控件由 ToolStripStatusLabel 对

象组成，其中每一个对象都显示文本和 / 或图标。 StatusStrip 还可包含

ToolStripDropDownButton、ToolStripSplitButton 和 ToolStripProgressBar 控件。

默认的 StatusStrip 没有面板。若要将面板添加到 StatusStrip ，请使用

ToolStripItemCollection.AddRange 方法，或使用 StatusStrip 项集合编辑器在设计时添加、移

除或从新排序项并修改属性。使用 StatusStrip 任务对话框在设计时运行经常使用命令。

ProgressBar 控件

向用户显示操做的当前进度。

表示 Windows 进度栏控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class ProgressBar : Control

备注

ProgressBar 控件以三种样式中的一种指示较长操做的进度：

从左向右分步递增的分段块。

从左向右填充的连续栏。

以字幕方式在 ProgressBar 中滚动的块。

Style 属性肯定显示的 ProgressBar 的样式。注意，ProgressBar 控件只能是水平方向的。有

关如何建立垂直方向的 ProgressBar 的示例，请参见 ProgressBarRenderer 类。ProgressBar 控

件一般在应用程序执行诸如复制文件或打印文档等任务时使用。若是没有视觉提示，应用程

序的用户可能会认为应用程序不响应。经过在应用程序中使用 ProgressBar，能够警告用户应

用程序正在执行冗长的任务且应用程序仍在响应。

15 C#从入门到精通

Maximum 和 Minimum 属性定义了两个值的范围用以表现任务的进度。Minimum 属性一般

设置为值 0，Maximum 属性一般设置为指示任务完成的值。例如，若要正确显示复制一组

文件时的进度，Maximum 属性应设置成要复制的文件的总数。

Value 属性表示应用程序在完成操做的过程当中的进度。ProgressBar 显示的值仅仅是近似于

Value 属性的当前值。根据 ProgressBar 的大小，Value 属性肯定什么时候显示下一个块或增长

栏大小。

除了直接更改 Value 属性以外还有许多方式能够修改由 ProgressBar 显示的值。可使

用 Step 属性指定一个特定值用以逐次递增 Value 属性的值，而后调用 PerformStep 方法来

使该值递增。若要更改增量值，可使用 Increment 方法并指定一个用来递增 Value 属性的

值。

16 C#控件查询手册 王牌2

网页显示控件

WebBrowser 控件

使用户能够在窗体内导航网页。

使用户能够在窗体中导航网页。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class WebBrowser : WebBrowserBase

备注

使用 WebBrowser 控件能够在 Windows 窗体应用程序中承载网页以及支持浏览器的

其余文档。例如，可使用 WebBrowser 控件在应用程序中提供基于 HTML 的集成用户帮

助或 Web 浏览功能。此外，还可使用 WebBrowser 控件向 Windows 窗体客户端应用程

序添加基于 Web 的现有控件。

WebBrowser 控件不能由部分受信任的代码使用。有关更多信息，请参见经过部分受信

任的代码使用库。

WebBrowser 控件具备多个与导航相关的属性、方法和事件。使用下面的成员能够将控

件导航到特定 URL、在导航历史记录列表中向后和向前移动，还能够加载当前用户的主页

和搜索页：

Url

Navigate

GoBack

GoForward

GoHome

GoSearch

若是导航不成功，则显示一页指示出现的问题。使用这些成员中的任何一个进行导航都

会致使在导航的不一样阶段发生 Navigating、Navigated 和 DocumentCompleted 事件。

使用这些成员和其余成员（如 Stop 和 Refresh 方法）能够在应用程序中实现与 Internet

Explorer 中的用户界面控件相似的用户界面控件。即便不但愿在窗体上显示 WebBrowser 控

件，某些成员也十分有用。例如，可使用 Print 方法打印网页的最新版本，而不向用户显

示该页。

17 C#从入门到精通

使用 WebBrowser 控件还能够显示在应用程序中建立的内容或从数据库或资源文件检

索的内容。使用 DocumentText 或 DocumentStream 属性，以字符串或数据流的形式获取或

设置当前文档的内容。

还能够经过 Document 属性操做网页的内容，该属性包含一个 HtmlDocument 对象，向

当前页提供对 HTML 文档对象模型 (DOM) 的托管访问。该属性与 ObjectForScripting 属

性组合使用时，对在应用程序代码与网页中的动态 HTML (DHTML) 代码之间实现双向通讯

十分有用，使用它能够在单个用户界面中组合基于 Web 的控件和 Windows 窗体控件。在

应用程序中可使用 Document 属性调用脚本代码方法。脚本代码能够经过 window.external

对象访问应用程序，该对象是用于主机访问的内置 DOM 对象，它映射到为

ObjectForScripting 属性指定的对象。

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE 平台说明：

要实现 .NET Compact Framework 应用程序中的 WebBrowser 的完整功能，须要用于 Pocket

PC 和 Smartphone 的 Windows Mobile 5.0 版软件。有关更多信息，请参见如何：在 .NET

Compact Framework 中使用 WebBrowser 控件。

18 C#控件查询手册 王牌2

19

从列表中选择控件

CheckedListBox 控件

显示一个可滚动的项列表，每项旁边都有一个复选框。

显示一个 ListBox，其中在每项的左边显示一个复选框。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class CheckedListBox : ListBox

备注

该控件提供一个项列表，用户可使用键盘或控件右侧的滚动条定位该列表。用户能够

在一项或多项旁边放置选中标记，而且能够经过 CheckedListBox.CheckedItemCollection 和

CheckedListBox.CheckedIndexCollection 浏览选中项。

若要在运行时向列表添加对象，请用 AddRange 方法分配一个对象引用数组。而后，列

表显示每一个对象的默认字符串值。能够用 Add 方法向列表添加单个项。

CheckedListBox 对象经过 CheckState 枚举支持三种状态：Checked、Indeterminate 和

Unchecked。必须在代码中设置 Indeterminate 状态，由于 CheckedListBox 的用户界面未提

供这样操做的机制。

若是 UseTabStops 为 true，CheckedListBox 将在某项的文本中识别并扩展制表符，从

而建立列。可是，制表位已预设，没法进行更改。

CheckedListBox 类支持如下三种索引集合：

集合 封装类

CheckedListBox 控件中包含的全部项。 CheckedListBox.ObjectCollection

选中项（包括处于不肯定状态的项），它

是 CheckedListBox 控件中所包含项的子集。

CheckedListBox.CheckedItemCollection

选中的索引，它是项集合中索引的子集。

这些索引指定处于选中状态或不肯定状态的

项。

CheckedListBox.CheckedIndexCollection C#从入门到精通

20

下面三个表是 CheckedListBox 类支持的三个索引集合的示例。

第一个表提供控件中项（控件中包含的全部项）的索引集合的示例。

索引 项 复选状态

0 对象 1 Unchecked

1 对象 2 Checked

2 对象 3 Unchecked

3 对象 4 Indeterminate

4 对象 5 Checked

第二个表提供选中项的索引集合的示例。

索引 项

0 对象 2

1 对象 4

2 对象 5

第三个表提供选中项的索引的索引集合示例。

索引 项的索引

0 1

1 3

2 4

注意 不能将数据绑定到 CheckedListBox。请改用 ComboBox 或 ListBox 绑定数据。

有关更多信息，请参见如何：将 Windows 窗体 ComboBox 控件或 ListBox 控件绑定到数

据。

ComboBox 控件

显示一个下拉式项列表。

表示 Windows 组合框控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）C#控件查询手册 王牌2

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class ComboBox : ListControl

备注

ComboBox 显示与一个 ListBox 组合的文本框编辑字段，使用户能够从列表中选择项，

也能够输入新文本。ComboBox 的默认行为是显示一个编辑字段，该字段具备一个隐藏的下

拉列表。DropDownStyle 属性肯定要显示的组合框的样式。能够输入一个值，该值提供如下

功能：简单的下拉列表（始终显示列表）、下拉列表框（文本部分不可编辑，而且必须选择

一个箭头才能查看下拉列表框）或默认下拉列表框（文本部分可编辑，而且用户必须按箭头

键才能查看列表）。若要显示用户不能编辑的列表，请使用 ListBox 控件。

若要在运行时向列表添加对象，请用 AddRange 方法分配一个对象引用数组。而后，列

表显示每一个对象的默认字符串值。能够用 Add 方法添加单个对象。

除了显示和选择功能外，ComboBox 还提供一些功能，使您得以有效地将项添加到

ComboBox 中以及在列表的项内查找文本。使用 BeginUpdate 和 EndUpdate 方法，能够将

大量项添加到 ComboBox 中，而无需在每次将一个项添加到列表中时都从新绘制该控件。

FindString 和 FindStringExact 方法使您得以在列表中搜索包含特定搜索字符串的项。

可使用这些属性管理列表中当前选定的项，使用 Text 属性指定编辑字段中显示的字

符串，使用 SelectedIndex 属性获取或设置当前项，以及使用 SelectedItem 属性获取或设置

对对象的引用。

DomainUpDown 控件

显示用户可用向上和向下按钮滚动的文本项列表。

表示显示字符串值的 Windows 数字显示框（也称为 up-down 控件）。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class DomainUpDown : UpDownBase

备注

DomainUpDown 控件显示单个字符串值，该值是经过单击控件的向上或向下按钮从

Object 集合中选定的。除非 ReadOnly 属性设置为 true，不然用户也能够在控件中输入文本

21 C#从入门到精通

（键入的字符串必须匹配集合中的某项才能被接受）。选中某项时，该对象将转换为一个字

符串值，以即可显示在数字显示框中。

若要建立要在 DomainUpDown 控件中显示的对象的集合，能够经过使用 Add 和

Remove 方法分别添加或移除这些项。这可在事件处理程序（如按钮的 Click 事件）中调用。

经过 Sorted 属性设置为 true，可按字母顺序对对象集合进行排序。当 Wrap 属性设置为 true

时，若是滚动超过了集合中最后一个或第一个对象，列表将分别从第一个或最后一个对象重

新开始，但看起来是在连续的列表中滚动。

在代码中或经过单击向上或向下按钮调用 UpButton 或 DownButton 方法时，将调用

UpdateEditText 来用新字符串更新该控件。若是 UserEdit 设置为 true，则在更新该控件的

文本显示以前，该字符串要与集合中的一个值匹配。

ListBox 控件

显示一个文本项和图形项（图标）列表。

表示用于显示项列表的 Windows 控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class ListBox : ListControl

备注

ListBox 控件使您得以向用户显示一列项，用户可经过单击选择这些项。ListBox 控件可

使用 SelectionMode 属性提供单项选择或多重选择。ListBox 还提供 MultiColumn 属性，以

启用按多列显示项而不是项的垂直列表。这样，控件即可以显示更多可见项，用户再也不须要

滚动到某项进行查看。

一般，Windows 处理绘制在 ListBox 中显示的项的任务。您可使用 DrawMode 属性

并处理 MeasureItem 和 DrawItem 事件，以重写 Windows 所提供的自动绘制，本身对项进

行绘制。可使用全部者描述的 ListBox 控件显示高度可变的项、图像或者为列表中每一个项

的文本显示不一样的颜色或字体。HorizontalExtent 属性、GetItemHeight 和 GetItemRectangle

也能够帮助您绘制本身的项。

除了显示和选择功能外，ListBox 还提供一些功能，使您得以有效地将项添加到 ListBox

中以及在列表的项内查找文本。BeginUpdate 和 EndUpdate 方法使您得以将大量项添加到

ListBox 中，而没必要每次将一个项添加到列表中时都从新绘制该控件。FindString 和

FindStringExact 方法使您得以在列表中搜索包含特定搜索字符串的项。

Items、SelectedItems 和 SelectedIndices 属性提供对 ListBox 所使用的三个集合的访问。下

22 C#控件查询手册 王牌2

23

表概述 ListBox 使用的三个集合及其在控件内的用途。

集合类 在 ListBox 内使用

ListBox.ObjectCollection 包括 ListBox 控件中包含的全部项。

ListBox.SelectedObjectCollection 包含选定项的集合，该集合是包含在 ListBox 控件

中的项的子集。

ListBox.SelectedIndexCollection 包含选定索引的集合，该集合是

ListBox.ObjectCollection 的索引的子集。这些索引指定选

定的项。

下面的三个示例阐释 ListBox 类支持的三个索引集合。

下表提供了一个示例，演示 ListBox.ObjectCollection 如何存储 ListBox 的项以及它们

在示例 ListBox 控件中的选择状态。

索引 项 ListBox 中的选择状态

0 object1 未选定

1 object2 已选定

2 object3 未选定

3 object4 已选定

4 object5 已选定

根据上表中显示的 ListBox.ObjectCollection，此表显示 ListBox.SelectedObjectCollection

的显示方式。

索引 项

0 object2

1 object4

2 object5

根据上表中显示的 ListBox.ObjectCollection，此表显示 ListBox.SelectedIndexCollection

的显示方式。

索引 项的索引

0 1 C#从入门到精通

24

1 3

2 4

ListBox.ObjectCollection 类的 Add 方法使您得以将项添加到 ListBox 中。当向

ListBox 添加成员时，Add 方法可接受任何对象。当向 ListBox 中添加对象时，该控件使用

在该对象的 ToString 方法中定义的文本，除非在 DisplayMember 属性中指定了该对象内的

成员名。除了使用 ListBox.ObjectCollection 类的 Add 方法添加项外，还可使用

ListControl 类的 DataSource 属性添加项。

ListView 控件

在四个不一样视图之一中显示项。这些视图包括纯文本视图、带有小图标的文本视图、带

有大图标的文本视图和详细信息视图。

表示 Windows 列表视图控件，该控件显示可用四种不一样视图之一显示的项集合。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class ListView : Control

备注

ListView 控件容许您显示项列表，这些项带有项文本和图标（可选）来标识项的类型。

例如，Windows 资源管理器的文件列表就与 ListView 控件的外观类似。它显示树中当前选

定的文件和文件夹的列表。每一个文件和文件夹都显示一个与之相关的图标，以帮助标识文件

或文件夹的类型。ListViewItem 类表示 ListView 控件中的项。列表中显示的项能够用五种

不一样视图之一显示。这些项能够显示为大图标、小图标，也能够在垂直列表中显示为小图标。

这些项也能够具备子项，子项包含与父项相关的信息。详细信息视图容许您在网格中显示项

及其子项，并经过列标头标识要在子项中显示的信息。平铺视图的应用范围有必定的限制（如

下所述），它容许以相似贴瓷砖的方式显示项及其子项，每块“瓷砖”（平铺单元）包含一个

大图标以及图标旁的文字信息。ListView 支持单选和多选。多重选择功能使用户能够按照与

ListBox 控件类似的方式从项列表中进行选择。另外，用户还能够激活选定项来执行任务。

例如，可使用 ListView 控件显示应用程序能够打开并使用的文件的列表。用户能够选择

要打开的文件，而后双击它们来激活项，并在应用程序中打开文件。ListView 也可使用

CheckBoxes 属性显示复选框，以使用户能够选中要对其执行操做的项。能够用各类方式来

使用 ListView 控件。控件可用于显示来自应用程序、数据库或文本文件的信息。ListView 也C#控件查询手册 王牌2

25

可用于获取来自用户的信息，例如选择一组要处理的文件。

ListView 提供了大量可灵活设置外观和行为的属性。View 属性容许您更改项的显示方

式。LargeImageList、SmallImageList 和 StateImageList 属性容许您指定包含为项显示的图像

的 ImageList 对象；而且，就 StateImageList 属性而言，当 CheckBoxes 属性设置为 true 时，

它容许您指定所显示的复选框。要肯定选中了哪些项，可以使用 CheckedItems 属性来访问

ListView.CheckedListViewItemCollection 集合。 Columns 属性容许访问

ListView.ColumnHeaderCollection，它存储了当控件的 View 属性设置为 Details 时显示的列

标头。经过 Items 属性，能够在 ListView 中添加和移除项。Items 属性容许您访问控件的

ListView.ListViewItemCollection，它提供在控件中操做项的方法。若是须要容许用户编辑项

的文本，可以使用 LabelEdit 属性。当控件包含大量的项时，用户在通过排序的列表中查看这

些项一般会更加容易。您可使用 Sorting 属性按字母顺序对项进行排序。您也能够对

ListView 控件的外观进行全面的自定义。为实现此目的，可将 OwnerDraw 属性设置为 true，

并处理如下的一个或多个事件：DrawItem、DrawSubItem 和 DrawColumnHeader。

当 ListView 控件的 View 属性设置为 Details 时，将使用该控件的许多属性。

AllowColumnReorder 属性容许 ListView 控件的用户在运行时从新配置列的顺序。

FullRowSelect 属性容许选择项及其子项（而不只仅是项）。要在详细资料视图中显示网格线

以标识 ListView 中的项及其子项的边界，可以使用 GridLines 属性。HeaderStyle 属性容许您

指定要显示的列标头的类型。

除了可用于 ListView 控件的许多属性外，应用程序还可使用方法和事件来为

ListView 提供附加功能。经过 BeginUpdate 和 EndUpdate 方法，可在每次添加项时防止控

件进行从新绘制，从而在向 ListView 添加多个项时改善性能。若是 ListView 控件显示的是

项和子项，您也许会须要提供用户用鼠标右键单击子项时的功能。要肯定其子项被单击的项，

可以使用 GetItemAt 方法。在用户编辑项后对它们执行验证时，您也许须要向用户显示要更改

的特定项。能够调用 EnsureVisible 方法来确保特定项位于控件的可视区域中。

若是 LabelEdit 属性设置为 true，则能够执行以下的相似任务：经过为 BeforeLabelEdit

和 AfterLabelEdit 事件建立事件处理程序，在文本更改先后对所编辑的文本进行验证。要执

行打开文件或显示对话框来编辑 ListView 中显示的项这样的任务，能够为 ItemActivate 事

件建立事件处理程序。若是容许在用户单击列标头时对 ListView 中的项进行排序，则能够

为 ColumnClick 事件建立事件处理程序以执行排序操做。当 CheckBoxes 属性设置为 true

时，您能够经过处理 ItemCheck 事件来肯定项的选中状态什么时候发生更改。

还可使用 BackgroundImage 属性设置 ListView 的背景图像。为了正确显示 ListView

控件的背景图像，您的应用程序必须对其 Main 方法应用 STAThreadAttribute。此外，若是

带有背景图像的 ListView 控件寄宿在 Internet Explorer 中，请在应用程序的清单文件中将

comctl32.dll 6.0 版指定为依赖程序集，确保背景图像可以正确显示。

Windows XP 和 Windows Server 2003 提供了三种功能，以便在您的应用程序调用

Application.EnableVisualStyles 方法时加强 ListView 控件：平铺视图、分组和插入标记。

平铺视图经过在大图标旁边显示项及子项的文本，同时兼顾了图像和文字信息。经过将

View 属性设置为 View.Tile 可启用此行为。

分组功能容许您以可视化形式将项分组到相关类别之中。若要启用此功能，可以使用C#从入门到精通

26

Groups 属性将 ListViewGroup 对象添加到 ListView 控件。若要临时禁用此功能，请将

ShowGroups 属性设置为 false。

插入标记功能经过指示放置位置，为利用拖放操做调整项的位置提供了视觉反馈信息。

使用经过 InsertionMark 属性检索到的 ListViewInsertionMark 对象显示插入标记。

这些功能仅能在 Windows XP 和 Windows Server 2003 下使用。对于较早期的平台，与

这些功能相关的代码不会产生任何做用，平铺视图将显示为大图标视图，而插入标记和组则

不会显示。在某些状况下，您可能须要编写代码来肯定是否可以使用这些功能，并在它们不

可用的状况下提供相应的替代功能。提供这些功能的库与提供操做系统主题功能的库为同一

个库。若要检查此库的可用性，请调用 FeatureSupport.IsPresent(Object) 方法重载并传入

OSFeature.Themes 值。

下表显示 ListView 的某些成员以及它们可用于的视图。

ListView 成员 视图

Alignment 属性 SmallIcon 或 LargeIcon

AutoArrange 属性 SmallIcon 或 LargeIcon

AutoResizeColumn 方法 Details

Columns 属性 Details 或 Tile

DrawSubItem 事件 Details

FindItemWithText 方法 Details、List 或 Tile

FindNearestItem 方法 SmallIcon 或 LargeIcon

GetItemAt 方法 Details 或 Tile

Groups 属性 除 List 以外的全部视图

HeaderStyle 属性 Details

InsertionMark 属性 LargeIcon、SmallIcon 或 Tile

NumericUpDown 控件

显示用户可用向上和向下按钮滚动的数字列表。

表示显示数值的 Windows 数字显示框（也称做 up-down 控件）。

命名空间：System.Windows.Forms C#控件查询手册 王牌2

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class NumericUpDown : UpDownBase, ISupportInitialize

备注

一个包含单个数值的 NumericUpDown 控件，经过单击该控件的向上或向下按钮可以使该

数值递增或递减。若是未将 ReadOnly 属性设置为 true，则用户也可输入一个值。

可经过设置 DecimalPlaces、Hexadecimal 或 ThousandsSeparator 属性来设置数字的显示

格式。若要在控件中显示十六进制值，请将 Hexadecimal 属性设置为 true。若要在适当的时

候显示十进制数的千分隔符，请将 ThousandsSeparator 属性设置为 true。若要指定小数点后

显示的位数，请将 DecimalPlaces 属性设置为要显示的小数位数。

若要指定控件容许值的范围，请设置 Minimum 和 Maximum 属性。设置 Increment 值，

以指定在用户单击向上或向下箭头按钮时将向 Value 属性递增或从其递减的值。您能够经过

设置 Accelerations 属性，提升用户连续按向上或向下箭头时该控件在数字间移动的速度。

当调用 UpButton 或 DownButton 方法时，不管是用代码仍是经过单击向上或向下箭头

键，都会对新值进行验证，并且会以适当的格式用新值对控件进行更新。具体而言，若是

UserEdit 属性设置为 true，则在验证或更新该值以前，将调用 ParseEditText 方法。而后，

验证该值是否在 Minimum 和 Maximum 两个值之间，并调用 UpdateEditText 方法。

TreeView 控件

显示一个节点对象的分层集合，这些节点对象由带有可选复选框或图标的文本组成。

显示标记项的分层集合，每一个标记项用一个 TreeNode 来表示。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class TreeView : Control

备注

Nodes 集合包含分配给 TreeView 控件的全部 TreeNode 对象。此集合中的树节点称做根树

节点。随后添加到根树节点上的任何树节点称做子节点。因为每一个 TreeNode 均可以包含其

27 C#从入门到精通

28

他 TreeNode 对象的集合，您可能会在循环访问集合时以为很难肯定本身在树结构中的位

置。您可使用 PathSeparator 字符串值来分析 TreeNode.FullPath 字符串，以肯定 TreeNode

标签的起始和终止位置。

能够在树节点旁显示图像，方法是将一个 ImageList 分配给 ImageList 属性，而后经过

引用 Image 在 ImageList 中的索引值来分配该 Image。使用下面的属性分配图像：

将 ImageIndex 属性设置为当树节点未选定时所显示的 Image 的索引值。

将 SelectedImageIndex 属性设置为当树节点被选定时要显示的 Image 的索引值。

ImageIndex 和 SelectedImageIndex 属性值所引用的图像是全部分配给 Nodes 集合的

树节点显示的默认图像。每一个树节点均可以经过设置 TreeNode.ImageIndex 和

TreeNode.SelectedImageIndex 属性来取代默认的图像。

树节点能够展开，以显示下一级子树节点。用户能够在 TreeNode 旁显示加号 (+) 按钮

时经过单击加号 (+) 按钮来展开 TreeNode，或者能够经过调用 TreeNode.Expand 方法来展

开 TreeNode。若要展开 Nodes 集合中的全部子树节点级别，请调用 ExpandAll 方法。若要

折叠子 TreeNode 级别，能够调用 TreeNode.Collapse 方法，也能够在 TreeNode 旁显示减

号 (-) 按钮时按减号 (-) 按钮。还能够经过调用 TreeNode.Toggle 方法在展开和折叠状态之

间切换。

树节点能够选择性地显示复选框。若要显示复选框，请将 TreeView 的 CheckBoxes 属

性设置为 true。对于处于选中状态的树节点，Checked 属性设置为 true。

经过设置 TreeView 控件的一些显示和样式属性，能够更改此控件的外观。若是将

ShowPlusMinus 设置为 true，则会分别在每一个可展开或折叠的 TreeNode 旁显示加号或减号

按钮。若是将 ShowRootLines 属性设置为 true，TreeView 则会显示联接全部根树节点之间

的连线。经过将 ShowLines 属性设置为 true，能够显示子树节点与其根节点之间的连线。

若是将 HotTracking 属性设置为 true，那么当鼠标指针移过树节点标签时，树节点标签的外

观将发生变化。若是启用热跟踪，树节点标签将具备超连接的外观。也能够彻底自定义

TreeView 控件的外观。若要执行此操做，请将 DrawMode 属性设置为

TreeViewDrawMode.Normal 之外的值并处理 DrawNode 事件。C#控件查询手册 王牌2

图形显示控件

PictureBox 控件

在一个框架中显示图形文件（如位图和图标）。

表示用于显示图像的 Windows 图片框控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class PictureBox : Control, ISupportInitialize

备注

一般使用 PictureBox 来显示位图、元文件、图标、JPEG、GIF 或 PNG 文件中的图形。

在设计时或运行时将 Image 属性设置为要显示的 Image 。也能够经过设置

ImageLocation 属性指定图像，而后使用 Load 方法同步加载图像或使用 LoadAsync 方法异

步加载图像。SizeMode 属性（设置为 PictureBoxSizeMode 枚举中的值）控制图像在显示区

域中的剪裁和定位。能够在运行时使用 ClientSize 属性来更改显示区域的大小。

默认状况下，PictureBox 控件在显示时没有任何边框。即便图片框不包含任何图像，仍

可使用 BorderStyle 属性提供一个标准或三维的边框，以便使图片框与窗体的其他部分区

分。PictureBox 不是可选择的控件，这意味着该控件不能接收输入焦点。

29 C#从入门到精通

图形存储控件

ImageList 控件

充当图像储存库。ImageList 控件和及其包含的图像能够在不一样的应用程序中重用。

提供管理 Image 对象集合的方法。没法继承此类。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class ImageList : Component

备注

ImageList 一般由其余控件使用，如 ListView、TreeView 或 ToolBar。能够将位图、图

标添加到 ImageList 中，且其余控件可以在须要时使用这些图像。

ImageList 使用句柄管理图像列表。直到在图像列表上执行某些操做（包括获取 Count、

获取 Handle 和调用 Draw）时才建立 Handle。

30 C#控件查询手册 王牌2

值的设置控件

CheckBox 控件

显示一个复选框和一个文本标签。一般用来设置选项。

表示 Windows CheckBox。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class CheckBox : ButtonBase

备注

使用 CheckBox 可为用户提供一项选择，如“真/假”或“是/否”。该 CheckBox 控件能够

显示一个图像或文本，或二者都显示。

CheckBox 和 RadioButton 控件拥有一个类似的功能：容许用户从选项列表中进行选择。

CheckBox 控件容许用户选择一组选项。与之相反，RadioButton 控件容许用户从互相排斥的

选项中进行选择。

Appearance 属性肯定 CheckBox 显示为常见的 CheckBox 仍是显示为按钮。

ThreeState 属性肯定该控件是支持两种状态仍是三种状态。使用 Checked 属性能够获取或

设置具备两种状态的 CheckBox 控件的值，而使用 CheckState 属性能够获取或设置具备三

种状态的 CheckBox 控件的值。

FlatStyle 属性肯定控件的样式和外观。若是 FlatStyle 属性设置为 FlatStyle.System，则控件

的外观由用户的操做系统肯定。

下面描述一种不肯定状态：有一个用于肯定 RichTextBox 中选定的文本是否为粗体的

CheckBox。选择文本时，您能够单击 CheckBox 以将选定文本变成粗体。一样，选择一些文

本时，CheckBox 将显示选定的文本是否为粗体。若是选定的文本包含粗体和常规文本，则

CheckBox 将处于不肯定状态。

CheckedListBox 控件

显示一个可滚动的项列表，每项旁边都有一个复选框。

31 C#从入门到精通

RadioButton 控件

显示一个可打开或关闭的按钮。

当与其余 RadioButton 控件成对出现时，使用户可以从一组选项中选择一个选项。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class RadioButton : ButtonBase

备注

RadioButton 控件能够显示文本、Image 或同时显示二者。

当用户选择一个组内的一个选项按钮（也称做单选按钮）时，其余选项按钮自动清除。

给定容器（如 Form）中的全部 RadioButton 控件构成一个组。若要在一个窗体上建立多个

组，请将每一个组放在它本身的容器（例如 GroupBox 或 Panel 控件）中。

RadioButton 和 CheckBox 控件的功能类似：它们提供用户能够选择或清除的选项。不

同之处在于，能够同时选定多个 CheckBox 控件，而选项按钮倒是互相排斥的。

使用 Checked 属性能够获取或设置 RadioButton 的状态。经过设置 Appearance 属性，

能够将选项按钮的外观显示为切换式按钮或标准选项按钮。

TrackBar 控件

容许用户经过沿标尺移动“滚动块”来设置标尺上的值。

表示一个标准的 Windows 跟踪条。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class TrackBar : Control, ISupportInitialize

备注

TrackBar 是相似于 ScrollBar 控件的可滚动控件。能够经过如下方式配置跟踪条的

Value 属性值滚动的范围：经过设置 Minimum 属性指定该范围的下限，设置 Maximum 属

32 C#控件查询手册 王牌2

性指定该范围的上限。

LargeChange 属性定义在滚动框的任一侧单击鼠标时对 Value 属性进行增减的量。跟踪条

能够水平显示或垂直显示。

可使用此控件输入经过 Value 属性获取的数值型数据。能够在一个控件中显示此数值

型数据，或者在代码中使用此数据。

33 C#从入门到精通

34

数据的设置控件

DateTimePicker 控件

显示一个图形日历以容许用户选择日期或时间。

表示一个 Windows 控件，该控件用来让用户选择日期和时间并以指定的格式显示此日

期和时间。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class DateTimePicker : Control

备注

DateTimePicker 控件用来让用户选择日期和时间，并以指定的格式显示此日期和时间。

经过设置 MinDate 和 MaxDate 属性，能够限制可选择的日期和时间。

经过设置 CalendarForeColor 、 CalendarFont 、 CalendarTitleBackColor 、

CalendarTitleForeColor、CalendarTrailingForeColor 和 CalendarMonthBackground 属性，能够

更改控件日历部分的外观。

Format 属性设置控件的 DateTimePickerFormat 。默认日期 Format 为

DateTimePickerFormat.Long。若是 Format 属性设置为 DateTimePickerFormat.Custom，能够

经过设置 CustomFormat 属性并生成自定义格式字符串来建立本身的格式化样式。自定义格

式字符串能够是自定义字段字符和其余字符的组合。例如，经过将 CustomFormat 属性设置

为“MMMM dd, yyyy - dddd”，能够将日期显示为“June 01, 2001 - Friday”。有关更多信息，请

参见日期与时间格式字符串。

若要使用数值调节钮控件（也称为 up-down 控件）调整日期/时间值，请将 ShowUpDown

属性设置为 true。日历控件被选定后将不下拉。能够经过分别选择各元素并使用向上和向下

按钮更改值来调整日期和时间。

若是须要自定义日期格式设置（例如，选择限制为只使用一个日期），您能够考虑使用

DateTimePicker 控件，而不是 MonthCalendar。使用 DateTimePicker 可限制对日期/时间值

进行大量数据验证的须要。C#控件查询手册 王牌2

MonthCalendar 控件

显示一个图形日历以容许用户选择日期范围。

表示一个 Windows 控件，该控件使用户可以使用可视月历显示来选择日期。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class MonthCalendar : Control

备注

MonthCalendar 控件容许用户使用可视显示来选择日期。经过设置 MinDate 和

MaxDate 属性，能够限制可选择的日期和时间。

经过设置 ForeColor 、 Font 、 TitleBackColor 、 TitleForeColor 、 TrailingForeColor 和

BackColor 属性，能够更改控件日历部分的外观。

MonthCalendar 控件由操做系统绘制，所以决不会引起 Paint 事件。若是须要为

MonthCalendar 控件提供自定义的外观，则应重写 OnPrint 方法，调用 OnPrint 的基实现，

而后再执行自定义绘图。

若是须要将自定义日期格式和选择限制为只用于一个日期，您能够考虑使用

DateTimePicker 控件，而不是 MonthCalendar。使用 DateTimePicker 可避免许多须要验证日

期／时间值的状况。

35 C#从入门到精通

对话框控件

ColorDialog 控件

显示容许用户设置界面元素的颜色的颜色选择器对话框。

表示一个通用对话框，该对话框显示可用的颜色以及容许用户定义自定义颜色的控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public class ColorDialog : CommonDialog

备注

必须调用继承的成员 ShowDialog 才能建立此特定的通用对话框。可重写 HookProc 以

实现特定的对话框挂钩功能。使用 Color 可检索用户选定的颜色。

在建立 ColorDialog 的实例时，一些读/写属性被设置为初始值。有关这些值的列表，请

参见 ColorDialog 构造函数。

FontDialog 控件

显示容许用户设置字体及其属性的对话框。

提示用户从本地计算机上安装的字体中选择一种字体。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public class FontDialog : CommonDialog

备注

必须调用继承的成员 ShowDialog 才能建立此特定的通用对话框。可重写 HookProc 以

实现特定的对话框挂钩功能。

在建立 FontDialog 的实例时，一些读/写属性被设置为初始值。

36 C#控件查询手册 王牌2

OpenFileDialog 控件

显示容许用户定位文件和选择文件的对话框。提示用户打开文件。没法继承此类。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class OpenFileDialog : FileDialog

备注

使用此类可检查某个文件是否存在并打开该文件。ShowReadOnly 属性肯定是否在对话

框中显示只读复选框。ReadOnlyChecked 属性指示是否选中只读复选框。

此类的大多数功能均可以在 FileDialog 类中找到。

若是要使用户可以选择文件夹而不是文件，请改用 FolderBrowserDialog。

PrintDialog 控件

显示容许用户选择打印机并设置其属性的对话框。容许用户选择一台打印机并选择文档

中要打印的部分。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class PrintDialog : CommonDialog

备注

建立 PrintDialog 的实例时，读/写属性将被设置为初始值。有关这些值的列表，请参见

PrintDialog 构造函数。

PrintPreviewDialog 控件

显示一个对话框，该对话框显示 PrintDocument 组件在打印出来后的外观。

表示包含 PrintPreviewControl 的对话框窗体。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

37 C#从入门到精通

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class PrintPreviewDialog : Form

备注

在建立 PrintPreviewDialog 类的实例时，一些读／写属性被设置为初始值。有关这些值

的列表，请参见 PrintPreviewDialog 构造函数。

FolderBrowserDialog 控件

显示用来浏览、建立以及最终选择文件夹的对话框，提示用户选择文件夹。没法继承此

类。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class FolderBrowserDialog : CommonDialog

备注

此类提供一种方法，它提示用户浏览、建立并最终选择一个文件夹。若是只容许用户选

择文件夹而非文件，则可以使用此类。文件夹的浏览经过树控件完成。只能选择文件系统中的

文件夹；不能选择虚拟文件夹。

一般在建立新 FolderBrowserDialog 后，将 RootFolder 设置为开始浏览的位置。或者，

可将 SelectedPath 设置为最初选定的 RootFolder 子文件夹的绝对路径。也能够选择设置

Description 属性为用户提供附加说明。最后，调用 ShowDialog 方法将对话框显示给用户。

若是该对话框关闭而且 ShowDialog 显示的对话框为 DialogResult.OK，SelectedPath 则是一

个包含选定文件夹路径的字符串。

若是用户可经过 “ 新建文件夹 ” 按钮建立新文件夹，则可对控件使用

ShowNewFolderButton 属性。

FolderBrowserDialog 是有模式对话框，所以，在显示时，它会阻止应用程序剩余部分的

运行，直到用户选定了文件夹。当对话框有模式显示时，不能进行任何输入（经过键盘或鼠

标单击），对对话框上的对象的输入除外。在对调用程序进行输入以前，程序必须隐藏或关

闭对话框（一般是响应某一用户操做）。

SaveFileDialog 控件

显示容许用户保存文件的对话框。

38 C#控件查询手册 王牌2

提示用户选择文件的保存位置。没法继承此类。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class SaveFileDialog : FileDialog

备注

此类能够打开和改写现有文件，也能够建立新文件。

此类的大多数功能均可以在 FileDialog 类中找到。

Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows CE 平台说明：

在 Pocket PC 上，若是不指定文件的扩展名，控件会附加对话框中选定类型的扩展名。在

Windows CE 上，控件不附加扩展名。全部平台都支持 FilterIndex 属性，该属性返回选定扩

展名筛选器的索引。

39 C#从入门到精通

菜单控件

MenuStrip 控件

建立自定义菜单

提供窗体的菜单系统。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class MenuStrip : ToolStrip

备注

MenuStrip 控件表示窗体菜单结构的容器。您能够将 ToolStripMenuItem 对象添加到表

示菜单结构中各菜单命令的 MenuStrip 中。每一个 ToolStripMenuItem 能够成为应用程序的命

令或其余子菜单项的父菜单。

MenuStrip 是 ToolStripMenuItem 、 ToolStripComboBox 、 ToolStripSeparator 和

ToolStripTextBox 对象的容器。

虽然 MenuStrip 对之前版本的 MainMenu 控件的功能进行了替换和添加，可是考虑到

向后兼容性和未来的使用（若是您选择），仍然保留了 MainMenu。

ContextMenuStrip 控件

建立自定义上下文菜单。

表示快捷菜单。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class ContextMenuStrip : ToolStripDropDownMenu

40 C#控件查询手册 王牌2

41

备注

ContextMenuStrip 类表示快捷菜单，这些快捷菜单在用户在窗体中的控件或特定区域上

单击鼠标右键时显示。快捷菜单一般用于组合来自窗体的一个 MenuStrip 的不一样菜单项，便

于用户在给定应用程序上下文中使用。例如，可使用分配给 TextBox 控件的快捷菜单提

供菜单项，以便更改文本字体，在控件中查找文本或实现复制和粘贴文本的剪贴版功能。还

能够在快捷菜单中显示不位于 MenuStrip 中的新的 ToolStripMenuItem 对象，从而提供与特

定状况有关且不适合在 MenuStrip 中显示的命令。

当用户在控件或窗体自己上单击鼠标右键时，一般会显示快捷菜单。许多可视控件（以

及 Form 自己）都有一个 Control.ContextMenuStrip 属性，该属性将 ContextMenuStrip 类绑

定到显示快捷菜单的控件。多个控件可以使用一个 ContextMenuStrip。

将 ToolStripDropDownMenu.ShowCheckMargin 属性设置为 true 可 向

ToolStripMenuItem 的左侧添加用以容纳选中标记的空间，选中标记显示是否启用或选择了

该菜单项。ToolStripDropDownMenu.ShowImageMargin 属性默认被设置为 true。使用

ToolStripMenuItem 左侧的此空间能够为菜单项显示一个图像。

ContextMenuStrip 是 ToolStripMenuItem、ToolStripComboBox、ToolStripSeparator 和

ToolStripTextBox 对象的容器。

虽然 ContextMenuStrip 对之前版本的 ContextMenu 控件的功能进行了替换和添加，但

是考虑到向后兼容性和未来的使用（若是的确须要），仍然保留了 ContextMenu。C#从入门到精通

命令控件

Button 控件

启动、中止或中断进程。

表示 Windows 按钮控件。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class Button : ButtonBase, IButtonControl

备注

若是某个 Button 具备焦点，则可使用鼠标、Enter 键或空格键单击该按钮。

设置 Form 的 AcceptButton 或 CancelButton 属性，使用户可以经过按 Enter 或 Esc

键来单击按钮（即便该按钮没有焦点）。这使该窗体具备对话框的行为。

当使用 ShowDialog 方法显示一个窗体时，可使用按钮的 DialogResult 属性指定

ShowDialog 的返回值。

能够更改按钮的外观。例如，要使它显示为 Web 风格的平面外观，请将 FlatStyle 属

性设置为 FlatStyle.Flat。FlatStyle 属性还可设置为 FlatStyle.Popup；当鼠标指针通过该按钮

时，它再也不是平面外观，而是将呈现标准的 Windows 按钮外观。

LinkLabel 控件

将文本显示为 Web 样式的连接，并在用户单击该特殊文本时触发事件。该文本一般是

到另外一个窗口或网站的连接。

NotifyIcon 控件

在表示正在后台运行的应用程序的任务栏的状态通知区域中显示一个图标。

指定在通知区域中建立图标的组件。没法继承此类。

42 C#控件查询手册 王牌2

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public sealed class NotifyIcon : Component

备注

通知区域中的图标是一些进程的快捷方式，这些进程在计算机后台运行，如防病毒程序

或音量控制。这些进程不会具备本身的用户界面。NotifyIcon 类提供了编写此功能的方法。

Icon 属性定义显示在通知区域中的图标。图标的弹出菜单由 ContextMenu 属性肯定。Text

属性分配工具提示文本。要在通知区域中显示图标，必须将 Visible 属性设置为 true。

ToolStrip 控件

建立工具栏，这些工具栏能够具备与 Microsoft Windows XP、Microsoft Office 或

Microsoft Internet Explorer 相似的外观，也能够具备自定义外观，能够有主题，也能够没有

主题，并支持溢出和运行时项从新排序。

为 Windows 工具栏对象提供容器。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class ToolStrip : ScrollableControl, IComponent, IDisposable

备注

在新的 Windows 窗体应用程序中可以使用 ToolStrip 及其相关的类来建立工具栏，这些

工具栏具备 Windows XP、Office、Internet Explorer 或自定义的外观和行为（它们均既能够

使用主题又能够不使用主题，均支持溢出和在运行时对项从新排序）。ToolStrip 控件也提供

丰富的设计时体验，包括就地激活和编辑、自定义布局以及共享指定的 ToolStripContainer 内

的水平空间或垂直空间。

ToolStrip 是 ToolStripButton、ToolStripComboBox、ToolStripSplitButton、ToolStripLabel、

ToolStripSeparator、ToolStripDropDownButton、ToolStripProgressBar 和 ToolStripTextBox 对

象的容器。

尽管 ToolStrip 类提供了许多可管理绘制、鼠标和键盘输入以及拖放功能的成员，可是

您可使用 ToolStripManager 类在指定的 ToolStripContainer 内联接 ToolStrip 控件，以及

将 ToolStrip 控件相互合并。经过将 ToolStripRenderer 类和 ToolStripManager 类结合使用，

能够得到对绘制样式和布局样式的更好控制和更多的自定义功能。

43 C#从入门到精通

使用 ToolStripControlHost 类能够在 ToolStrip 中承载任何其余 Windows 窗体控件。

虽然 ToolStrip 对之前版本的 ToolBar 控件的功能进行了替换和增补，可是考虑到向后

兼容性和未来的使用（若是您选择），仍然保留了 ToolBar。

44 C#控件查询手册 王牌2

用户帮助控件

HelpProvider 组件

为控件提供弹出式帮助或联机帮助。

提供控件的弹出或联机帮助。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

ublic class HelpProvider : Component, IExtenderProvider

备注

每一个 HelpProvider 实例均维护一个对关联控件的引用的集合。若要使帮助文件与

HelpProvider 关联，请设置 HelpNamespace 属性。经过调用 SetHelpNavigator 方法并提供

指定控件的 HelpNavigator 值来指定提供的帮助类型。经过调用 SetHelpKeyword 方法为帮

助提供关键字或主题。若要打开特定主题的帮助，则应以 topicName.htm 的形式传入关键字。

若要使特定的帮助字符串与控件关联，请使用 SetHelpString 方法。若是用户在控件包

含焦点时按下 F1 键，使用此方法与控件关联的字符串将显示在弹出窗口中。

若是还没有设置 HelpNamespace 属性，则必须使用 SetHelpString 方法提供帮助文本。如

果同时设置了 HelpNamespace 和帮助字符串，则基于 HelpNamespace 的帮助信息优先。

HelpProvider 在 Help 类上调用方法来提供帮助功能。

ToolTip 组件

当用户将指针停留在控件上时，提供一个弹出式窗口来显示该控件的用途的简短说明。

表示一个长方形的小弹出窗口，该窗口在用户将指针悬停在一个控件上时显示有关该控

件用途的简短说明。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

public class ToolTip : Component, IExtenderProvider

45 C#从入门到精通

46

备注

使用 ToolTip 类，您可在用户将指针放置在控件上时为用户显示提示信息。ToolTip 类

一般用来向用户提示控件的预期用途。例如，能够为接受名称的 TextBox 控件指定工具提

示文本，同时指定要键入到控件中的名称的格式。除了提供提示外，还可以使用 ToolTip 类提

供运行时状态信息。例如，当用户将指针移动到显示 Internet 链接状态的 PictureBox 控件

上时，可使用 ToolTip 类显示链接速度和线路质量数据。

ToolTip 类可在任何容器内使用。若要显式指定容器，请使用 ToolTip(IContainer) 构造

函数。单个 ToolTip 组件一般用于为单个窗体上的多个控件建立工具提示。在建立 ToolTip

以后，使用不一样的 SetToolTip 方法调用可将工具提示显示文本与每一个控件关联。而后，当

用户将指针移到控件上时，即会显示工具提示及其文本。对于同一个控件可屡次调用

SetToolTip 以更改与控件关联的文本。若要获取与控件关联的文本，请使用 GetToolTip 方

法。若要移除 ToolTip 类的某个实例的全部工具提示文本关联，请使用 RemoveAll 方法。

ToolTip 类提供了如下属性和方法以修改工具提示的默认行为和外观。

类别 关联成员

手动显示 Active, Show, Hide, ShowAlways, Popup, StopTimer

工具提示计

时

AutoPopDelay, InitialDelay, ReshowDelay, AutomaticDelay, StopTimer

内容 SetToolTip, GetToolTip, StripAmpersands, ToolTipIcon, ToolTipTitle,

RemoveAll

外观 BackColor, ForeColor, IsBalloon, OwnerDraw, UseAnimation, UseFading

若是要禁用全部工具提示文本以便不在应用程序中显示它，可使用 Active 属性。工

具提示一般由操做系统绘制，但若要自定义 ToolTip 的外观，可将 OwnerDraw 属性设置为

true 并处理 Draw 事件。

ToolTipTitle 类实现 System.ComponentModel.IExtenderProvider 接口，该接口只有一个

CanExtend 方法。工具提示在设计时扩展同一窗体上的控件，添加一个 ToolTip 属性。有关

扩展程序提供程序的更多信息，请参见扩展程序提供程序。C#控件查询手册 王牌2

分组控件

Panel 控件

将一组控件分组到未标记、可滚动的框架中。

用于对控件集合进行分组。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class Panel : ScrollableControl

备注

Panel 是一个包含其余控件的控件。可使用 Panel 来组合控件的集合，例如一组

RadioButton 控件。与其余容器控件（如 GroupBox 控件）同样，若是 Panel 控件的 Enabled

属性设置为 false，则也会禁用包含在 Panel 中的控件。

默认状况下，Panel 控件在显示时没有任何边框。能够用 BorderStyle 属性提供标准或

三维的边框，将窗面板区与窗体上的其余区域区分开。由于 Panel 控件派生于

ScrollableControl 类，因此能够用 AutoScroll 属性来启用 Panel 控件中的滚动条。当

AutoScroll 属性设置为 true 时，使用所提供的滚动条能够滚动显示 Panel 中（但不在其可

视区域内）的全部控件。

Panel 控件不显示标题。若是须要与 Panel 相似可显示标题的控件，请参见 GroupBox

控件。

GroupBox 控件

将一组控件（如单选按钮 (RadioButton)）分组到带标记、不可滚动的框架中。

表示一个 Windows 控件，该控件显示围绕一组具备可选标题的控件的框架。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

47 C#从入门到精通

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

[ComVisibleAttribute(true)]

public class GroupBox : Control

备注

GroupBox 显示围绕一组控件的框架（带或不带标题）。使用 GroupBox 对窗体上的控

件集合进行逻辑分组。组框是可用于定义控件组的容器控件。

组框的典型用途是包含 RadioButton 控件的逻辑组。若是有两个分组框，每一个分组框都

包含多个选项按钮（也称为单选按钮），每组按钮都互相排斥，则每组设置一个选项值。

经过使用 Controls 属性的 Add 方法，可将控件添加到 GroupBox。

GroupBox 不能显示滚动条。若是须要可包含滚动条的相似于 GroupBox 的控件，请参

见 Panel 控件。

TabControl 控件

提供一个选项卡式页面以有效地组织和访问已分组对象。

管理相关的选项卡页集。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class TabControl : Control

备注

TabControl 包含选项卡页，这些选项卡页由经过 TabPages 属性添加的 TabPage 对象

表示。此集合中的选项卡页的顺序反映了选项卡在控件中出现的顺序。

用户能够经过单击控件中的某一选项卡来更改当前的 TabPage。您也能够经过使用下面

的 TabControl 属性之一，以编程的方式更改当前的 TabPage：

SelectedIndex

SelectedTab

在 Microsoft .NET Framework 2.0 版 中，也可使用下面的方法之一：

SelectTab

DeselectTab

在 .NET Framework 2.0 中，能够经过处理下面的事件之一，在当前选项卡发生更改时

进行响应：

Deselecting

48 C#控件查询手册 王牌2

Deselected

Selecting

Selected

TabControl 中的选项卡是 TabControl 的一部分，但不是各个 TabPage 控件的一部分。

TabPage 类的成员（例如 ForeColor 属性）只影响选项卡页的矩形工做区，而不影响选项卡。

此外，TabPage 的 Hide 方法不会隐藏选项卡。若要隐藏选项卡，必须从 TabControl.TabPages

集合中移除 TabPage 控件。

SplitContainer 控件

提供用可移动拆分条分隔的两个面板。

表示一个由可移动条组成的控件，该可移动条将容器的显示区域分红两个大小可调的面

板。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class SplitContainer : ContainerControl

备注

您能够将控件添加到两个大小可调的面板中，并将其余 SplitContainer 控件添加到现有

SplitContainer 面板中，以建立多个大小可调的显示区域。

使用 SplitContainer 控件可分隔容器（如 Form）的显示区域，并使用户能够调整已添

加到 SplitContainer 面板中的控件的大小。当用户将鼠标指针移到拆分器上时，光标将发生

变化，以指示能够调整 SplitContainer 控件内部的控件的大小。

SplitContainer 也使设计时的控件放置更容易。例如，若要建立一个与 Windows 资源管

理器相似的窗口，可将 SplitContainer 控件添加到一个 Form 中，并将其 Dock 属性设置为

DockStyle.Fill 。同时，将 TreeView 控件添加到 Form 并将其 Dock 属性设置为

DockStyle.Fill。若要完成布局，则添加一个 ListView 控件并将其 Dock 属性设置为

DockStyle.Fill，从而使 ListView 占据 Form 上的剩余空间。在运行时，用户可使用拆分

器调整两个控件的宽度。使用 FixedPanel 属性可指定某个控件不该随 Form 或其余容器一

起调整大小。

使 用 SplitterDistance 可指定拆分器开始的时候位于窗体上的位置。使用

SplitterIncrement 可指定拆分器一次移动多少像素。SplitterIncrement 的默认值是一个像素。

使用 Panel1MinSize 和 Panel2MinSize 可指定拆分器条可以移到靠近 SplitContainer

面板外边缘的程度。面板默认的最小大小值为 25 像素。

49 C#从入门到精通

使用 Orientation 属性可指定水平方向。SplitContainer 的默认方向为垂直方向。

使用 BorderStyle 属性可指定 SplitContainer 的边框样式，并使其边框样式与添加到

SplitContainer 的控件的边框样式协调。

TableLayoutPanel 控件

表示一个面板，它能够在一个由行和列组成的网格中对其内容进行动态布局。

表示一个面板，它能够在一个由行和列组成的网格中对其内容进行动态布局。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class TableLayoutPanel : Panel, IExtenderProvider

备注

TableLayoutPanel 控件在网格中排列其内容。由于布局既能够在设计时执行，也能够在

运行时执行，因此它会随应用程序环境的更改而动态更改。这样，面板中的控件能够适当地

调整大小，从而对各类更改作出响应，如父控件的大小调整或者因为本地化带来的文本长度

的更改。

任 何 Windows 窗体控件均可以是 TableLayoutPanel 控件的子级，包括

TableLayoutPanel 的其余实例。这样，您就能够构造可以适应运行时的各类更改的复杂布局。

TableLayoutPanel 控件能够根据 RowCount、ColumnCount 和 GrowStyle 属性的值进行

扩展，以容纳新添加的控件。将 RowCount 或 ColumnCount 属性的值设置为 0，将指定

TableLayoutPanel 在相应方向上取消绑定。

当 TableLayoutPanel 控件充满子控件之后，您也能够控制扩展的方向（水平或垂直）。

默认状况下，TableLayoutPanel 控件经过添加行向下扩展。

若是但愿行和列采起与默认行为不一样的行为方式，能够经过使用 RowStyles 和

ColumnStyles 属性来控制行和列的属性。能够分别设置行或列的属性。

TableLayoutPanel 控件向其子控件添加如下属性：Cell、Column、Row、ColumnSpan 和

RowSpan。

能够经过设置子控件上的 ColumnSpan 或 RowSpan 属性，来合并 TableLayoutPanel 控

件中的单元格。

子控件的停靠行为与其余容器控件相同。

TableLayoutPanel 中子控件的锚定行为与其余容器控件的行为不一样。若是将子控件的

Anchor 属性值设置为 Left 或 Right，则将控件靠单元格左边框或由边框放置，距离边框的

距离是控件的 Margin 属性和面板的 Padding 属性之和。若是同时设置了 Left 和 Right

50 C#控件查询手册 王牌2

值，控件将根据单元格的宽度调整大小，同时考虑了 Margin 和 Padding 值。Top 和 Bottom

定锚的行为与此相似。有关更多信息，请参见如何：在 TableLayoutPanel 控件中锚定和停靠

子控件。

若是须要子控件模仿其余容器控件的默认定锚行为，能够调整 Margin 和 Padding 属

性，以使控件的边框与单元格的边框保持固定的距离。

运行时，将一个子控件的 Column 和 Row 属性值设置为 -1，将使该控件移动到

TableLayoutPanel 控件的第一个空单元格中。空单元格将按从左到右、从上到下的搜索顺序

选中。此顺序依赖于区域性，因此在从右向左 (RTL) 的布局中它将正确运行。设计时，将

这些属性设置为 -1 时，子控件不会移动。

FlowLayoutPanel 控件

表示一个沿水平或垂直方向动态排放其内容的面板。

表示一个沿着水平或垂直方向动态排放其内容的面板。

命名空间：System.Windows.Forms

程序集：System.Windows.Forms（在 system.windows.forms.dll 中）

语法

[ComVisibleAttribute(true)]

[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)]

public class FlowLayoutPanel : Panel, IExtenderProvider

备注

FlowLayoutPanel 控件沿着水平或垂直流向排列其内容。它的内容能够从一行换到下一

行或从一列换到下一列。或者，还能够对它的内容进行剪裁，而不是进行换行。

能够经过设置 FlowDirection 属性的值来指定流向。在从右向左 (RTL) 的布局中，

FlowLayoutPanel 控件会相应地反转其流向。还能够经过设置 WrapContents 属性的值来指定

是对 FlowLayoutPanel 控件的内容进行换行仍是剪裁。

任 何 Windows 窗体控件（包括 FlowLayoutPanel 的其余实例）均可以是

FlowLayoutPanel 控件的子级。使用此功能，能够构造在运行时可以根据窗体的尺寸进行相

应调整的复杂布局。*

子控件的停靠和锚定行为与其余容器控件的行为不一样。停靠和锚定行为均相对于流向中

的最大控件。有关更多信息，请参见如何：在 FlowLayoutPanel 控件中锚定和停靠子控件。

51 C#从入门到精通

音频控件

SoundPlayer 控件

播放 .wav 格式的声音文件。加载声音和播放声音能够异步进行。

控制 .wav 文件中的声音播放。

命名空间：System.Media

程序集：System（在 system.dll 中）

语法

[SerializableAttribute]

public class SoundPlayer : Component, ISerializable

备注

SoundPlayer 类提供了加载和播放 .wav 文件的简单界面。SoundPlayer 类支持从文件路

径、URL、包含 .wav 文件的 Stream 或包含 .wav 文件的嵌入资源中加载 .wav 文件。

要使用 SoundPlayer 类播放声音，请用 .wav 文件的路径配置 SoundPlayer 并调用某个

播放方法。可使用某个构造函数或经过设置 SoundLocation 或 Stream 属性来标识要播放

的 .wav 文件。能够在播放前使用某个加载方法加载文件，或者将加载推迟到调用某个播放

方法时。被配置为从 Stream 或 URL 中加载 .wav 文件的 SoundPlayer 必须在播放开始前

将 .wav 文件加载到内存中。

能够同步或异步地加载或播放 .wav 文件。若是调用同步加载或播放方法，调用线程将

一直等到方法返回，这可能会致使绘制和其余事件中断。调用异步加载或播放方法则容许调

用线程继续执行，而不会中断。有关异步方法调用的更多信息，请参见如何：在后台运行操

做。

当 SoundPlayer 加载完 .wav 文件后，它会引起 LoadCompleted 事件。能够检查事件

处理程序中的 AsyncCompletedEventArgs，肯定加载是成功仍是失败。当音频源设置为新文

件路径或 URL 时，引起 SoundLocationChanged 事件。当音频源设置为新 Stream 时，引

发 StreamChanged 事件。

52