Trait gtk4::prelude::ButtonExt

source ·

pub trait ButtonExt: IsA<Button> + Sealed + 'static {
Show 22 methods    // Provided methods
    fn can_shrink(&self) -> bool { ... }
    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_can_shrink(&self, can_shrink: 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_can_shrink_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId { ... }
    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 { ... }
}

Expand description

Trait containing all Button methods.

§Implementors

Button, LinkButton, LockButton, ToggleButton

Provided Methods§

source

fn can_shrink(&self) -> bool

Available on crate feature v4_12 only.

Retrieves whether the button can be smaller than the natural size of its contents.

§Returns

true if the button can shrink, and false otherwise

source

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

Gets the child widget of @self.

§Returns

the child widget of @self

source

fn has_frame(&self) -> bool

Returns whether the button has a frame.

§Returns

true if the button has a frame

source

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()

source

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.

source

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.

source

fn set_can_shrink(&self, can_shrink: bool)

Available on crate feature v4_12 only.

Sets whether the button size can be smaller than the natural size of its contents.

For text buttons, setting @can_shrink to true will ellipsize the label.

For icons and custom children, this function has no effect.

§`can_shrink`

whether the button can shrink

source

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.