Tizen Native API
|
Radio is a widget that allows for 1
or more options to be displayed and have the user choose only 1
of them.
![radio_inheritance_tree.png](radio_inheritance_tree.png)
A radio object contains an indicator, an optional Label and an optional icon object. While it's possible to have a group of only one radio, they are normally used in groups of 2
or more.
elm_radio objects are grouped in a slightly different manner compared to other UI toolkits. There is no separate group name/id to remember or manage. The members represent the group there are in. To make a group, use elm_radio_group_add() and pass an existing radio object and the new radio object.
The radio object(s) select one from a set of integer values, so any value they are configuring needs to be mapped to a set of integers. To configure what value that radio object represents, use elm_radio_state_value_set() to set the integer it represents. To set the value the whole group(which one is currently selected) is to indicate use elm_radio_value_set() on any group member, and to get the groups value use elm_radio_value_get(). For convenience the radio objects are also able to directly set an integer(int) to the value that is selected. To specify the pointer to this integer to modify, use elm_radio_value_pointer_set(). The radio objects modify this directly. That implies the pointer must point to a valid memory for as long as the radio objects exist.
This widget inherits from the Layout one, so that all the functions acting on it also work for radio objects.
This widget emits the following signals, besides the ones sent from Layout :
- changed - This is called whenever the user changes the state of one of the radio objects within the group of radio objects that work together.
The default text parts of the radio widget that you can use are:
- "default" - Label of the radio.
The default content parts of the radio widget that you can use are:
- "icon" - An icon of the radio.
Supported common elm_object APIs.
- 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_disabled_set
- elm_object_disabled_get
Functions | |
Evas_Object * | elm_radio_add (Evas_Object *parent) |
Adds a new radio to the parent. | |
void | elm_radio_group_add (Evas_Object *obj, Evas_Object *group) |
Adds this radio to a group of other radio objects. | |
void | elm_radio_state_value_set (Evas_Object *obj, int value) |
Sets the integer value that this radio object represents. | |
int | elm_radio_state_value_get (const Evas_Object *obj) |
Gets the integer value that this radio object represents. | |
void | elm_radio_value_set (Evas_Object *obj, int value) |
Sets the value of the radio group. | |
int | elm_radio_value_get (const Evas_Object *obj) |
Gets the value of the radio group. | |
void | elm_radio_value_pointer_set (Evas_Object *obj, int *valuep) |
Sets a convenience pointer to an integer to change when the radio group value changes. | |
Evas_Object * | elm_radio_selected_object_get (Evas_Object *obj) |
Gets the selected radio object. |
Function Documentation
Evas_Object* elm_radio_add | ( | Evas_Object * | parent | ) |
Adds a new radio to the parent.
- Since :
- 2.3.1
- Parameters:
-
[in] parent The parent object
- Returns:
- The new object, otherwise
NULL
if it cannot be created
void elm_radio_group_add | ( | Evas_Object * | obj, |
Evas_Object * | group | ||
) |
Adds this radio to a group of other radio objects.
- Since :
- 2.3.1
- Remarks:
- Radio objects work in groups. Each member should have a different integer value assigned. In order to have them work as a group, they need to know about each other. This adds the given radio object to the group of which the group object indicated is a member.
- Parameters:
-
[in] obj The radio object [in] group Any object whose group the obj is to join
Gets the selected radio object.
- Since :
- 2.3.1
- Parameters:
-
[in] obj Any radio object (any object of a group)
- Returns:
- The selected radio object
int elm_radio_state_value_get | ( | const Evas_Object * | obj | ) |
Gets the integer value that this radio object represents.
This gets the value of the radio.
- Since :
- 2.3.1
- Parameters:
-
[in] obj The radio object
- Returns:
- The value used if this radio object is selected
- See also:
- elm_radio_value_set()
void elm_radio_state_value_set | ( | Evas_Object * | obj, |
int | value | ||
) |
Sets the integer value that this radio object represents.
This sets the value of the radio.
- Since :
- 2.3.1
- Parameters:
-
[in] obj The radio object [in] value The value to use if this radio object is selected
int elm_radio_value_get | ( | const Evas_Object * | obj | ) |
Gets the value of the radio group.
- Since :
- 2.3.1
- Parameters:
-
[in] obj The radio object (any radio object of the group)
- Returns:
- The integer state
void elm_radio_value_pointer_set | ( | Evas_Object * | obj, |
int * | valuep | ||
) |
Sets a convenience pointer to an integer to change when the radio group value changes.
This sets a pointer to an integer, that, in addition to the radio objects state is also modified directly. To stop setting the object it points to simply use NULL
as the valuep argument. If valuep is not NULL
, then when this is called, the radio objects state is also modified to reflect the value of the integer that valuep points to, just like calling elm_radio_value_set().
- Since :
- 2.3.1
- Parameters:
-
[in] obj The radio object (any object of a group) [out] valuep A pointer to the integer to modify
void elm_radio_value_set | ( | Evas_Object * | obj, |
int | value | ||
) |
Sets the value of the radio group.
This sets the value of the radio group and also sets the value if pointed to, to the value supplied, but does not call any callbacks.
- Since :
- 2.3.1
- Parameters:
-
[in] obj The radio object (any radio object of the group). [in] value The value to use for the group