Gtk.RadioMenuItem

g Atk.ImplementorIface Atk.ImplementorIface Gtk.Widget Gtk.Widget Atk.ImplementorIface->Gtk.Widget GObject.GInterface GObject.GInterface GObject.GInterface->Atk.ImplementorIface Gtk.Actionable Gtk.Actionable GObject.GInterface->Gtk.Actionable Gtk.Activatable Gtk.Activatable GObject.GInterface->Gtk.Activatable Gtk.Buildable Gtk.Buildable GObject.GInterface->Gtk.Buildable GObject.InitiallyUnowned GObject.InitiallyUnowned GObject.InitiallyUnowned->Gtk.Widget GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.MenuItem Gtk.MenuItem Gtk.Actionable->Gtk.MenuItem Gtk.Activatable->Gtk.MenuItem Gtk.Bin Gtk.Bin Gtk.Bin->Gtk.MenuItem Gtk.Buildable->Gtk.Widget Gtk.CheckMenuItem Gtk.CheckMenuItem Gtk.RadioMenuItem Gtk.RadioMenuItem Gtk.CheckMenuItem->Gtk.RadioMenuItem Gtk.Container Gtk.Container Gtk.Container->Gtk.Bin Gtk.MenuItem->Gtk.CheckMenuItem Gtk.Widget->Gtk.Container

Subclasses

None

Methods

Inherited

Gtk.CheckMenuItem (10), Gtk.MenuItem (20), Gtk.Bin (1), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Actionable (5), Gtk.Activatable (6)

Structs

Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class

new (group)

class

new_from_widget (group)

class

new_with_label (group, label)

class

new_with_label_from_widget (group, label)

class

new_with_mnemonic (group, label)

class

new_with_mnemonic_from_widget (group, label)

get_group ()

join_group (group_source)

set_group (group)

Virtual Methods

Inherited

Gtk.CheckMenuItem (2), Gtk.MenuItem (8), Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10), Gtk.Actionable (4), Gtk.Activatable (2)

do_group_changed ()

Properties

Inherited

Gtk.CheckMenuItem (3), Gtk.MenuItem (5), Gtk.Container (3), Gtk.Widget (39), Gtk.Actionable (2), Gtk.Activatable (2)

Name

Type

Flags

Short Description

group

Gtk.RadioMenuItem

w

The radio menu item whose group this widget belongs to.

Style Properties

Inherited

Gtk.CheckMenuItem (1), Gtk.MenuItem (6), Gtk.Widget (17)

Signals

Inherited

Gtk.CheckMenuItem (1), Gtk.MenuItem (6), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name

Short Description

group-changed

Fields

Inherited

Gtk.CheckMenuItem (1), Gtk.MenuItem (6), Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name

Type

Access

Description

check_menu_item

Gtk.CheckMenuItem

r

Class Details

class Gtk.RadioMenuItem(*args, **kwargs)
Bases

Gtk.CheckMenuItem

Abstract

No

Structure

Gtk.RadioMenuItemClass

A radio menu item is a check menu item that belongs to a group. At each instant exactly one of the radio menu items from a group is selected.

The group list does not need to be freed, as each Gtk.RadioMenuItem will remove itself and its list item when it is destroyed.

The correct way to create a group of radio menu items is approximatively this:

How to create a group of radio menu items.
GSList *group = NULL;
GtkWidget *item;
gint i;

for (i = 0; i < 5; i++)
{
  item = gtk_radio_menu_item_new_with_label (group, "This is an example");
  group = gtk_radio_menu_item_get_group (GTK_RADIO_MENU_ITEM (item));
  if (i == 1)
    gtk_check_menu_item_set_active (GTK_CHECK_MENU_ITEM (item), TRUE);
}
CSS nodes
menuitem
├── radio.left
╰── <child>

Gtk.RadioMenuItem has a main CSS node with name menuitem, and a subnode with name radio, which gets the .left or .right style class.

classmethod new(group)[source]
Parameters

group ([Gtk.RadioMenuItem] or None) – the group to which the radio menu item is to be attached, or None

Returns

a new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem.

classmethod new_from_widget(group)[source]
Parameters

group (Gtk.RadioMenuItem or None) – An existing Gtk.RadioMenuItem

Returns

The new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem adding it to the same group as group.

New in version 2.4.

classmethod new_with_label(group, label)[source]
Parameters
Returns

A new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem whose child is a simple Gtk.Label.

classmethod new_with_label_from_widget(group, label)[source]
Parameters
Returns

The new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem whose child is a simple Gtk.Label. The new Gtk.RadioMenuItem is added to the same group as group.

New in version 2.4.

classmethod new_with_mnemonic(group, label)[source]
Parameters
  • group ([Gtk.RadioMenuItem] or None) – group the radio menu item is inside, or None

  • label (str) – the text of the button, with an underscore in front of the mnemonic character

Returns

a new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem containing a label. The label will be created using Gtk.Label.new_with_mnemonic(), so underscores in label indicate the mnemonic for the menu item.

classmethod new_with_mnemonic_from_widget(group, label)[source]
Parameters
Returns

The new Gtk.RadioMenuItem

Return type

Gtk.Widget

Creates a new Gtk.RadioMenuItem containing a label. The label will be created using Gtk.Label.new_with_mnemonic(), so underscores in label indicate the mnemonic for the menu item.

The new Gtk.RadioMenuItem is added to the same group as group.

New in version 2.4.

get_group()[source]
Returns

the group of self

Return type

[Gtk.RadioMenuItem]

Returns the group to which the radio menu item belongs, as a GLib.List of Gtk.RadioMenuItem. The list belongs to GTK+ and should not be freed.

join_group(group_source)[source]
Parameters

group_source (Gtk.RadioMenuItem or None) – a Gtk.RadioMenuItem whose group we are joining, or None to remove the self from its current group

Joins a Gtk.RadioMenuItem object to the group of another Gtk.RadioMenuItem object.

This function should be used by language bindings to avoid the memory manangement of the opaque GLib.SList of Gtk.RadioMenuItem.get_group() and Gtk.RadioMenuItem.set_group().

A common way to set up a group of Gtk.RadioMenuItem instances is:

GtkRadioMenuItem *last_item = NULL;

while ( ...more items to add... )
  {
    GtkRadioMenuItem *radio_item;

    radio_item = gtk_radio_menu_item_new (...);

    gtk_radio_menu_item_join_group (radio_item, last_item);
    last_item = radio_item;
  }

New in version 3.18.

set_group(group)[source]
Parameters

group ([Gtk.RadioMenuItem] or None) – the new group, or None.

Sets the group of a radio menu item, or changes it.

do_group_changed() virtual

Signal Details

Gtk.RadioMenuItem.signals.group_changed(radio_menu_item)
Signal Name

group-changed

Flags

RUN_FIRST

Parameters

radio_menu_item (Gtk.RadioMenuItem) – The object which received the signal

Property Details

Gtk.RadioMenuItem.props.group
Name

group

Type

Gtk.RadioMenuItem

Default Value

None

Flags

WRITABLE

The radio menu item whose group this widget belongs to.

New in version 2.8.