Ewl_Radiobutton: A Radio Button Widget and Grouping System

Detailed Description

Provides for a simple radiobutton with label, and to group radio buttons for selecting a single option.


Data Structures
struct	Ewl_Radiobutton
	Inherits from Ewl_Checkbutton and extends it to provide grouping buttons to limit to a single selection in a group at a given time. More...
Defines
#define	EWL_RADIOBUTTON(button) ((Ewl_Radiobutton *) button)
#define	EWL_RADIOBUTTON_IS(w) (ewl_widget_type_is(EWL_WIDGET(w), EWL_RADIOBUTTON_TYPE))
#define	EWL_RADIOBUTTON_TYPE "radiobutton"
Typedefs
typedef Ewl_Radiobutton	Ewl_Radiobutton
Functions
void	ewl_radiobutton_cb_clicked (Ewl_Widget w, void ev_data, void *user_data)
void	ewl_radiobutton_cb_destroy (Ewl_Widget w, void ev_data, void *user_data)
Ewl_Radiobutton *	ewl_radiobutton_chain_selected_get (Ewl_Radiobutton *rb)
void	ewl_radiobutton_chain_set (Ewl_Radiobutton rb, Ewl_Radiobutton crb)
	Attach the button to a chain of radio buttons.
int	ewl_radiobutton_init (Ewl_Radiobutton *rb)
	Initialize the radio button fields and callbacks.
Ewl_Widget *	ewl_radiobutton_new (void)
	Allocate and initialize a new radio button.
void *	ewl_radiobutton_value_get (Ewl_Radiobutton *rb)
void	ewl_radiobutton_value_set (Ewl_Radiobutton rb, void v)

#define EWL_RADIOBUTTON ( button ) ((Ewl_Radiobutton *) button)

Typecasts a pointer to an Ewl_Radiobutton pointer.

#define EWL_RADIOBUTTON_IS ( w ) (ewl_widget_type_is(EWL_WIDGET(w), EWL_RADIOBUTTON_TYPE))

Returns TRUE if the widget is an Ewl_Radiobutton, FALSE otherwise

#define EWL_RADIOBUTTON_TYPE "radiobutton"

The type name for the Ewl_Radiobutton widget

The radio button provides a means for selecting a single item from a group of options.

void ewl_radiobutton_cb_clicked	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

void ewl_radiobutton_cb_destroy	(	Ewl_Widget *	w,
		void *	ev_data,
		void *	user_data
	)

Ewl_Radiobutton* ewl_radiobutton_chain_selected_get ( Ewl_Radiobutton * rb )

void ewl_radiobutton_chain_set	(	Ewl_Radiobutton *	rb,
		Ewl_Radiobutton *	crb
	)

Attach the button to a chain of radio buttons.

Parameters:

	rb,:	the radio button to be added to a chain of radio buttons
	crb,:	a radio button already in the chain of radio buttons

Associates w with the same chain as c, in order to ensure that only one radio button of that group is checked at any time.

int ewl_radiobutton_init ( Ewl_Radiobutton * rb )

Initialize the radio button fields and callbacks.

Parameters:

rb,:

the radio button to initialize

Sets internal fields of the radio button to default values and sets the label to the specified label.

Ewl_Widget* ewl_radiobutton_new ( void )

Allocate and initialize a new radio button.

Returns:: Returns a pointer to new radio button on success, NULL on failure.

void* ewl_radiobutton_value_get ( Ewl_Radiobutton * rb )

void ewl_radiobutton_value_set	(	Ewl_Radiobutton *	rb,
		void *	v
	)