Class
AdwButtonContent
Description [src]
final class Adw.ButtonContent : Gtk.Widget {
/* No available fields */
}
A helper widget for creating buttons.
AdwButtonContent
is a box-like widget with an icon and a label.
It’s intended to be used as a direct child of GtkButton
,
GtkMenuButton
or AdwSplitButton
, when they need to have both an
icon and a label, as follows:
<object class="GtkButton">
<property name="child">
<object class="AdwButtonContent">
<property name="icon-name">document-open-symbolic</property>
<property name="label" translatable="yes">_Open</property>
<property name="use-underline">True</property>
</object>
</property>
</object>
AdwButtonContent
handles style classes and connecting the mnemonic to the
button automatically.
CSS nodes
buttoncontent
├── image
╰── label
AdwButtonContent
‘s CSS node is called buttoncontent
. It contains the
subnodes image
and label
.
When inside a GtkButton
or AdwSplitButton
, the button will receive the
.image-text-button
style class. When inside a GtkMenuButton
, the
internal GtkButton
will receive it instead.
Accessibility
AdwButtonContent
uses the GTK_ACCESSIBLE_ROLE_GROUP
role.
Constructors
adw_button_content_new
Creates a new AdwButtonContent
.
Instance methods
adw_button_content_get_can_shrink
Gets whether the button can be smaller than the natural size of its contents.
Available since: 1.4
adw_button_content_get_icon_name
Gets the name of the displayed icon.
adw_button_content_get_label
Gets the displayed label.
adw_button_content_get_use_underline
Gets whether an underline in the text indicates a mnemonic.
adw_button_content_set_can_shrink
Sets whether the button can be smaller than the natural size of its contents.
Available since: 1.4
adw_button_content_set_icon_name
Sets the name of the displayed icon.
adw_button_content_set_label
Sets the displayed label.
adw_button_content_set_use_underline
Sets whether an underline in the text indicates a mnemonic.
Properties
Adw.ButtonContent:can-shrink
Whether the button can be smaller than the natural size of its contents.
Available since: 1.4
Adw.ButtonContent:icon-name
The name of the displayed icon.
Adw.ButtonContent:label
The displayed label.
Adw.ButtonContent:use-underline
Whether an underline in the text indicates a mnemonic.