## Documentation

Table of Contents
Class Inheritance Tree
Widget Screenshots
Package groups

## Index

Package: Radio_Button

- Goto spec source

# 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.

### Screenshot

<testgtk>create_radio_button.adb</testgtk>

# Packages

### Implements_Activatable (new Glib.Types.Implements)

    package Implements_Activatable is new Glib.Types.Implements
         (Gtk.Activatable.Gtk_Activatable, Gtk_Radio_Button_Record, Gtk_Radio_Button);

### Implements_Buildable (new Glib.Types.Implements)

    package Implements_Buildable is new Glib.Types.Implements
         (Gtk.Buildable.Gtk_Buildable, Gtk_Radio_Button_Record, Gtk_Radio_Button);

# Classes

### Gtk_Radio_Button_Record

- Goto declaration in source

    type Gtk_Radio_Button_Record is new Gtk_Check_Button_Record with null record;

#### Ancestors:

Gtk.Check_Button.Gtk_Check_Button_Record
Gtk.Toggle_Button.Gtk_Toggle_Button_Record
Gtk.Button.Gtk_Button_Record
Gtk.Bin.Gtk_Bin_Record
Gtk.Container.Gtk_Container_Record
Gtk.Widget.Gtk_Widget_Record
Glib.Object.GObject_Record

#### Primitive operations:

Do_Set_Related_Action

- To API doc
- To spec

(overriding Gtk.Check_Button.Do_Set_Related_Action)
Get_Group

- To API doc
- To spec

Get_Related_Action

- To API doc
- To spec

(overriding Gtk.Check_Button.Get_Related_Action)
Get_Use_Action_Appearance

- To API doc
- To spec

(overriding Gtk.Check_Button.Get_Use_Action_Appearance)
Glib.Object.Deallocate

- To API doc
- To spec

(Inherited)
Glib.Object.Get_Type

- To API doc
- To spec

(Inherited)
Glib.Object.Notify

- To API doc
- To spec

(Inherited)
Glib.Object.Ref

- To API doc
- To spec

(Inherited)
Glib.Object.Ref_Sink

- To API doc
- To spec

(Inherited)
Glib.Object.Unref

- To API doc
- To spec

(Inherited)
Gtk.Bin.Get_Child

- To API doc
- To spec

(Inherited)
Gtk.Button.Clicked

- To API doc
- To spec

(Inherited)
Gtk.Button.Enter

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Alignment

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Event_Window

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Focus_On_Click

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Image

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Image_Position

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Label

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Relief

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Use_Stock

- To API doc
- To spec

(Inherited)
Gtk.Button.Get_Use_Underline

- To API doc
- To spec

(Inherited)
Gtk.Button.Leave

- To API doc
- To spec

(Inherited)
Gtk.Button.Pressed

- To API doc
- To spec

(Inherited)
Gtk.Button.Released

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Alignment

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Focus_On_Click

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Image

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Image_Position

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Label

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Relief

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Use_Stock

- To API doc
- To spec

(Inherited)
Gtk.Button.Set_Use_Underline

- To API doc
- To spec

(Inherited)
Gtk.Container.Add

- To API doc
- To spec

(Inherited)
Gtk.Container.Check_Resize

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Get_Property

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Set_Property

- To API doc
- To spec

(Inherited)
Gtk.Container.Child_Type

- To API doc
- To spec

(Inherited)
Gtk.Container.Forall

- To API doc
- To spec

(Inherited)
Gtk.Container.Foreach

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Border_Width

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Children

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Child

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Hadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Focus_Vadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Get_Resize_Mode

- To API doc
- To spec

(Inherited)
Gtk.Container.Propagate_Expose

- To API doc
- To spec

(Inherited)
Gtk.Container.Remove

- To API doc
- To spec

(Inherited)
Gtk.Container.Resize_Children

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Border_Width

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Child

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Hadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Focus_Vadjustment

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Reallocate_Redraws

- To API doc
- To spec

(Inherited)
Gtk.Container.Set_Resize_Mode

- To API doc
- To spec

(Inherited)
Gtk.Container.Unset_Focus_Chain

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Get_Active

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Get_Inconsistent

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Get_Mode

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Set_Active

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Set_Inconsistent

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Set_Mode

- To API doc
- To spec

(Inherited)
Gtk.Toggle_Button.Toggled

- To API doc
- To spec

(Inherited)
Gtk.Widget.Activate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Accelerator

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Add_Mnemonic_Label

- To API doc
- To spec

(Inherited)
Gtk.Widget.Can_Activate_Accel

- To API doc
- To spec

(Inherited)
Gtk.Widget.Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Class_Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Class_Path_Reversed

- To API doc
- To spec

