The combo box component defines a box featuring a drop-down list in a Standard Maple worksheet or document. This component performs an action or a series of actions to communicate with other embedded components when an item from the combo box is selected, although assigning an action to a component is not required.

To perform an action when an item from a combo box is selected, click the combo box, and then from the Combo Box context panel, select Edit Select Code to open the Code Editor dialog for the combo box. Enter the commands you want to perform in the Code Editor dialog.

You need to specify one or more embedded components that will display the output when an item from the combo box is selected. For more information, see the Combo Box Component Example on this page.

The combo box component is customized by setting options in the Combo Box context panel. To display the options in the context panel, select the Combo Box. Actions are associated with components using routines in the DocumentTools package.

To populate the combo box with entries, click the Edit button beside Item List. This displays the List Editor. In the List Editor, add the first item by double-clicking the text field and editing this region. To add additional items, click the Add button. After you have populated the combo box, select the drop-down menu beside Selected Item and choose the item that will appear in the combo box when collapsed.

The Name property is used to reference the combo box when using the routines from the DocumentTools package.

The following table describes the control and use of the combo box component options.

An x in the Get column indicates that the option can be read, that is, retrieved by using the DocumentTools[GetProperty] tool.

An x in the Set column indicates that the option can be written, that is, set by using the DocumentTools[SetProperty] tool.

enabled 

Indicates whether the component is enabled. Disabled components appear grayed out and their associated actions cannot be executed. By default, the value is true.

fontcolor

Specifies the font color of the component.  The color can be given by RGB values (a list of three integers between 0 and 255) or a string representing a color name, for example, [255,0,0] or “Red”. The default value is [0,0,0] which corresponds to black.

itemlist 

The set of choices provided in the Combo Box.

selectedindex 

The index of the item which is selected. The first index is 0.

tooltip 

The text that appears when the user hovers the mouse over the component.

type 

The type of the component. This returns "ComboBox".

value 

The name of the item which is selected.

visible 

Specifies if the component is visible. By default, the value is true.

with(DocumentTools):

SetProperty("Plot0",value,plot3d(x*sin(y), x=-10..10, y=-5..5, shading=GetProperty("ComboBox0",value)));

GetProperty(ComboBox0, value);

$''xyz''$

mylist := ["one", "two", "three"];

$\mathrm{mylist}:=\left[''one''\,''two''\,''three''\right]$

SetProperty("ComboBox1", itemlist, mylist);

if GetProperty(ComboBox0, value) = "xyz" then
    SetProperty(ComboBox1, value, "two")
end if;