Index

Package: Radio_Button

Description

package Gtk.Radio_Button is

A Gtk_Radio_Button is a simple button that has two states, like a Gtk_Toggle_Button.

However, Gtk_Radio_Buttons can be grouped together to get a special behavior: only one button in the group can be active at any given time.

Thus, when the user selects one of the buttons from the group, the button that was previously selected is disabled.

The radio buttons always belongs to a group, even if there is only one in this group

Binding from C File version 2.8.17

Screenshot

gtk-radio_button.png
<testgtk>create_radio_button.adb</testgtk>

Classes

Gtk_Radio_Button_Record

type Gtk_Radio_Button_Record is new Check_Button.Gtk_Check_Button_Record
     with private;

Ancestors:

Primitive operations:

Glib.Object.Deallocate (Inherited)
Glib.Object.Notify (Inherited)
Glib.Object.Ref (Inherited)
Glib.Object.Unref (Inherited)
Gtk.Bin.Get_Child (Inherited)
Gtk.Button.Clicked (Inherited)
Gtk.Button.Enter (Inherited)
Gtk.Button.Get_Alignment (Inherited)
Gtk.Button.Get_Focus_On_Click (Inherited)
Gtk.Button.Get_Image (Inherited)
Gtk.Button.Get_Image_Position (Inherited)
Gtk.Button.Get_Label (Inherited)
Gtk.Button.Get_Relief (Inherited)
Gtk.Button.Get_Use_Stock (Inherited)
Gtk.Button.Get_Use_Underline (Inherited)
Gtk.Button.Leave (Inherited)
Gtk.Button.Pressed (Inherited)
Gtk.Button.Released (Inherited)
Gtk.Button.Set_Alignment (Inherited)
Gtk.Button.Set_Focus_On_Click (Inherited)
Gtk.Button.Set_Image (Inherited)
Gtk.Button.Set_Image_Position (Inherited)
Gtk.Button.Set_Label (Inherited)
Gtk.Button.Set_Relief (Inherited)
Gtk.Button.Set_Use_Stock (Inherited)
Gtk.Button.Set_Use_Underline (Inherited)
Gtk.Container.Add (Inherited)
Gtk.Container.Check_Resize (Inherited)
Gtk.Container.Child_Get_Property (Inherited)
Gtk.Container.Child_Set_Property (Inherited)
Gtk.Container.Child_Type (Inherited)
Gtk.Container.Forall (Inherited)
Gtk.Container.Foreach (Inherited)
Gtk.Container.Get_Border_Width (Inherited)
Gtk.Container.Get_Children (Inherited)
Gtk.Container.Get_Focus_Chain (Inherited)
Gtk.Container.Get_Focus_Child (Inherited)
Gtk.Container.Get_Focus_Hadjustment (Inherited)
Gtk.Container.Get_Focus_Vadjustment (Inherited)
Gtk.Container.Get_Resize_Mode (Inherited)
Gtk.Container.Propagate_Expose (Inherited)
Gtk.Container.Remove (Inherited)
Gtk.Container.Resize_Children (Inherited)
Gtk.Container.Set_Border_Width (Inherited)
Gtk.Container.Set_Focus_Chain (Inherited)
Gtk.Container.Set_Focus_Child (Inherited)
Gtk.Container.Set_Focus_Hadjustment (Inherited)
Gtk.Container.Set_Focus_Vadjustment (Inherited)
Gtk.Container.Set_Reallocate_Redraws (Inherited)
Gtk.Container.Set_Resize_Mode (Inherited)
Gtk.Container.Unset_Focus_Chain (Inherited)
Gtk.Object.Destroy (Inherited)
Gtk.Object.Flag_Is_Set (Inherited)
Gtk.Object.Flags (Inherited)
Gtk.Object.Get_Type (Inherited)
Gtk.Object.Set_Flags (Inherited)
Gtk.Object.Sink (Inherited)
Gtk.Object.Unset_Flags (Inherited)
Gtk.Toggle_Button.Get_Active (Inherited)
Gtk.Toggle_Button.Get_Inconsistent (Inherited)
Gtk.Toggle_Button.Get_Mode (Inherited)
Gtk.Toggle_Button.Set_Active (Inherited)
Gtk.Toggle_Button.Set_Inconsistent (Inherited)
Gtk.Toggle_Button.Set_Mode (Inherited)
Gtk.Toggle_Button.Toggled (Inherited)
Gtk.Widget.Activate (Inherited)
Gtk.Widget.Add_Accelerator (Inherited)
Gtk.Widget.Add_Events (Inherited)
Gtk.Widget.Add_Mnemonic_Label (Inherited)
Gtk.Widget.Can_Activate_Accel (Inherited)
Gtk.Widget.Child_Notify (Inherited)
Gtk.Widget.Class_Path (Inherited)
Gtk.Widget.Class_Path_Reversed (Inherited)
Gtk.Widget.Create_Pango_Context (Inherited)
Gtk.Widget.Create_Pango_Layout (Inherited)
Gtk.Widget.Draw (Inherited)
Gtk.Widget.Ensure_Style (Inherited)
Gtk.Widget.Error_Bell (Inherited)
Gtk.Widget.Freeze_Child_Notify (Inherited)
Gtk.Widget.Get_Allocation_Height (Inherited)
Gtk.Widget.Get_Allocation_Width (Inherited)
Gtk.Widget.Get_Allocation_X (Inherited)
Gtk.Widget.Get_Allocation_Y (Inherited)
Gtk.Widget.Get_Ancestor (Inherited)
Gtk.Widget.Get_Child_Requisition (Inherited)
Gtk.Widget.Get_Child_Visible (Inherited)
Gtk.Widget.Get_Colormap (Inherited)
Gtk.Widget.Get_Composite_Name (Inherited)
Gtk.Widget.Get_Direction (Inherited)
Gtk.Widget.Get_Events (Inherited)
Gtk.Widget.Get_Extension_Events (Inherited)
Gtk.Widget.Get_Has_Tooltip (Inherited)
Gtk.Widget.Get_Name (Inherited)
Gtk.Widget.Get_No_Show_All (Inherited)
Gtk.Widget.Get_Pango_Context (Inherited)
Gtk.Widget.Get_Parent (Inherited)
Gtk.Widget.Get_Parent_Window (Inherited)
Gtk.Widget.Get_Pointer (Inherited)
Gtk.Widget.Get_Root_Window (Inherited)
Gtk.Widget.Get_Size_Request (Inherited)
Gtk.Widget.Get_Snapshot (Inherited)
Gtk.Widget.Get_State (Inherited)
Gtk.Widget.Get_Style (Inherited)
Gtk.Widget.Get_Tooltip_Markup (Inherited)
Gtk.Widget.Get_Tooltip_Text (Inherited)
Gtk.Widget.Get_Tooltip_Window (Inherited)
Gtk.Widget.Get_Toplevel (Inherited)
Gtk.Widget.Get_Visual (Inherited)
Gtk.Widget.Get_Window (Inherited)
Gtk.Widget.Grab_Default (Inherited)
Gtk.Widget.Grab_Focus (Inherited)
Gtk.Widget.Has_Screen (Inherited)
Gtk.Widget.Hide (Inherited)
Gtk.Widget.Hide_All (Inherited)
Gtk.Widget.Input_Shape_Combine_Mask (Inherited)
Gtk.Widget.Intersect (Inherited)
Gtk.Widget.Is_Ancestor (Inherited)
Gtk.Widget.Is_Composited (Inherited)
Gtk.Widget.Is_Focus (Inherited)
Gtk.Widget.Keynav_Failed (Inherited)
Gtk.Widget.List_Mnemonic_Labels (Inherited)
Gtk.Widget.Map (Inherited)
Gtk.Widget.Mnemonic_Activate (Inherited)
Gtk.Widget.Modify_Base (Inherited)
Gtk.Widget.Modify_Bg (Inherited)
Gtk.Widget.Modify_Cursor (Inherited)
Gtk.Widget.Modify_Fg (Inherited)
Gtk.Widget.Modify_Font (Inherited)
Gtk.Widget.Modify_Text (Inherited)
Gtk.Widget.Path (Inherited)
Gtk.Widget.Path_Reversed (Inherited)
Gtk.Widget.Queue_Clear (Inherited)
Gtk.Widget.Queue_Clear_Area (Inherited)
Gtk.Widget.Queue_Draw (Inherited)
Gtk.Widget.Queue_Draw_Area (Inherited)
Gtk.Widget.Queue_Resize (Inherited)
Gtk.Widget.Queue_Resize_No_Redraw (Inherited)
Gtk.Widget.Realize (Inherited)
Gtk.Widget.Region_Intersect (Inherited)
Gtk.Widget.Remove_Accelerator (Inherited)
Gtk.Widget.Remove_Mnemonic_Label (Inherited)
Gtk.Widget.Render_Icon (Inherited)
Gtk.Widget.Reparent (Inherited)
Gtk.Widget.Reset_Rc_Styles (Inherited)
Gtk.Widget.Reset_Shapes (Inherited)
Gtk.Widget.Restore_Default_Style (Inherited)
Gtk.Widget.Send_Expose (Inherited)
Gtk.Widget.Set_Accel_Path (Inherited)
Gtk.Widget.Set_App_Paintable (Inherited)
Gtk.Widget.Set_Child_Visible (Inherited)
Gtk.Widget.Set_Colormap (Inherited)
Gtk.Widget.Set_Composite_Name (Inherited)
Gtk.Widget.Set_Direction (Inherited)
Gtk.Widget.Set_Double_Buffered (Inherited)
Gtk.Widget.Set_Events (Inherited)
Gtk.Widget.Set_Extension_Events (Inherited)
Gtk.Widget.Set_Has_Tooltip (Inherited)
Gtk.Widget.Set_Name (Inherited)
Gtk.Widget.Set_No_Show_All (Inherited)
Gtk.Widget.Set_Parent (Inherited)
Gtk.Widget.Set_Parent_Window (Inherited)
Gtk.Widget.Set_Redraw_On_Allocate (Inherited)
Gtk.Widget.Set_Scroll_Adjustments (Inherited)
Gtk.Widget.Set_Sensitive (Inherited)
Gtk.Widget.Set_Size_Request (Inherited)
Gtk.Widget.Set_State (Inherited)
Gtk.Widget.Set_Style (Inherited)
Gtk.Widget.Set_Tooltip_Markup (Inherited)
Gtk.Widget.Set_Tooltip_Text (Inherited)
Gtk.Widget.Set_Tooltip_Window (Inherited)
Gtk.Widget.Set_UPosition (Inherited)
Gtk.Widget.Set_USize (Inherited)
Gtk.Widget.Set_Window (Inherited)
Gtk.Widget.Shape_Combine_Mask (Inherited)
Gtk.Widget.Show (Inherited)
Gtk.Widget.Show_All (Inherited)
Gtk.Widget.Show_Now (Inherited)
Gtk.Widget.Size_Allocate (Inherited)
Gtk.Widget.Size_Request (Inherited)
Gtk.Widget.Style_Get_Property (Inherited)
Gtk.Widget.Thaw_Child_Notify (Inherited)
Gtk.Widget.Trigger_Tooltip_Query (Inherited)
Gtk.Widget.Unmap (Inherited)
Gtk.Widget.Unrealize (Inherited)

