Struct gtk::RadioMenuItem

#[repr(transparent)]
pub struct RadioMenuItem { /* private fields */ }

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

⚠️ The following code is in C ⚠️

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

⚠️ The following code is in plain ⚠️

menuitem
├── radio.left
╰── <child>

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

Implements

RadioMenuItemExt, CheckMenuItemExt, GtkMenuItemExt, BinExt, ContainerExt, WidgetExt, glib::ObjectExt, BuildableExt, ActionableExt, ContainerExtManual, WidgetExtManual, BuildableExtManual

Implementations

impl RadioMenuItem

pub const NONE: Option<&'static RadioMenuItem> = None

pub fn from_widget(group: &impl IsA<RadioMenuItem>) -> RadioMenuItem

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

group

An existing RadioMenuItem

Returns

The new RadioMenuItem

pub fn with_label_from_widget(
    group: &impl IsA<RadioMenuItem>,
    label: Option<&str>
) -> RadioMenuItem

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

group

an existing RadioMenuItem

label

the text for the label

Returns

The new RadioMenuItem

pub fn with_mnemonic_from_widget(
    group: &impl IsA<RadioMenuItem>,
    label: Option<&str>
) -> RadioMenuItem

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

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

group

An existing RadioMenuItem

label

the text of the button, with an underscore in front of the mnemonic character

Returns

The new RadioMenuItem

pub fn builder() -> RadioMenuItemBuilder

Creates a new builder-pattern struct instance to construct RadioMenuItem objects.

This method returns an instance of RadioMenuItemBuilder which can be used to create RadioMenuItem objects.

impl RadioMenuItem

pub fn new() -> Self

Creates a new RadioMenuItem.

group

the group to which the radio menu item is to be attached, or None

Returns

a new RadioMenuItem

pub fn with_label(label: &str) -> Self

Creates a new RadioMenuItem whose child is a simple Label.

group

group the radio menu item is inside, or None

label

the text for the label

Returns

A new RadioMenuItem

pub fn with_mnemonic(label: &str) -> Self

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

group

group the radio menu item is inside, or None

label

the text of the button, with an underscore in front of the mnemonic character

Returns

a new RadioMenuItem

Trait Implementations

impl Clone for RadioMenuItem

fn clone(&self) -> Self

Returns a copy of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RadioMenuItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RadioMenuItem

fn default() -> Self

Returns the “default value” for a type.

impl Display for RadioMenuItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for RadioMenuItem

fn hash<H>(&self, state: &mut H)where
    H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where
    H: Hasher,

Feeds a slice of this type into the given Hasher.

impl Ord for RadioMenuItem

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

const fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

const fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

const fn clamp(self, min: Self, max: Self) -> Selfwhere
    Self: PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for RadioMenuItem

type Parent = CheckMenuItem

impl<OT: ObjectType> PartialEq<OT> for RadioMenuItem

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for RadioMenuItem

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

const fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

const fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

const fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

const fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for RadioMenuItem

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for RadioMenuItem

impl IsA<Actionable> for RadioMenuItem

impl IsA<Bin> for RadioMenuItem

impl IsA<Buildable> for RadioMenuItem

impl IsA<CheckMenuItem> for RadioMenuItem

impl IsA<Container> for RadioMenuItem

impl IsA<MenuItem> for RadioMenuItem

impl IsA<Widget> for RadioMenuItem