DlgComboBox.SetProperties

DlgComboBox.SetProperties ( 

number ControlID,

table  Properties )

Description

 Sets the properties of a combo box control on the current screen.

Note: This action will only work if called from a screen's events and if the named control is on the current screen.

Parameters

ControlID

(number) The numeric ID of the combo box control whose properties you want to set.

Properties

(table) A table containing the combo box control properties indexed by the following keys:

KEY

TYPE

DESCRIPTION

Enabled

boolean

Enable or disable the control. Setting Enabled to true will enable the control and false will disable it. For example, tb.Enabled = true or {Enabled=true}.

Selected

number

The one based index of the combo box item you want to select. You can use -1 to deselect all items. For example, tb.Selected = 2 or {Selected=2}.

Sorted

boolean

Sort the control alphabetically. Setting Sorted to true will sort the items and false will not. For example, tb.Sorted = true or {Sorted=true}.

Text

string

The text you want to appear in the control. For example, tb.Text = "Sample Text" or {Text="Sample Text"}.

Visible

boolean

Sets the visibility of the control. Setting it to true means the control will be visible and false means it will be invisible. For example, tb.Visible=true or {Visible=true}.

Note: All changes will be made immediately and only the properties that you want to change need to be set.

Returns

Nothing. You can use Application.GetLastError to determine whether this action failed, and why.

See also:  Related Actions