Applies to
|
ListBox Object |
You can use the MultiSelect property to specify whether a user can make multiple selections in a list box on a form and how the multiple selections can be made. Read/write Byte.
expression.MultiSelect
expression Required. An expression that returns one of the objects in the Applies To list.
Remarks
The MultiSelect property uses the following settings.
|
Setting |
Visual Basic |
Description |
|
None |
0 |
(Default) Multiple selection isn't allowed. |
|
Simple |
1 |
Multiple items are selected or deselected by clicking them with the mouse or pressing the SPACEBAR. |
|
Extended |
2 |
Multiple items are selected by holding down SHIFT and clicking them with the mouse or by holding down SHIFT and pressing an arrow key to extend the selection from the previously selected item to the current item. You can also select items by dragging with the mouse. Holding down CTRL and clicking an item selects or deselects that item. |
Note: You can set the MultiSelect property by using the list box's property sheet, a macro, or Visual Basic for Applications (VBA) code.
This property can be set only in form Design view.
You can use the ListIndex property to return the index number for the selected item. When the MultiSelect property is set to Extended or Simple, you can use the list box's Selected property or ItemsSelected collection to determine the items that are selected. In addition, when the MultiSelect property is set to Extended or Simple, the value of the list box control will always be Null.
If the MultiSelect property is set to Extended, requerying the list box clears any selections made by the user.
Example
To return the value of the MultiSelect property for a list box named "Country" on the "Order Entry" form, you can use the following:
Dim b As Byte
b = Forms("Order Entry").Controls("Country").MultiSelect
To set the MultiSelect property, you can use the following:
Forms("Order Entry").Controls("Country").MultiSelect = 2 ' Extended.