(Inherited)
Gtk.Widget.Create_Pango_Context

- To API doc
- To spec

(Inherited)
Gtk.Widget.Create_Pango_Layout

- To API doc
- To spec

(Inherited)
Gtk.Widget.Destroy

- To API doc
- To spec

(Inherited)
Gtk.Widget.Draw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Ensure_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Error_Bell

- To API doc
- To spec

(Inherited)
Gtk.Widget.Flag_Is_Set

- To API doc
- To spec

(Inherited)
Gtk.Widget.Flags

- To API doc
- To spec

(Inherited)
Gtk.Widget.Freeze_Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Height

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Width

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_X

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Allocation_Y

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Ancestor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Child_Requisition

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Child_Visible

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Colormap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Composite_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Direction

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Extension_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Has_Tooltip

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_No_Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Pango_Context

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Parent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Parent_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Pointer

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Root_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Snapshot

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_State

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Markup

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Tooltip_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Toplevel

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Visual

- To API doc
- To spec

(Inherited)
Gtk.Widget.Get_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Grab_Default

- To API doc
- To spec

(Inherited)
Gtk.Widget.Grab_Focus

- To API doc
- To spec

(Inherited)
Gtk.Widget.Has_Screen

- To API doc
- To spec

(Inherited)
Gtk.Widget.Hide

- To API doc
- To spec

(Inherited)
Gtk.Widget.Hide_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Input_Shape_Combine_Mask

- To API doc
- To spec

(Inherited)
Gtk.Widget.Intersect

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Ancestor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Composited

- To API doc
- To spec

(Inherited)
Gtk.Widget.Is_Focus

- To API doc
- To spec

(Inherited)
Gtk.Widget.Keynav_Failed

- To API doc
- To spec

(Inherited)
Gtk.Widget.List_Mnemonic_Labels

- To API doc
- To spec

(Inherited)
Gtk.Widget.Map

- To API doc
- To spec

(Inherited)
Gtk.Widget.Mnemonic_Activate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Base

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Bg

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Cursor

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Fg

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Font

- To API doc
- To spec

(Inherited)
Gtk.Widget.Modify_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Path_Reversed

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Clear

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Clear_Area

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Draw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Draw_Area

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Resize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Queue_Resize_No_Redraw

- To API doc
- To spec

(Inherited)
Gtk.Widget.Realize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Region_Intersect

- To API doc
- To spec

(Inherited)
Gtk.Widget.Remove_Accelerator

- To API doc
- To spec

(Inherited)
Gtk.Widget.Remove_Mnemonic_Label

- To API doc
- To spec

(Inherited)
Gtk.Widget.Render_Icon

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reparent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reset_Rc_Styles

- To API doc
- To spec

(Inherited)
Gtk.Widget.Reset_Shapes

- To API doc
- To spec

(Inherited)
Gtk.Widget.Restore_Default_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Send_Expose

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Accel_Path

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_App_Paintable

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Child_Visible

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Colormap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Composite_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Direction

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Double_Buffered

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Extension_Events

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Flags

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Has_Tooltip

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Name

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_No_Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Parent

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Parent_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Redraw_On_Allocate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Scroll_Adjustments

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Sensitive

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_State

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Style

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Markup

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Text

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Tooltip_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_UPosition

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_USize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Set_Window

- To API doc
- To spec

(Inherited)
Gtk.Widget.Shape_Combine_Mask

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show_All

- To API doc
- To spec

(Inherited)
Gtk.Widget.Show_Now

- To API doc
- To spec

(Inherited)
Gtk.Widget.Size_Allocate

- To API doc
- To spec

(Inherited)
Gtk.Widget.Size_Request

- To API doc
- To spec

(Inherited)
Gtk.Widget.Style_Get_Property

- To API doc
- To spec

(Inherited)
Gtk.Widget.Thaw_Child_Notify

- To API doc
- To spec

(Inherited)
Gtk.Widget.Trigger_Tooltip_Query

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unmap

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unrealize

- To API doc
- To spec

(Inherited)
Gtk.Widget.Unset_Flags

- To API doc
- To spec

(Inherited)
Set_Group

- To API doc
- To spec

Set_Related_Action

- To API doc
- To spec

(overriding Gtk.Check_Button.Set_Related_Action)
Set_Use_Action_Appearance

- To API doc
- To spec

(overriding Gtk.Check_Button.Set_Use_Action_Appearance)
Sync_Action_Properties

- To API doc
- To spec

(overriding Gtk.Check_Button.Sync_Action_Properties)

# Types

### Gtk_Radio_Button

- Goto declaration in source

    type Gtk_Radio_Button is access all Gtk_Radio_Button_Record'Class;

