Manejo de controles (widgets)

Estructuras de datos
struct	CTRLDATA

Enumeraciones
enum	ControlState

Funciones
Control	SceneGetControl (Scene sc, const char *name)
void	ControlSetStatus (Control ob, ControlState status)
void	ControlSetText (Control ob, const char *text,...)
void	ControlSetPicture (Control control, Image image)
void	ControlSetPosition (Control control, int x, int y)
void	ControlSetSize (Control control, int width, int height)
void	ControlGetData (Control ob, CTRLDATA *data)
void	ControlApplyStyle (Control control, Style style)
void	ControlEnableFontStyles (Control control, bool enable)
void	ControlBindDataBool (Control control, bool *data)
void	ControlBindDataInt (Control control, int *data)
void	ControlBindDataFloat (Control control, float *data)
void	ControlBindDataString (Control control, char *data)
void	ControlUnbindData (Control control)
void	ControlSetDataFormat (Control control, const char *format)

Descripción detallada

Documentación de las enumeraciones

ControlState

enum ControlState

Posibles estados de un control, ver ControlSetStatus()

Documentación de las funciones

SceneGetControl()

Control SceneGetControl	(	Scene	scene,
		const char *	name
	)

Devuelve un control de la escena a partir de su atributo id

Parámetros

scene	Objeto Scene donde se encuentra el control
name	Atributo id en la descripción xml

ControlSetStatus()

void ControlSetStatus	(	Control	control,
		ControlState	status
	)

Establece el estado de un control

Parámetros

control	Control a modificar
status	uno de los posibles valores de ControlState

ControlSetText()

void ControlSetText	(	Control	control,
		const char *	text,
			...
	)

Establece el texto de un control

Parámetros

control	Control a modificar
text	Cadena de texto UTF-8 a mostrar, o NULL para deshabilitar

ControlSetPicture()

void ControlSetPicture	(	Control	control,
		Image	image
	)

Establece la imagen de fondo de un control

Parámetros

control	Control a modificar
image	Objeto Image a establecer, o NULL para deshabilitar

ControlSetPosition()

void ControlSetPosition	(	Control	control,
		int	x,
		int	y
	)

Establece la posición de un control en relación a su contenedor

Parámetros

control	Control a modificar
x	Distancia en píxeles desde el borde izquierdo
y	Distancia en píxeles desde el borde superior

ControlSetSize()

void ControlSetSize	(	Control	control,
		int	width,
		int	height
	)

Establece las dimensiones (ancho y alto) de un control

Parámetros

control	Control a modificar
width	Anchura en píxeles
height	Altura en píxeles

ControlGetData()

void ControlGetData	(	Control	control,
		CTRLDATA *	data
	)

Devuelve el estado de los datos efectivos de un control

Parámetros

control	Control a modificar
data	Puntero a estructura CTRLDATA que recibirá los datos

ControlApplyStyle()

void ControlApplyStyle	(	Control	control,
		Style	style
	)

Aplica un estilo visual a un control

Parámetros

control	Control a modificar
style	Objeto Style a aplicar al control

ControlEnableFontStyles()

void ControlEnableFontStyles	(	Control	control,
		bool	enable
	)

Habilita o deshabilita las variaciones de fuente con caracteres de escape

Parámetros

control	Control a modificar
enable	true para habilitar (por defecto), false para deshabilitar

ControlBindDataBool()

void ControlBindDataBool	(	Control	control,
		bool *	data
	)

Establece asociación de datos para una variable de tipo bool

Parámetros

control	Objeto Control al que asociar el dato
data	Puntero a variable tipo bool

ControlBindDataInt()

void ControlBindDataInt	(	Control	control,
		int *	data
	)

Establece asociación de datos para una variable de tipo int

Parámetros

control	Objeto Control al que asociar el dato
data	Puntero a variable tipo int

ControlBindDataFloat()

void ControlBindDataFloat	(	Control	control,
		float *	data
	)

Establece asociación de datos para una variable de tipo float

Parámetros

control	Objeto Control al que asociar el dato
data	Puntero a variable tipo float

ControlBindDataString()

void ControlBindDataString	(	Control	control,
		char *	data
	)

Establece asociación de datos para una variable de tipo cadena de texto

Parámetros

control	Objeto Control al que asociar el dato
data	Puntero a cadena de char* terminada en 0

ControlUnbindData()

void ControlUnbindData

(

Control

control

)

Finaliza la asociación de datos de un control

Parámetros

control

Objeto Control al que finalizar la asociación

ControlSetDataFormat()

void ControlSetDataFormat	(	Control	control,
		const char *	format
	)

Establece formato de datos opcional para dato asociado.

Parámetros

control	Objeto Control al que establecer formato de representación
format	Cadena de texto compatible printf

Comentarios

Por defecto ya se genera un formato de datos adecuado al tipo de dato asociado.