action : string; A string which parses to one or more valid statements in 1-D Maple notation. These statements form the Select Action Component Code that executes when the ListBox selection is manually adjusted.

enabled : truefalse; Indicates whether the component is enabled. The default is true. If enabled is false then the inserted component is grayed out and interaction with it cannot be initiated.

fillcolor : {list(nonnegint),symbol,string}:=[255,255,255] ; Specifies the background color of the component. The passed value can be either a named color or a list of three integers each between 0 and 255. A list of nonnegative integers is interpreted as RGB values in a 24bit 3-channel color space. The default value is [255,255,255] which corresponds to white.

fontcolor : {list(nonnegint),symbol,string}:=[0,0,0] ; Specifies the font color of the component. The passed value can be either a named color or a list of three integers each between 0 and 255. A list of nonnegative integers is interpreted as RGB values in a 24bit 3-channel color space. The default value is [0,0,0] which corresponds to black.

identity : {name,string}; The reference name of the component.

selected : string; The initially selected item. By default no item is selected.

tooltip : string; The text that appears when the mouse pointer hovers over the component.

visible : truefalse; Indicates whether the component is visible. The default is true.

The ListBox command in the Component Constructors package returns an XML function call which represents a ListBox Component.

The generated XML can be used with the results of commands in the Layout Constructors package to create an entire Worksheet or Document in XML form. Such a representation of a Worksheet or Document can be inserted into the current document using the InsertContent command.

$\mathrm{with}\left(\mathrm{DocumentTools}\right)\:$

$\mathrm{with}\left(\mathrm{DocumentTools}:-\mathrm{Components}\right)\:$

$\mathrm{with}\left(\mathrm{DocumentTools}:-\mathrm{Layout}\right)\:$

$L≔\left[''A''\,''B''\,''C''\right]$

$L≔\left[''A''\,''B''\,''C''\right]$

$S≔\mathrm{ListBox}\left(L\,\mathrm{identity}=''ListBox0''\right)$

$S≔\mathrm{\_XML\_EC-List}\left(''id''=''ListBox0''\,''enabled''=''true''\,''visible''=''true''\,''fillcolor''=''[255,255,255]''\,''fontcolor''=''[0,0,0]''\,''A,B,C''\right)$

$\mathrm{xml}≔\mathrm{Worksheet}\left(\mathrm{Group}\left(\mathrm{Input}\left(\mathrm{Textfield}\left(S\right)\right)\right)\right)\:$

$\mathrm{InsertContent}\left(\mathrm{xml}\right)\:$

$S≔\mathrm{ListBox}\left(L\,\mathrm{identity}=''ListBox0''\,\mathrm{selected}=''B''\,\mathrm{tooltip}=''My\; example\; ListBox''\right)\:$

$\mathrm{xml}≔\mathrm{Worksheet}\left(\mathrm{Group}\left(\mathrm{Input}\left(\mathrm{Textfield}\left(S\right)\right)\right)\right)\:$

$\mathrm{lookup}≔\mathrm{InsertContent}\left(\mathrm{xml}\,\mathrm{output}=\mathrm{table}\right)$

$\mathrm{lookup}≔table\left(\left[''ListBox0''=''ListBox1''\right]\right)$

$\mathrm{lookup}\left[''ListBox0''\right]$

$''ListBox1''$

$\mathrm{GetProperty}\left(\mathrm{lookup}\left[''ListBox0''\right]\,\mathrm{value}\right)$

$''B''$

$p≔\mathrm{plot}\left(x^2\sin \left(x\right)\,x=-2\mathrm{\pi }..2\mathrm{\pi }\,\mathrm{color}=\mathrm{blue}\right)\:$

$P≔\mathrm{Components}:-\mathrm{Plot}\left(p\,\mathrm{identity}=''Plot0''\right)\:$

$\mathrm{actioncode}≔''DocumentTools:-SetProperty(\text{'}:-Plot0\text{'},value,\backslash n\; plot(x^2*sin(x),\; x=-2*Pi..2*Pi,\backslash n\; color=parse(DocumentTools:-GetProperty(\text{'}:-ListBox0\text{'},value))));''\:$

$S≔\mathrm{ListBox}\left(\left[''red''\,''black''\,''blue''\,''green''\,''magenta''\,''yellow''\right]\,\mathrm{identity}=''ListBox0''\,\mathrm{selected}=''red''\,\mathrm{action}=\mathrm{actioncode}\,\mathrm{tooltip}=''The\; color\; choice''\,\mathrm{fillcolor}=''LightYellow''\,\mathrm{fontcolor}=''DarkBlue''\right)\:$

$\mathrm{xml}≔\mathrm{Worksheet}\left(\mathrm{Group}\left(\mathrm{Input}\left(\mathrm{Textfield}\left(P\right)\right)\right)\,\mathrm{Group}\left(\mathrm{Input}\left(\mathrm{Textfield}\left(S\right)\right)\right)\right)\:$

$\mathrm{InsertContent}\left(\mathrm{xml}\right)\:$

The DocumentTools:-Components:-ListBox command was introduced in Maple 2015.

For more information on Maple 2015 changes, see Updates in Maple 2015.

The DocumentTools:-Components:-ListBox command was updated in Maple 2016.

The fillcolor and fontcolor options were introduced in Maple 2016.

For more information on Maple 2016 changes, see Updates in Maple 2016.