gtk4::prelude

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

§child

the child widget

source

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

source

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

source

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

source

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

source

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

The default bindings for this signal are all forms of the and Enter keys.

source

fn emit_activate(&self)

source

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

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

source

fn emit_clicked(&self)

source

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

Available on crate feature v4_12 only.
source

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

source

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

source

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

source

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

source

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

Object Safety§

This trait is not object safe.

Implementors§

source§

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