An optional entry is also refered as a ComboBox. It is a composite widget combined from a entry and a listbox. It allows users to enter text via the entry and also provides a list of possible choices via the listbox. The entry can be either editable or non-editable. Option is also provided so that the listbox remembers the history of selected information.
When a choice is made, the callbacks of the optional entry, if any, are invoked.
An optional entry is created by invoking
EZ_CreateWidget
with type EZ_WIDGET_OPTIONAL_ENTRY
or by
calling
EZ_Widget *EZ_CreateOptionalEntry(EZ_Widget *parent, char *init_str,
int rem_history, int editable)
To get the components of an optional entry, use
void EZ_GetOptionalEntryComponents(EZ_Widget *optEntry,
EZ_Widget **entry_ret, EZ_Widget **lbox_ret,
EZ_Widget **btn_ret)