Check

The check widget allows for toggling a value between true and false. More...

Functions
bool	elm_check::state_get () const
	Get the state of the check object. More...
void	elm_check::state_set (bool state_) const
	Get the state of the check object. More...
Evas_Object *	elm_check_add (Evas_Object *parent)
	Add a new Check object. More...

Detailed Description

The check widget allows for toggling a value between true and false.

Check objects are a lot like radio objects in layout and functionality, except they do not work as a group, but independently, and only toggle the value of a boolean between false and true. elm_check_state_set() sets the boolean state and elm_check_state_get() returns the current state. For convenience, like the radio objects, you can set a pointer to a boolean directly with elm_check_state_pointer_set() for it to modify.

This widget inherits from the Layout one, so that all the functions acting on it also work for check objects.

This widget emits the following signals, besides the ones sent from Layout:

• "changed" - This is called whenever the user changes the state of the check objects (event_info is always NULL).
• "focused" - When the check has received focus. (since 1.8)
• "unfocused" - When the check has lost focus. (since 1.8)
• "language,changed" - the program's language changed (since 1.9)

Default content parts of the check widget that you can use for are:

• "icon" - An icon of the check

Default text parts of the check widget that you can use for are:

• "default" - A label of the check
• "on" - On state label of the check (only valid for "toggle" style.)
• "off" - Off state label of the check (only valid for "toggle" style.)

Supported elm_object common APIs.

• elm_object_disabled_set
• elm_object_disabled_get
• elm_object_part_text_set
• elm_object_part_text_get
• elm_object_part_content_set
• elm_object_part_content_get
• elm_object_part_content_unset
• elm_object_signal_emit
• elm_object_signal_callback_add
• elm_object_signal_callback_del

Check example should give you a firm grasp of how to use this widget.

Function Documentation

Evas_Object* elm_check_add

(

Evas_Object *

parent

)

Add a new Check object.

Parameters

parent

The parent object

Returns

The new object or NULL if it cannot be created

bool elm_check::state_get ( ) const

inline

Get the state of the check object.

Returns

The boolean state

Parameters

state

The state to use (1 == on, 0 == off)

void elm_check::state_set ( bool  state_ ) const

inline

Get the state of the check object.

Returns

The boolean state

Parameters

state

The state to use (1 == on, 0 == off)