|
Etk_Radio_Button
Detailed Description
The Etk_Radio_Button widget is a toggle-button that belongs to a group in which only one button can be active.
When a radio-button is activated, the other radio-buttons of the same group are deactivated. This way, in a group, only one radio-button can be active.
Radio-buttons are used when the user has to make a choice between several options.
To create several radio-buttons belonging to the same group, you can first call etk_radio_button_new_with_label() to create the first radio-button, and then use etk_radio_button_new_with_label_from_widget() to create the other radio buttons of the group. For example:
- Object Hierarchy:
-
- Properties:
- "group": The group of the radio-button
Type: Pointer (Eina_List **)Access: Read/WriteDefault Value: NULL
Define Documentation
#define ETK_RADIO_BUTTON_TYPE (etk_radio_button_type_get()) |
Gets the type of a radio button
#define ETK_RADIO_BUTTON |
( |
obj |
|
) |
(ETK_OBJECT_CAST((obj), ETK_RADIO_BUTTON_TYPE, Etk_Radio_Button)) |
#define ETK_IS_RADIO_BUTTON |
( |
obj |
|
) |
(ETK_OBJECT_RADIO_TYPE((obj), ETK_RADIO_BUTTON_TYPE)) |
Function Documentation
Etk_Widget * etk_radio_button_new |
( |
Eina_List ** |
group |
) |
|
Creates a new radio-button.
- Parameters:
-
| group | the group to which the radio-button will be added (NULL if the radio-button should create its own group) |
- Returns:
- Returns the new radio-button widget
Creates a new radio-button. It will use the group of another radio-button.
- Parameters:
-
| radio_button | the radio-button whose group will be used by the new radio-button |
- Returns:
- Returns the new radio-button widget
Etk_Widget * etk_radio_button_new_with_label |
( |
const char * |
label, |
|
|
Eina_List ** |
group | |
|
) |
| | |
Creates a new radio-button with a label.
- Parameters:
-
| label | the label |
| group | the group to which the radio-button will be added (NULL if the radio-button should create its own group) |
- Returns:
- Returns the new radio-button widget
Creates a new radio-button with a label. It will use the group of another radio-button.
- Parameters:
-
| label | the label |
| radio_button | the radio-button whose group will be used by the new radio-button |
- Returns:
- Returns the new radio-button widget
void etk_radio_button_group_set |
( |
Etk_Radio_Button * |
radio_button, |
|
|
Eina_List ** |
group | |
|
) |
| | |
Sets the group of the radio-button.
- Parameters:
-
| radio_button | a radio-button |
| group | the group to use |
Gets the group of the radio-button.
- Parameters:
-
| radio_button | a radio-button |
- Returns:
- Returns the group used by the radio-button
|
|