Component/Dropdown

Namespace

Constants

MODULE_COMPONENT_DROPDOWN

69

DROPDOWN_COMPONENT_SET_HIDDEN	0
DROPDOWN_COMPONENT_SET_DISABLED	1
DROPDOWN_COMPONENT_SET_X	2
DROPDOWN_COMPONENT_SET_Y	3
DROPDOWN_COMPONENT_SET_VALUE	4
DROPDOWN_COMPONENT_GET_VALUE	5
DROPDOWN_COMPONENT_CLEAR	6
DROPDOWN_COMPONENT_ADD_ITEM	7

Properties

These properties can be edited with the property editor in the IDE.

Name	Type	Description
name	string	The component name.
hidden	boolean	Hide the component.
disabled	boolean	Disable the component.
x	number	The left position of the component inside the parent component.
y	number	The top position of the component inside the parent component.
zIndex	number	The depth of the component related to other components in the parent.
items	list	A list of selectable items.
value	number	The selected item.

Events

onChange

Called when an other item is selected.

proc onChange(number windowHandle, number value)

Name	Type	Description
windowHandle	number	The handle of the parent window of the dropdown.
value	number	Index of the selected item, the index of the first item is 0, the second is 1, etc..

onFocus

Called when the dropdown is focussed.

proc onFocus(number windowHandle)

Name	Type	Description
windowHandle	number	The handle of the parent window of the dropdown.

onBlur

Called when the dropdown looses focus.

proc onBlur(number windowHandle)

Name	Type	Description
windowHandle	number	The handle of the parent window of the dropdown.

---

Procedures

setHidden

Hide the dropdown component.

proc setHidden(number windowHandle, number componentHandle, number hidden)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
hidden	number	Hidden TRUE or FALSE.

---

setDisabled

Disable the dropdown component.

proc setDisabled(number windowHandle, number componentHandle, number disabled)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
disabled	number	Disabled TRUE or FALSE.

---

setX

Set the x position of the dropdown component.

proc setX(number windowHandle, number componentHandle, number x)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
x	number	The x position in pixels.

---

setY

Set the y position of the dropdown component.

proc setY(number windowHandle, number componentHandle, number y)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
y	number	The y position in pixels.

---

setValue

Set the value.

proc setValue(number windowHandle, number componentHandle, number value)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
value	number	The active item.

---

getValue

Get the value.

proc getValue(number windowHandle, number componentHandle)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.

---

clear

Clear the dropdown list.

proc clear(number windowHandle, number componentHandle)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.

---

addItem

Add an item to the dropdown list.

proc addItem(number windowHandle, number componentHandle, number value, string text)

Name	Type	Description
windowHandle	number	The handle of the window.
componentHandle	number	The handle of the component.
value	number
text	string

---