列表框控件ListBox用于显示一个列表,用户可以从中选择一项或多项。如果选项总数超出可以显示的项数,则控件会自动添加滚动条。
列表控件的部分属性及说明
属性名 | 说明 |
Items | 获取列表框中的项。Items属性的Add方法,可以向ListBox控件中添加项目。通过Items属性的Remove(参数是SelectedItems)方法,可以将ListBox控件中选中的项目删除 |
MultiColumn | 指示列表框是否支持多列。如果将其设置为true,则支持多行显示 |
ColumnWidth | 在包含多个列的列表框中,这个属性指定列的宽度 |
SelectedIndices | 这个属性是一个集合,包含列表框中选中项的所有基于零的索引 |
SelectedIndex | 获取或设置列表框中当前选定项的从零开始的索引。如果列表框可以一次选择多个选项,这个属性就包含选中列表中的第一个选项 |
SelectedItem | 获取或设置列表框中的当前选定项。在只能选择一个选项的列表框中,这个属性包含选中的选项。在可以选择多个选项的列表框中,这个属性包含选中的第一项 |
SelectedItems | 获取包含列表框中当前选定的所有选项的集合 |
Sorted | 指示列表框中的项是否按字母顺序排序 |
SelectionMode | 获取或设置在列表框中选择项多项的方法。其属性值是SelectionMode的枚举值之一,可取值为None(无法选择项)、One(只能选择一项)、MultiSimple(可以选择多项)、MultiExtended(可以选择多项,并且用户可以使用Shift键、Ctrl键和方向键来进行选择) |
Text | 如果设置列表框控件的Text属性,它将搜索匹配该文本的选项,并选择该选项。如果获取Text属性,返回的值是列表中第一个选中的选项。如果SelectionMode是None,就不能使用这个属性 |
Sorted | 把这个属性设置为true,列表框会对它包含的选项按照字母顺序排序 |
HorizontalScrollbar | 设置为true,则始终显示水平滚动条 |
ScrollAlwaysVisible | 设置为true,则始终显示垂直滚动条 |
列表控件的部分方法及说明
方法名 | 说明 |
ClearSelected | 取消选择列表框中的所有项 |
GetSelected | 返回一个值,该值指示是否选定了指定的项。如果在列表框中选定了指定的项,则为true,否则为false |
SetSelected | 设置或清除选项 |
FindString | 查找列表框中第一个以指定字符串开头的字符串,例如FindString("a")就是查找列表框中第一个以a开头的字符串 |
FindStringExact | 与FindString 类似,但必须匹配整个字符串 |
ToString | 返回当前选中的选项 |