LISTBOX 元素

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

LISTBOX 元素为用户提供了一种从列表中选择项目的方法。 可以使用 ITEM 元素作为 LISTBOX 元素的子元素来指定这些项目。 如果需要仅在需要时显示的列表框控件，请使用 POPUP 元素，该元素与 LISTBOX 元素相同，但 popUp 属性的默认值除外，后者指示其显示行为。

LISTBOX 元素支持以下属性。

Attribute	说明
backgroundColor	指定或检索列表框控件中的背景色。
边境	指定或检索一个值，该值指示列表框控件是否具有边框。 只能在设计时设置。
firstVisibleItem	指定或检索列表框控件中第一个可见行的索引。
focusItem	指定或检索包含焦点的行。
fontFace	指定或检索列表框控件的字体。
fontSize	指定或检索列表框控件的字号。
fontStyle	指定或检索列表框控件的字体样式。
foregroundColor	指定或检索列表框控件中的文本颜色。
itemCount	检索列表框控件中的项数。
multiSelect	指定或检索一个值，该值指示用户是否可以选择多行。 只能在设计时设置。
弹出	指定一个值，该值指示 元素是表示弹出框控件还是列表框控件。
readOnly	指定或检索一个值，该值指示文本是只读的还是文本可由用户选择。
selectedItem	指定或检索列表框控件中所选项的索引。
排序	指定或检索一个值，该值指示列表框控件是否按字母顺序排序。

 

LISTBOX 元素支持以下方法。

方法	说明
appendItem	在列表框控件的末尾插入新文本。
deleteAll	从列表框控件中删除所有项。
deleteItem	删除指定索引处的列表框控件项。
解雇	隐藏控件。
findItem	搜索从指定项索引后面的项开始的给定字符串。
getItem	检索具有指定索引的项的文本。
getNextSelectedItem	检索列表框控件中的下一个选定项，该控件从具有指定索引的项之后开始。
insertItem	在列表框控件的指定索引处插入指定的文本。
replaceItem	将指定索引处的文本替换为指定的文本。
setSelectedState	选择或取消选择具有指定索引的项。
show	显示控件。

 

注意

对于 Windows XP 或更高版本，此元素需要Windows 媒体播放器。

 

相关主题

POPUP 元素

外观编程参考