Onetastic Macro Documentation > Functions > Dialog Box Functions > DialogBox_AddComboBox

DialogBox_AddComboBox

Adds a drop down combo box to a dialog box.

Syntax

void DialogBox_AddComboBox(
	DialogBox dialogBox, 
	String label, 
	String name, 
	String initialValue, 
	Array<String> possibleValues, 
	Bool emptyOK)

Parameters

DialogBox dialogBox

The dialog box to add the drop down combo box to.

String label

A label for the drop down combo box.

String name

Name of the drop down combo box. The value of the drop down combo box will be stored dialogBox.controls[name] after the dialog is displayed using DialogBox_Show function.

String initialValue

The initial selected value of the drop down combo box.

Array<String> possibleValues

The values to display in the drop down combo box.

Bool emptyOK

Whether it is OK for user to leave the combo box empty or not. If this is false, then the dialog box cannot be closed without entering some text into the combo box.