GuiDropDownCtrl Class Reference

#include <guiDropDownCtrl_ScriptBinding.h>

Inherits GuiControl.

Public Member Functions
void	addItem (string text, [color red/green/blue/[alpha]])"
void	clearItems ()"
void	clearSelection ()"
void	closeDropDown ()"
Integer	findItemID (int ID)"
Integer	findItemText (string itemText, bool caseSensitive)"
Boolean	getItemActive (int index)"
Integer	getItemCount ()"
Integer	getItemID (int index)"
Integer	getSelectedItem ()"
void	openDropDown ()"
void	setCurSel (S32 index)"
void	setItemActive (int index)"
void	setItemID (int index, int ID)"
void	setItemInactive (int index)"
void	setSelected (S32 index, [bool isSelected])"
Public Member Functions inherited from GuiControl
void	addGuiControl (int controlId)
Integer	findHitControl (int x, int y)
String	getCenter ()
String	getExtent (...)
String	getGlobalCenter ()
String	getGlobalPosition ()
String	getMinExtent ()
Integer	getParent ()
String	getPosition ()
String	getText ()
Boolean	getTextExtend ()
Boolean	getTextWrap ()
String	getValue ()
Boolean	isActive ()
Boolean	isAwake ()
Boolean	isVisible ()
void	makeFirstResponder (isFirst)
void	performClick ()
Boolean	pointInControl (int x, int y)
void	reorderChild (child1, child2)
void	resize (int x, int y, int w, int h)
void	setActive (isActive)
void	setCanSave (bool canSave)
void	setCenter (int x, int y)
void	setExtent (int width, int height)
void	setFirstResponder ()
void	setPosition (int x, int y)
void	setPositionGlobal (int x, int y)
void	setProfile (GuiControlProfile p)
void	setText (text)
void	setTextExtend (setting)
void	setTextID (id)
void	setTextWrap (setting)
void	setValue (value)
void	setVisible (isVisible)

Member Function Documentation

addItem()

void addItem	(	string	text,
		[color red / green / blue / [alpha] ]
	)

Adds an item to the end of the list with an optional color bullet.

Parameters

text	The text of the new item.
color	The optional color of a color bullet that will appear to the left of the text. Values range between 0 and 255.

Returns

No return value.

clearItems()

void clearItems

(

)

Removes all items from the listbox.

Returns

No return value.

clearSelection()

void clearSelection

(

)

Unselects any items that have been selected.

Returns

No return value.

closeDropDown()

void closeDropDown

(

)

Closes the drop down. Does nothing if the drop down is already closed.

Returns

No return value.

findItemID()

Integer findItemID

(

int

ID

)

Finds the first item with the given ID.

Parameters

ID	The item ID to search for.

Returns

The first matching item index or -1 if no item is found.

findItemText()

Integer findItemText	(	string	itemText,
		bool	caseSensitive
	)

Finds all items with the given text.

Parameters

itemText	The text to search for.
caseSensitive	If true, a case-sensitive search will be performed.

Returns

A space-delimited list of matching item indexes or -1 if no items are found.

getItemActive()

Boolean getItemActive

(

int

index

)

Returns if an item is active or not using an index.

Parameters

index

The zero-based index of the item.

Returns

No return value.

getItemCount()

Integer getItemCount

(

)

Returns the number of items in the list.

Returns

The number of items.

getItemID()

Integer getItemID

(

int

index

)

Returns an item's ID using an index.

Parameters

index

The zero-based index of the item with the needed ID.

Returns

No return value.

getSelectedItem()

Integer getSelectedItem

(

)

Returns the index of the selected item.

Returns

The index of the selected item or -1 if no item is selected.

openDropDown()

void openDropDown

(

)

Opens the drop down. Does nothing if the drop down is already open.

Returns

No return value.

setCurSel()

void setCurSel

(

S32

index

)

Selects the item at the given index.

Parameters

index

The zero-based index of the item that should be selected. Passing a -1 clears the selection.

Returns

No return value.

setItemActive()

void setItemActive

(

int

index

)

Sets an item active using an index.

Parameters

index

The zero-based index of the item that should be active.

Returns

No return value.

setItemID()

void setItemID	(	int	index,
		int	ID
	)

Sets an item's ID using an index.

Parameters

index	The zero-based index of the item that should have the ID.
ID	An interger value that numerically represents this item.

Returns

No return value.

setItemInactive()

void setItemInactive

(

int

index

)

Disables an item using an index.

Parameters

index

The zero-based index of the item that should be inactive.

Returns

No return value.

setSelected()

void setSelected

(

S32

index

)

Sets an item to selected or unselected using an index.

Parameters

index	The zero-based index of the item that should be selected.
isSelected	If true, the item is selected. If false, it is unselected. If omitted, will default to true.

Returns

No return value.