LISTBOX Element
[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
The LISTBOX element provides a way for users to select items from a list. These items can be specified by using ITEM elements as children of the LISTBOX element. If you need a list box control that is displayed only when needed, use the POPUP element, which is identical to the LISTBOX element except for the default value of the popUp attribute, which dictates its display behavior.
The LISTBOX element supports the following attributes.
| Attribute | Description |
|---|---|
| backgroundColor | Specifies or retrieves the background color in the list box control. |
| border | Specifies or retrieves a value indicating whether the list box control has a border. Can only be set at design time. |
| firstVisibleItem | Specifies or retrieves the index of the first visible line in the list box control. |
| focusItem | Specifies or retrieves the line that contains focus. |
| fontFace | Specifies or retrieves the font for the list box control. |
| fontSize | Specifies or retrieves the font size for the list box control. |
| fontStyle | Specifies or retrieves the font style for the list box control. |
| foregroundColor | Specifies or retrieves the text color in the list box control. |
| itemCount | Retrieves the number of items in the list box control. |
| multiSelect | Specifies or retrieves a value indicating whether the user can select multiple lines. Can only be set at design time. |
| popUp | Specifies a value indicating whether the element represents a popup or list box control. |
| readOnly | Specifies or retrieves a value indicating whether text is read-only or text can be selected by the user. |
| selectedItem | Specifies or retrieves the index of the item selected in the list box control. |
| sorted | Specifies or retrieves a value indicating whether the list box control is sorted alphabetically. |
The LISTBOX element supports the following methods.
| Method | Description |
|---|---|
| appendItem | Inserts new text at the end of the list box control. |
| deleteAll | Deletes all items from the list box control. |
| deleteItem | Deletes the list box control item at the specified index. |
| dismiss | Hides the control. |
| findItem | Searches for a given string starting with the item following the specified item index. |
| getItem | Retrieves the text for the item with the specified index. |
| getNextSelectedItem | Retrieves the next selected item in the list box control starting at the item after the one with the specified index. |
| insertItem | Inserts the specified text at the specified index in the list box control. |
| replaceItem | Replaces the text at the specified index with the specified text. |
| setSelectedState | Selects or unselects the item with the specified index. |
| show | Displays the control. |
Note
This element requires Windows Media Player for Windows XP or later.
Related topics