====== LIST property (Listbox) ======


 
==== Description ====
 
 
Gets or Sets the list of items in the control, or an individual property item when specifying an index value.
 
 
 
 
==== Property Value ====
 
 
If no index is specified then the property value is an @fm delimited list of all items in the control. If an index is specified then the property value is a single item.
 
 
 
If the ListBox does not have a valid IMAGELIST then each item should be the text to display (Tab characters may be used to control indenting).
 
 
 
If the ListBox has a valid IMAGELIST object then each item may be prefixed with an "item-header" containing the image number to display and the indent that that item should appear at.  The header has the format:
 
 
<code>
<item> ::= <images> "-" <indent> ":: <text>
</code> 
 
 
The "images" specifier may be further broken down into a comma-delimited array, with each position in the array corresponding to one of the common item states.
 
 
<code> 
<images> ::= <normal> ","
 
<hot> ","
 
<selected> ","
 
<hotselected> ","
 
<selectednofocus> ","
 
<disabled>
</code> 
 
 
 
==== Property Traits ====
 
 
 
 
 
 
 
^Development^Runtime^Indexed^Scaled^Synthetic^
|Get/Set|Get/Set|ItemPosition|No|No|

 


 
==== Remarks ====
 
 
At runtime an individual property may be referenced via a row index value using the normal Get/Set_Property index parameter.  The index value is the 1-based position of the item.
 
 
 
Note that setting the LIST property is the same as using the LISTX property.
 
 
 
 
==== See Also ====
 
 
LISTX property, IMAGELIST object, INITSTORAGE method, ITEMIMAGEINDEX method, UPDATE method.