textscreen/txt_dropdown.h File Reference

Dropdown list widget. More...

Go to the source code of this file.

Data Structures
struct	txt_dropdown_list_s
Typedefs
typedef struct txt_dropdown_list_s	txt_dropdown_list_t
	Dropdown list widget.
Functions
txt_dropdown_list_t *	TXT_NewDropdownList (int *variable, char **values, int num_values)
	Create a new dropdown list widget.

---

Detailed Description

Dropdown list widget.

---

Typedef Documentation

typedef struct txt_dropdown_list_s txt_dropdown_list_t

Dropdown list widget.

A dropdown list allows the user to select from a list of values, which appears when the list is selected.

When the value of a dropdown list is changed, the "changed" signal is emitted.

---

Function Documentation

txt_dropdown_list_t* TXT_NewDropdownList	(	int *	variable,
		char **	values,
		int	num_values
	)

Create a new dropdown list widget.

The parameters specify a list of string labels, and a pointer to an integer variable. The variable contains the current "value" of the list, as an index within the list of labels.

Parameters:

variable	Pointer to the variable containing the list's value.
values	Pointer to an array of strings containing the labels to use for the list.
num_values	The number of variables in the list.