Types

Gtk_Radio_Button

type Gtk_Radio_Button is access all Gtk_Radio_Button_Record'Class;

Constants & Global variables

Signal_Group_Changed (Glib.Signal_Name)

Signal_Group_Changed : constant Glib.Signal_Name := "group-changed";

Subprograms & Entries

Gtk_New

procedure Gtk_New 
(Radio_Button: out Gtk_Radio_Button;
Group: Widget_SList.GSlist := Widget_SList.Null_List;
Label: UTF8_String := "");

Initialize

procedure Initialize 
(Radio_Button: access Gtk_Radio_Button_Record'Class;
Group: Widget_SList.GSlist;
Label: UTF8_String);
Creates or initializes a new radio button, belonging to Group. If Label is left as the empty string, then the button will not have any child and you are free to put any thing you want in it, including a pixmap. To initialize the group (when creating the first button), leave Group to the Null_List. You can later get the new group that is created with a call to the Group subprogram below.

Gtk_New

procedure Gtk_New 
(Radio_Button: out Gtk_Radio_Button;
Group: Gtk_Radio_Button;
Label: UTF8_String := "");

Initialize

procedure Initialize 
(Radio_Button: access Gtk_Radio_Button_Record'Class;
Group: Gtk_Radio_Button;
Label: UTF8_String);
Creates or initializes a new radio button in the same group as Group. If Label is left as the empty string, Radio_Button is created without any child and you can put whatever you want in it, including a pixmap. To initialize a new group (when creating the first button), you should pass it null or a button that has not been created with Gtk_New, as in the example below.

