ScriptComboBox

From Q
Jump to: navigation, search

This feature is new in Q 4.8.

ScriptComboBox

Represents a combo box (drop down) control, which lets the user select a single item. The control is created by the RuleForm object's newComboBox() function.

getIndex()

Retrieves the index of the selection.
Returns:The index of the selection, or -1 if no alternative is selected.

getValue()

Retrieves the alternative selected.
Returns:One of the alternatives passed to newComboBox(), or the default if none, or null if no default has been set.

isExpression

Use this to control whether the item should be treated as an expression or as a string in R code. Only applicable to textBox, comboBox and dropBox controls.

lineBreakAfter

Use this where your Rule has many controls, and they do not fit comfortably in a single line. It allows you to specify that a new row will be started after this control.
Example:
c.lineBreakAfter = true;

requireValue()

Retrieves the alternative selected. If no alternative has been selected and no default has been set then the script will end immediately and this control will be marked invalid.
Returns:The text of the alternative chosen, or the default if none.

setDefault(alternative)

Set a default.
alternativeOne of the alternatives used to create this control.

type

Returns the name we use to refer to this class in the documentation.

visible

Set this to false if you want a control you have created to not be shown to the user. This property is only available in Q v5.4