ListBox 类.docx
《ListBox 类.docx》由会员分享，可在线阅读，更多相关《ListBox 类.docx（55页珍藏版）》请在冰点文库上搜索。
ListBox类
ListBox类
.NETFramework4.5
其他版本
此主题尚未评级 - 评价此主题
表示用于显示项列表的Windows控件。
继承层次结构
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
System.Windows.Forms.Control
System.Windows.Forms.ListControl
System.Windows.Forms.ListBox
Microsoft.VisualBasic.Compatibility.VB6.DirListBox
Microsoft.VisualBasic.Compatibility.VB6.FileListBox
System.Windows.Forms.CheckedListBox
命名空间：
System.Windows.Forms
程序集：
System.Windows.Forms（在System.Windows.Forms.dll中）
语法
C#
C++
F#
VB
声明
_
_
_
PublicClassListBox_
InheritsListControl
ListBox 类型公开以下成员。
构造函数
显示:
继承
保护
名称
说明
ListBox
初始化 ListBox 类的新实例。
页首
属性
显示:
继承
保护
名称
说明
AccessibilityObject
获取分配给该控件的 AccessibleObject。
（继承自 Control。
）
AccessibleDefaultActionDescription
获取或设置控件的默认操作说明以供具有辅助功能的客户端应用程序使用。
（继承自 Control。
）
AccessibleDescription
获取或设置辅助功能客户端应用程序使用的控件说明。
（继承自 Control。
）
AccessibleName
获取或设置辅助功能客户端应用程序所使用的控件名称。
（继承自 Control。
）
AccessibleRole
获取或设置控件的辅助性角色 （继承自 Control。
）
AllowDrop
获取或设置一个值，该值指示控件是否可以接受用户拖放到它上面的数据。
（继承自 Control。
）
AllowSelection
如果 SelectionMode 不是 F:
System.Windows.Forms.SelectionMode.None，则为 [true]；否则为 false。
获取一个值，该值指示 ListBox 当前是否启用了列表项的选择。
（重写 ListControl.AllowSelection。
）
ProtectedOverridesReadOnlyPropertyAllowSelectionAsBoolean
Anchor
获取或设置控件绑定到的容器的边缘并确定控件如何随其父级一起调整大小。
（继承自 Control。
）
AutoScrollOffset
获取或设置一个值，该值指示在 ScrollControlIntoView 中将控件滚动到何处。
（继承自 Control。
）
AutoSize
基础结构。
此属性与此类无关。
（继承自 Control。
）
BackColor
获取或设置控件的背景色。
（重写 Control.BackColor。
）
BackgroundImage
基础结构。
此属性与此类无关。
（重写 Control.BackgroundImage。
）
BackgroundImageLayout
基础结构。
按照 ImageLayout 枚举中的定义获取或设置 ListBox 的背景图像布局。
（重写 Control.BackgroundImageLayout。
）
BindingContext
获取或设置控件的 BindingContext。
（继承自 Control。
）
BorderStyle
获取或设置在 ListBox 四周绘制的边框的类型。
PublicPropertyBorderStyleAsBorderStyle
B成员名称说明Fixed3D三维边框。
FixedSingle单行边框。
None无边框。
orderStyle枚举：
指定控件的边框样式。
默认值为 Fixed3D。
Bottom
获取控件下边缘与其容器的工作区上边缘之间的距离（以像素为单位）。
（继承自 Control。
）
Bounds
获取或设置控件（包括其非工作区元素）相对于其父控件的大小和位置（以像素为单位）。
（继承自 Control。
）
CanEnableIme
获取一个用以指示是否可以将 ImeMode 属性设置为活动值的值，以启用IME支持。
（继承自 Control。
）
CanFocus
获取一个值，该值指示控件是否可以接收焦点。
（继承自 Control。
）
CanRaiseEvents
确定是否可以在控件上引发事件。
（继承自 Control。
）
CanSelect
获取一个值，该值指示是否可以选中控件。
（继承自 Control。
）
Capture
获取或设置一个值，该值指示控件是否已捕获鼠标。
（继承自 Control。
）
CausesValidation
获取或设置一个值，该值指示控件是否会引起在任何需要在接收焦点时执行验证的控件上执行验证。
（继承自 Control。
）
ClientRectangle
获取表示控件的工作区的矩形。
（继承自 Control。
）
ClientSize
获取或设置控件的工作区的高度和宽度。
（继承自 Control。
）
ColumnWidth
如果将该值设置为零（0），则将默认宽度分配给每列。
如果 ListBox 是多列 ListBox，则此属性返回列表中每列的当前宽度。
可以使用此属性确保多列 ListBox 中的每列都可正确显示其项。
获取或设置多列 ListBox 中列的宽度。
PublicPropertyColumnWidthAsInteger
CompanyName
获取包含控件的应用程序的公司名称或创建者。
（继承自 Control。
）
Container
获取 IContainer，它包含 Component。
（继承自 Component。
）
ContainsFocus
获取一个值，该值指示控件或它的一个子控件当前是否有输入焦点。
（继承自 Control。
）
ContextMenu
获取或设置与控件关联的快捷菜单。
（继承自 Control。
）
ContextMenuStrip
获取或设置与此控件关联的 ContextMenuStrip。
（继承自 Control。
）
Controls
获取包含在控件内的控件的集合。
（继承自 Control。
）
Created
获取一个值，该值指示控件是否已经创建。
（继承自 Control。
）
CreateParams
获取创建控件句柄时所需要的创建参数。
（重写 Control.CreateParams。
）
Cursor
获取或设置当鼠标指针位于控件上时显示的光标。
（继承自 Control。
）
CustomTabOffsets
整数数组包含以升序排列的制表符宽度。
获取 ListBox 中的项之间的制表符的宽度。
PublicReadOnlyPropertyCustomTabOffsetsAsListBox.IntegerCollection
ListBox.IntegerCollection类：
表示 ListBox 中整数的集合。
DataBindings
为该控件获取数据绑定。
（继承自 Control。
）
DataManager
如果设置了 DataSource 属性，则 DataManager 属性有效。
如果这不是一个数据绑定的控件，则默认为 null引用（在VisualBasic中为 Nothing）。
获取与此控件关联的 CurrencyManager。
（继承自 ListControl。
）
ProtectedReadOnlyPropertyDataManagerAsCurrencyManager
DataSource
有两种方式可以填充 ComboBox 和 ListBox 控件。
例如，使用 Add 方法可向 ComboBox 中添加对象。
也可以通过用 DataSource、DisplayMember 和 ValueMember 属性填充 ComboBox 来向 ComboBox 添加对象。
设置了 DataSource 属性之后，用户不能修改项集合。
如果设置 DataSource 属性导致数据源更改，则将引发 DataSourceChanged 事件。
如果设置此属性导致数据成员更改，则将引发 DisplayMemberChanged 事件。
将 DataSource 设置成 null引用（在VisualBasic中为 Nothing） 时，DisplayMember 将设置为空字符串（""）。
获取或设置此 ListControl 的数据源。
（继承自 ListControl。
）
PublicPropertyDataSourceAsObject
实现 IList 或 IListSource 接口的对象，如 DataSet 或 Array。
默认值为 null引用（在VisualBasic中为 Nothing）。
DefaultCursor
获取或设置控件的默认光标。
（继承自 Control。
）
DefaultImeMode
获取控件支持的输入法编辑器（IME）模式。
（继承自 Control。
）
DefaultMargin
获取控件之间默认指定的间距（以像素为单位）。
（继承自 Control。
）
DefaultMaximumSize
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最大大小。
（继承自 Control。
）
DefaultMinimumSize
获取以像素为单位的长度和高度，此长度和高度被指定为控件的默认最小大小。
（继承自 Control。
）
DefaultPadding
获取控件内容的内部间距（以像素为单位）。
（继承自 Control。
）
DefaultSize
获取控件的默认大小。
（重写 Control.DefaultSize。
）
DesignMode
获取一个值，用以指示 Component 当前是否处于设计模式。
（继承自 Component。
）
DisplayMember
获取或设置要为此 ListControl 显示的属性。
（继承自 ListControl。
）
PublicPropertyDisplayMemberAsString
一个 String，指定 DataSource 属性指定的集合中包含的对象属性的名称。
默认值为空字符串（""）。
DisplayRectangle
获取表示控件的显示区域的矩形。
（继承自 Control。
）
Disposing
获取一个值，该值指示 Control 基类是否在释放进程中。
（继承自 Control。
）
Dock
获取或设置哪些控件边框停靠到其父控件并确定控件如何随其父级一起调整大小。
（继承自 Control。
）
DoubleBuffered
获取或设置一个值，该值指示此控件是否应使用辅助缓冲区重绘其图面，以减少或避免闪烁。
（继承自 Control。
）
DrawMode
此枚举由 ListBox、CheckedListBox 和 ComboBox 类中的 DrawMode 等成员使用。
可以重新绘制某些控件或特定元素。
此枚举用于指定是由操作系统绘制控件，还是由您自己的代码处理控件的绘制
获取或设置控件的绘图模式。
PublicOverridablePropertyDrawModeAsDrawMode
DrawMode枚举：
指定如何绘制控件的元素。
Normal
控件中的所有元素都由操作系统绘制，并且元素大小都相等。
OwnerDrawFixed
控件中的所有元素都是手动绘制的，并且元素大小都相等。
OwnerDrawVariable
控件中的所有元素都由手动绘制，元素大小可能不相等。
Enabled
获取或设置一个值，该值指示控件是否可以对用户交互作出响应。
（继承自 Control。
）
Events
获取附加到此 Component 的事件处理程序的列表。
（继承自 Component。
）
Focused
获取一个值，该值指示控件是否有输入焦点。
（继承自 Control。
）
Font
获取或设置控件显示的文字的字体。
（重写 Control.Font。
）
FontHeight
获取或设置控件的字体的高度。
（继承自 Control。
）
ForeColor
获取或设置控件的前景色。
（重写 Control.ForeColor。
）
FormatInfo
获取或设置提供自定义格式设置行为的 IFormatProvider。
（继承自 ListControl。
）
PublicPropertyFormatInfoAsIFormatProvider
设置 FormatInfo 属性将重写默认格式设置行为，默认行为使用的是 CurrentCulture 设置。
IformatProvider接口：
提供用于检索控制格式化的对象的机制。
FormatString
所使用的格式字符串必须符合.NETFramework标准格式规范。
有关详细信息，请参阅 格式化类型。
获取或设置格式说明符字符，指示如何显示值。
（继承自 ListControl。
）
PublicPropertyFormatStringAsString
FormattingEnabled
将 FormattingEnabled 属性设置为 true 会导致对 ListControl 的每个可见成员引发 Format 事件。
SelectedIndex 、SelectedValue 及 FormattingEnabled 的关系如下：
∙如果 FormattingEnabled 为 false，则当 SelectedValue 为空时，SelectedIndex 不会被设置为-1。
∙如果 FormattingEnabled 为 true，则当 SelectedValue 为空时，SelectedIndex 将被设置为-1。
获取或设置一个值，该值指示是否将格式设置应用于 ListControl 的 DisplayMember 属性。
（继承自 ListControl。
）
PublicPropertyFormattingEnabledAsBoolean
默认值为 false。
Handle
获取控件绑定到的窗口句柄。
（继承自 Control。
）
HasChildren
获取一个值，该值指示控件是否包含一个或多个子控件。
（继承自 Control。
）
Height
获取或设置控件的高度。
（继承自 Control。
）
HorizontalExtent
仅当 HorizontalScrollbar 属性设置为 true 时，此属性才报告有用的值。
如果 ListBox 的宽度小于此属性的值，则水平滚动条水平滚动 ListBox 中的项。
如果 ListBox 的宽度等于或大于此值，则隐藏水平滚动条。
此属性的值不由 ListBox 动态更新。
当 ListBox 的项是所有者描述的项时，此属性很有用。
例如，如果 ListBox 的所有者描述的项为200个像素宽，但 ListBox 为60个像素宽，则 HorizontalExtent 属性将需要设置为200，以便将这些项的右边缘滚动到控件的可见区域内。
获取或设置 ListBox 的水平滚动条可滚动的宽度。
PublicPropertyHorizontalExtentAsInteger
水平滚动条可滚动控件的宽度，以像素为单位。
默认值为零。
HorizontalScrollbar
HorizontalScrollbar 属性确定当 ListBox 内项的宽度超过控件的右边缘时，ListBox 是否应显示水平滚动条。
当此属性设置为 true 时，滚动条根据 ListBox 中项的宽度自动显示。
如果 ListBox 为所有者描述的 ListBox，为了正确显示水平滚动条，必须设置 HorizontalExtent 属性。
获取或设置一个值，该值指示是否在控件中显示水平滚动条。
PublicPropertyHorizontalScrollbarAsBoolean
默认值为 false
ImeMode
获取或设置控件的输入法编辑器（IME）模式。
（继承自 Control。
）
ImeModeBase
获取或设置控件的IME模式。
（继承自 Control。
）
IntegralHeight
当此属性设置为 true 时，控件将自动调整大小以确保项已全部显示。
如果根据窗体的空间要求，要维持 ListBox 的原始大小，则将此属性设置为 false。
默认情况下，ListBox 和 CheckedListBox 的大小设置是只显示完整的项。
如果要让 ListBox 或 CheckedListBox 完全填充停靠区域，请将 IntegralHeight 设置为 false。
这样控件将完全填充该区域，但最后一项不会完全显示。
如果 ListBox 未包含任何项，则该属性无效。
获取或设置一个值，该值指示控件是否应调整大小以避免只显示项的局部。
PublicPropertyIntegralHeightAsBoolean
InvokeRequired
获取一个值，该值指示调用方在对控件进行方法调用时是否必须调用Invoke方法，因为调用方位于创建控件所在的线程以外的线程中。
（继承自 Control。
）
IsAccessible
获取或设置一个值，该值指示控件对辅助功能应用程序是否可见。
（继承自 Control。
）
IsDisposed
获取一个值，该值指示控件是否已经被释放。
（继承自 Control。
）
IsHandleCreated
获取一个值，该值指示控件是否有与它关联的句柄。
（继承自 Control。
）
IsMirrored
获取一个值，该值指示此控件是否为镜像控件。
（继承自 Control。
）
ItemHeight
当 DrawMode 属性设置为 DrawMode.OwnerDrawFixed 时，所有项具有相同的高度。
当 DrawMode 属性设置为 DrawMode.OwnerDrawVariable 时，ItemHeight 属性指定添加到 ListBox 中的每个项的高度。
因为所有者描述的列表中的每个项可具有不同的高度，所以可使用 GetItemHeight 方法获取 ListBox 中特定项的高度。
如果对具有可变高度的项的 ListBox 使用 ItemHeight 属性，则此属性返回控件中第一个项的高度。
ListBox 项的最大高度是255像素。
获取或设置 ListBox 中项的高度。
PublicOverridablePropertyItemHeightAsInteger
Items
该属性使您可以获取对当前存储在 ListBox 中的项列表的引用。
通过此引用，可以在集合中添加项、移除项和获得项的计数。
有关可对项集合执行的任务的更多信息，请参见 ListBox.ObjectCollection 类参考主题。
也可以使用 DataSource 属性来操控 ListBox 的项。
如果使用 DataSource 属性向 ListBox 添加项，则可以使用 Items 属性查看 ListBox 中的项，但不能使用 ListBox.ObjectCollection 的方法向该列表添加项或从中移除项。
获取 ListBox 的项。
PublicReadOnlyPropertyItemsAsListBox.ObjectCollection
ListBox.ObjectCollection类：
代表 ListBox 中项的集合。
LayoutEngine
获取控件的布局引擎的缓存实例。
（继承自 Control。
）
Left
获取或设置控件左边缘与其容器的工作区左边缘之间的距离（以像素为单位）。
（继承自 Control。
）
Location
获取或设置该控件的左上角相对于其容器的左上角的坐标。
（继承自 Control。
）
Margin
获取或设置控件之间的空间。
（继承自 Control。
）
MaximumSize
获取或设置大小，该大小是 GetPreferredSize 可以指定的上限。
（继承自 Control。
）
MinimumSize
获取或设置大小，该大小是 GetPreferredSize 可以指定的下限。
（继承自 Control。
）
MultiColumn
多列 ListBox 将项放在许多列中，列的数目为不必进行垂直滚动所需的数量。
用户可使用键盘定位到当前不可见的列。
将 HorizontalScrollbar 属性设置为 true 以显示水平滚动条，使用户得以滚动到在 ListBox 的可见区域中当前未显示的列。
ColumnWidth 属性的值确定每列的宽度。
获取或设置一个值，该值指示 ListBox 是否支持多列。
PublicPropertyMultiColumnAsBoolean
默认值为 false。
Name
获取或设置控件的名称。
（继承自 Control。
）
Padding
基础结构。
此属性与此类无关。
Parent
获取或设置控件的父容器。
（继承自 Control。
）
PreferredHeight
使用此属性可确定，要显示列表中的每个可用项同时避免显示垂直滚动条，需要将 ListBox 调整到什么高度。
如果 ListBox 中项的数量巨大，则使用 PreferredHeight 属性的值调整控件的大小可能导致将 ListBox 的大小调整到窗体的工作区或ListBox 容器之外。
获取 ListBox 中所有项的组合高度。
PublicReadOnlyPropertyPreferredHeightAs
升级会员 