Gtk_New_With_Mnemonic

procedure Gtk_New_With_Mnemonic 
(Radio_Button: out Gtk_Radio_Button;
Group: Widget_SList.GSlist := Widget_SList.Null_List;
Label: UTF8_String);

Initialize_With_Mnemonic

procedure Initialize_With_Mnemonic 
(Radio_Button: access Gtk_Radio_Button_Record'Class;
Group: Widget_SList.GSlist;
Label: UTF8_String);
Create a new Gtk_Radio_Button containing a Label. The Label is created using Gtk.Label.New_With_Mnemonic, so underscores in Label indicate the mnemonic for the button. To initialize a new group (when creating the first button), you should pass it null or a button that has not been created with Gtk_New, as in the example below.

Gtk_New_With_Mnemonic

procedure Gtk_New_With_Mnemonic 
(Radio_Button: out Gtk_Radio_Button;
Group: Gtk_Radio_Button;
Label: UTF8_String);

Initialize_With_Mnemonic

procedure Initialize_With_Mnemonic 
(Radio_Button: access Gtk_Radio_Button_Record'Class;
Group: Gtk_Radio_Button;
Label: UTF8_String);
Creates or initializes a new radio button in the same group as Group. The label is created using Gtk.Label.New_With_Mnemonic, so underscores in Label indicate the mnemonic for the button. To initialize a new group (when creating the first button), you should pass it null or a button that has not been created with Gtk_New, as in the example below.

Get_Type

function Get_Type return Gtk.Gtk_Type;
Return the internal value associated with a Gtk_Radio_Button.

Set_Group

procedure Set_Group 
(Radio_Button: access Gtk_Radio_Button_Record;
Group: Widget_SList.GSlist);

Get_Group

function Get_Group 
(Radio_Button: access Gtk_Radio_Button_Record) return Widget_SList.GSlist;
Modify the group to which the button belongs. This will not change anything visually. This can be used as an argument to the first version of Gtk_New above, or the list can also be traversed to get all the buttons.

Group

function Group 
(Radio_Button: access Gtk_Radio_Button_Record) return Widget_SList.GSlist renames Get_Group;
pragma Obsolescent;