# Constants & Global variables

### Group_Property

- Goto declaration in source

(Glib.Properties.Property_Object)

    Group_Property : constant Glib.Properties.Property_Object;

### Signal_Group_Changed

- Goto declaration in source

(Glib.Signal_Name)

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

# Subprograms & Entries

### Gtk_New

- Goto spec in source

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

### Initialize

- Goto spec in source

    procedure Initialize (Radio_Button: access Gtk_Radio_Button_Record'Class;Group: Gtk.Widget.Widget_SList.GSList := Widget_SList.Null_List;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. "group": an existing radio button group, or null if you are creating a new group. "label": the text label to display next to the radio button.

### Gtk_New

- Goto spec in source

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

### Initialize

- Goto spec in source

    procedure Initialize (Radio_Button: access Gtk_Radio_Button_Record'Class;Group: Gtk_Radio_Button;Label: UTF8_String := "");

Creates a new Gtk.Radio_Button.Gtk_Radio_Button with a text label, adding it to the same group as Radio_Group_Member. "Group": widget to get radio group from or null "label": a text string to display next to the radio button.

### Gtk_New_With_Mnemonic

- Goto spec in source

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

### Initialize_With_Mnemonic

- Goto spec in source

    procedure Initialize_With_Mnemonic (Radio_Button: access Gtk_Radio_Button_Record'Class;Group: Gtk.Widget.Widget_SList.GSList := Widget_SList.Null_List;Label: UTF8_String);

### Gtk_New_With_Mnemonic

- Goto spec in source

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

### Initialize_With_Mnemonic

- Goto spec in source

    procedure Initialize_With_Mnemonic (Radio_Button: access Gtk_Radio_Button_Record'Class;Group: Gtk_Radio_Button;Label: UTF8_String);

Creates a new Gtk.Radio_Button.Gtk_Radio_Button containing a label. The label will be created using Gtk.Label.Gtk_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. "Group": widget to get radio group from or null "label": the text of the button, with an underscore in front of the mnemonic character

### Get_Type

- Goto spec in source
- Goto body in source

    function Get_Type return Glib.GType;

### Get_Group

- Goto spec in source

    function Get_Group (Radio_Button: access Gtk_Radio_Button_Record) return Gtk.Widget.Widget_SList.GSList;

### Set_Group

- Goto spec in source

    procedure Set_Group (Radio_Button: access Gtk_Radio_Button_Record;Group: Gtk.Widget.Widget_SList.GSList);

Sets a Gtk.Radio_Button.Gtk_Radio_Button's group. It should be noted that this does not change the layout of your interface in any way, so if you are changing the group, it is likely you will need to re-arrange the user interface to reflect these changes. "group": an existing radio button group, such as one returned from Gtk.Radio_Button.Get_Group.

### Do_Set_Related_Action

- Goto spec in source

    procedure Do_Set_Related_Action (Self: access Gtk_Radio_Button_Record;Action: access Gtk.Action.Gtk_Action_Record'Class);

### Get_Related_Action

- Goto spec in source

    function Get_Related_Action (Self: access Gtk_Radio_Button_Record) return Gtk.Action.Gtk_Action;

### Set_Related_Action

- Goto spec in source

    procedure Set_Related_Action (Self: access Gtk_Radio_Button_Record;Action: access Gtk.Action.Gtk_Action_Record'Class);

### Get_Use_Action_Appearance

- Goto spec in source

    function Get_Use_Action_Appearance (Self: access Gtk_Radio_Button_Record) return Boolean;

### Set_Use_Action_Appearance

- Goto spec in source

    procedure Set_Use_Action_Appearance (Self: access Gtk_Radio_Button_Record;Use_Appearance: Boolean);

### Sync_Action_Properties

- Goto spec in source

    procedure Sync_Action_Properties (Self: access Gtk_Radio_Button_Record;Action: access Gtk.Action.Gtk_Action_Record'Class);

### +

- Goto spec in source

    function "+" (Widget: access Gtk_Radio_Button_Record'Class) return Gtk.Activatable.Gtk_Activatable renames Implements_Activatable.To_Interface;

### -

- Goto spec in source

    function "-" (Interf: Gtk.Activatable.Gtk_Activatable) return Gtk_Radio_Button renames Implements_Activatable.To_Object;

### +

- Goto spec in source

    function "+" (Widget: access Gtk_Radio_Button_Record'Class) return Gtk.Buildable.Gtk_Buildable renames Implements_Buildable.To_Interface;

### -

- Goto spec in source

    function "-" (Interf: Gtk.Buildable.Gtk_Buildable) return Gtk_Radio_Button renames Implements_Buildable.To_Object;