Concept : Using Selection Lists 
Contents |
[edit] Description
A selection list is a named set of indexes into a collection (each index represents a selected element within the collection). You manage different groups of selected items within a collection by assigning unique names to the individual selection lists. For example, if two controls are bound to the same collection, and the first control is associated with a selection list called list1, and the second control is associated with the default selection list (called default), then, when elements are selected in the first control, those elements do not appear selected in the second control.
Note: When the default selection list is used by all controls, the elements that are selected in any control appear selected in all controls that are bound to the same collection.
[edit] Example
Assume you have a collection, named people, containing the following elements: John Doe, Sue Smith, Sara Jones, and Tom Hill.
If the selection list named Men contains indexes 0 and 3, then the Men selection list indicates that John Doe and Tom Hill are the selected elements within the people collection.
In the following screen shot, the List control on the left and the MultiColumnList control on the right are both bound to people. However, the List control has it's Select Name property (Style tab) set to Men. The MultiColumnList's Select Name property is set to default.
When the Main form is simulated, the selections in the List control are not reflected in the MultiColumnList control because the two controls use different selection lists.
[edit] Functions Using Selection List
clearSelection
clearSelectionMultiple
deselect
deselectMultiple
getLastSelectedData
getSelectedData
select
selectMultiple
selectNext
selectPrevious
selectValue
singleSelectedItem
