~~Title: Efl.Ui.Radio_Group~~
====== Efl.Ui.Radio_Group (interface) ======

===== Description =====

%%Interface for manually handling a group of %%[[:develop:api:efl:ui:radio|Efl.Ui.Radio]]%% buttons.%%

%%See the documentation of %%[[:develop:api:efl:ui:radio|Efl.Ui.Radio]]%% for an explanation of radio button grouping.%%

//Since 1.23//

{{page>:develop:api-include:efl:ui:radio_group:description&nouser&nolink&nodate}}

===== Inheritance =====

 => [[:develop:api:efl:ui:single_selectable|Efl.Ui.Single_Selectable]] //(interface)//
++++ Full hierarchy |

  * [[:develop:api:efl:ui:single_selectable|Efl.Ui.Single_Selectable]] //(interface)//


++++
===== Members =====

**[[:develop:api:efl:ui:radio_group:method:register|register]]**\\
> %%Register a new %%[[:develop:api:efl:ui:radio|Efl.Ui.Radio]]%% button to this group. Keep in mind that registering to a group will only handle button grouping, you still need to add the button to a layout for it to be rendered.%%
<code c>
void efl_ui_radio_group_register(Eo *obj, Efl_Ui_Radio *radio);
</code>
\\
**[[:develop:api:efl:ui:radio_group:property:selected_value|selected_value]]** //**(get, set)**//\\
> %%The value associated with the currently selected button in the group. Give each radio button in the group a different value using %%[[:develop:api:efl:ui:radio:property:state_value|Efl.Ui.Radio.state_value]]%%.%%
<code c>
int efl_ui_radio_group_selected_value_get(const Eo *obj);
void efl_ui_radio_group_selected_value_set(Eo *obj, int selected_value);
</code>
\\
**[[:develop:api:efl:ui:radio_group:method:unregister|unregister]]**\\
> %%Unregister an %%[[:develop:api:efl:ui:radio|Efl.Ui.Radio]]%% button from this group. This will unlink the behavior of this button from the other buttons in the group, but if it still belongs to a layout, it will still be rendered.%%
<code c>
void efl_ui_radio_group_unregister(Eo *obj, Efl_Ui_Radio *radio);
</code>
\\

==== Inherited ====

^ [[:develop:api:efl:ui:single_selectable|Efl.Ui.Single_Selectable]] ^^^
|  | **[[:develop:api:efl:ui:single_selectable:property:fallback_selection|fallback_selection]]** //**(get, set)**// | %%A object that will be selected in case nothing is selected%% |
|  | **[[:develop:api:efl:ui:single_selectable:property:last_selected|last_selected]]** //**(get)**// |  |

===== Events =====

**[[:develop:api:efl:ui:radio_group:event:value_changed|value,changed]]**\\
> %%Emitted each time the %%''selected_value''%% changes. The event information contains the %%[[:develop:api:efl:ui:radio:property:state_value|Efl.Ui.Radio.state_value]]%% of the newly selected button or -1 if no button is now selected.%%
<code c>
EFL_UI_RADIO_GROUP_EVENT_VALUE_CHANGED(int)
</code>
\\ ==== Inherited ====

^ [[:develop:api:efl:ui:single_selectable|Efl.Ui.Single_Selectable]] ^^^
|  | **[[:develop:api:efl:ui:single_selectable:event:selection_changed|selection_changed]]** | %%Emitted when there is a change in the selection state. This event will collect all the item selection change events that are happening within one loop iteration. This means, you will only get this event once, even if a lot of items have changed. If you are interested in detailed changes, subscribe to the individual %%[[:develop:api:efl:ui:selectable:event:selected,changed|Efl.Ui.Selectable.selected,changed]]%% events of each item.%% |