====== O4WListBox routine ======


 
==== Description ====
 
Creates an entry in the listbox named <name> which will return <value> when selected.
 
==== Syntax ====
 
O4WListBox(text, value, name, group, id, style)
 
==== Parameters ====
 
The function has the following parameters:

^Parameter^Description^
|text|The text of the list item.|
|value|The data to be returned when the item is selected.|
|name|The name of the list item.|
|group|The name of the group in which to group the text and value.|
|id|If specified, the control can be addressed through style sheets individually.|
|style|If specified, the style is applied to the text that is generated.\\ \\ Note that <style> may be either the name of a style (as created by one of the O4W style functions, or as defined in an included style sheet), or it can be the returned value from one of the O4W style functions.||

 
==== Remarks ====
 
If the [[o4wmarkedoptions|O4WMarkedOptions]] "checked" flag is set, then that specific item will be selected.

If [[o4wlistboxstyle|O4WListboxStyle]] passed in with a listbox ID, then this will be used as the listbox ID, otherwise it will perform the default behavior of using the 'name' of the listbox as the id.

If [[o4wmarkedstyle|O4WMarkedStyle]] passed in with list of selected values, then those values will be shown as selected.