gtk.RadioMenuItem — a choice from multiple check menu items.


class gtk.RadioMenuItem(gtk.CheckMenuItem):
    gtk.RadioMenuItem(group=None, label=None, use_underline=True)
def get_group()
def set_group(group)


+-- gobject.GObject
  +-- gtk.Object
    +-- gtk.Widget
      +-- gtk.Container
        +-- gtk.Bin
          +-- gtk.Item
            +-- gtk.MenuItem
              +-- gtk.CheckMenuItem
                +-- gtk.RadioMenuItem

Implemented Interfaces

gtk.RadioMenuItem implements gtk.Buildable

gtk.RadioMenuItem Properties

gtk.Object Properties

gtk.Widget Properties

gtk.Container Properties

gtk.CheckMenuItem Properties

"group"WriteThe radio menu item whose group this widget belongs to. This property is available in GTK+ 2.8 and above.

gtk.RadioMenuItem Style Properties

gtk.Widget Style Properties

gtk.MenuItem Style Properties

gtk.CheckMenuItem Style Properties

gtk.RadioMenuItem Signal Prototypes

gobject.GObject Signal Prototypes

gtk.Object Signal Prototypes

gtk.Widget Signal Prototypes

gtk.Container Signal Prototypes

gtk.Item Signal Prototypes

gtk.MenuItem Signal Prototypes

gtk.CheckMenuItem Signal Prototypes


def callback(radiomenuitem, user_param1, ...)


A gtk.RadioMenuItem widget is a check menu item that belongs to a group. Only one of the radio menu items in a group can be selected.


    gtk.RadioMenuItem(group=None, label=None, use_underline=True)

group :

a gtk.RadioMenuItem whose group the new radiomenuitem should be added to, or None if a new group should be created

label :

a string to be used as the label text or None if no label is needed

use_underline :

if True, an underscore in the label text indicates the next character should be underlined and used for the mnemonic accelerator key if it is the first character so marked. Available in PyGTK 2.4 and above.

Returns :

a new gtk.RadioMenuItem widget

Creates a new gtk.RadioMenuItem containing a label with its text specified by label. label will be parsed for underscores that indicate the mnemonic accelerator for the radiomenuitem. The radiomenuitem will be added to the group containing the gtk.RadioMenuItem specified by group. If group is None, a new group will be created to hold the new radiomenuitem. If label is None the radiomenuitem is created without a label.

In PyGTK 2.4 and above the use_underline parameter is available and defaults to True. If use_underline is set to False the label text will not be parsed for mnemonic characters.



    def get_group()

Returns :

the list of radiomenuitems in the same group that contains the radiomenuitem

or None

The get_group() method returns the list of gtk.RadioMenuItems that are in the same group as the radiomenuitem or None if the radiomenuitem is not in a group.


    def set_group(group)

group :

a gtk.RadioMenuItem whose group the radiomenuitem will be added to or None.

The set_group() method adds the radiomenuitem to the group of the gtk.RadioMenuItem specified by group.

In PyGTK 2.6.2 and above, if group is None the radiomenuitem will be removed from its current group.


The "group-changed" gtk.RadioMenuItem Signal

    def callback(radiomenuitem, user_param1, ...)

radiomenuitem :

the radiomenuitem that received the signal

user_param1 :

the first user parameter (if any) specified with the connect() method

... :

additional user parameters (if any)


This signal is available in GTK+ 2.4 and above.

The "group-changed" signal is emitted when a gtk.RadioMenuItem is added to or removed from the group.