itemSelected

Type: Boolean array

Availability: Read or write at run time only

The itemSelected property enables the selection status of each item in a ListBox control to be obtained or set. The itemSelected property contains a reference to an array of Boolean values with the same number of items as returned by the listCount method. Use this property when users can make multiple selections in a list box, to quickly check which items in a list are selected. You can also use this property from logic to select or deselect items in a list.

For details about making multiple selections in list boxes, see the multiSelect property.

If only one item is selected, you can use the listIndex property to get the index of the selected item. However, in a multiple selection, the listIndex property returns the index of the item contained within the focus rectangle, whether or not the item is actually selected.

When multiple items are currently selected, the value of the listIndex property is the last of the items selected. One or more items can be selected, with the value of the listIndex property being none of those items (for example, when you select an item, press the Shift key and select another item, then press the Ctrl key and remove the selection of one of the previously selected items).