Trait gtk4::prelude::ButtonExt

pub trait ButtonExt: 'static {
    fn child(&self) -> Option<Widget>;
    fn has_frame(&self) -> bool;
    fn icon_name(&self) -> Option<GString>;
    fn label(&self) -> Option<GString>;
    fn uses_underline(&self) -> bool;
    fn set_child(&self, child: Option<&impl IsA<Widget>>);
    fn set_has_frame(&self, has_frame: bool);
    fn set_icon_name(&self, icon_name: &str);
    fn set_label(&self, label: &str);
    fn set_use_underline(&self, use_underline: bool);
    fn connect_activate<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
    fn emit_activate(&self);
    fn connect_clicked<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId;
    fn emit_clicked(&self);
    fn connect_child_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId;
    fn connect_has_frame_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId;
    fn connect_icon_name_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId;
    fn connect_label_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId;
    fn connect_use_underline_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId;
}

Trait containing all Button methods.

Implementors

Button, LinkButton, LockButton, ToggleButton

Required Methods

fn child(&self) -> Option<Widget>

Gets the child widget of @self.

Returns

the child widget of @self

fn has_frame(&self) -> bool

Returns whether the button has a frame.

Returns

true if the button has a frame

fn icon_name(&self) -> Option<GString>

Returns the icon name of the button.

If the icon name has not been set with set_icon_name() the return value will be None. This will be the case if you create an empty button with Button::new() to use as a container.

Returns

The icon name set via set_icon_name()

fn label(&self) -> Option<GString>

Fetches the text from the label of the button.

If the label text has not been set with set_label() the return value will be None. This will be the case if you create an empty button with Button::new() to use as a container.

Returns

The text of the label widget. This string is owned by the widget and must not be modified or freed.

fn uses_underline(&self) -> bool

gets whether underlines are interpreted as mnemonics.

See set_use_underline().

Returns

true if an embedded underline in the button label indicates the mnemonic accelerator keys.

fn set_child(&self, child: Option<&impl IsA<Widget>>)

Sets the child widget of @self.

Note that by using this API, you take full responsibility for setting up the proper accessibility label and description information for @self. Most likely, you’ll either set the accessibility label or description for @self explicitly, or you’ll set a labelled-by or described-by relations from @child to @self.

child

the child widget

fn set_has_frame(&self, has_frame: bool)

Sets the style of the button.

Buttons can have a flat appearance or have a frame drawn around them.

has_frame

whether the button should have a visible frame

fn set_icon_name(&self, icon_name: &str)

Adds a Image with the given icon name as a child.

If @self already contains a child widget, that child widget will be removed and replaced with the image.

icon_name

An icon name

fn set_label(&self, label: &str)

Sets the text of the label of the button to @label.

This will also clear any previously set labels.

label

a string

fn set_use_underline(&self, use_underline: bool)

Sets whether to use underlines as mnemonics.

If true, an underline in the text of the button label indicates the next character should be used for the mnemonic accelerator key.

use_underline

true if underlines in the text indicate mnemonics

fn connect_activate<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Emitted to animate press then release.

This is an action signal. Applications should never connect to this signal, but use the signal::Button::clicked signal.

fn emit_activate(&self)

fn connect_clicked<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Emitted when the button has been activated (pressed and released).

fn emit_clicked(&self)

fn connect_child_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

fn connect_has_frame_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_icon_name_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

fn connect_label_notify<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

fn connect_use_underline_notify<F: Fn(&Self) + 'static>(
    &self,
    f: F
) -> SignalHandlerId

Implementors

impl<O: IsA<Button>> ButtonExt for O