ButtonContent

Object Hierarchy:

Description:

[ CCode ( type_id = "adw_button_content_get_type ()" ) ]
public sealed class ButtonContent : Widget, Accessible, Buildable, ConstraintTarget

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 [class@Gtk.Button], [class@Gtk.MenuButton] or [class@SplitButton], when they need to have both an icon and a label, as follows:

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

Namespace: Adw

Package: libadwaita-1

Content:

Properties:

public bool can_shrink { get; set; }
Whether the button can be smaller than the natural size of its contents.
public string icon_name { get; set; }
The name of the displayed icon.
public string label { get; set; }
The displayed label.
public bool use_underline { get; set; }
Whether an underline in the text indicates a mnemonic.

Creation methods:

public ButtonContent ()
Creates a new `AdwButtonContent`.

Methods:

public bool get_can_shrink ()
gets whether the button can be smaller than the natural size of its contents.
public unowned string get_icon_name ()
Gets the name of the displayed icon.
public unowned string get_label ()
Gets the displayed label.
public bool get_use_underline ()
Gets whether an underline in the text indicates a mnemonic.
public void set_can_shrink (bool can_shrink)
Sets whether the button can be smaller than the natural size of its contents.
public void set_icon_name (string icon_name)
Sets the name of the displayed icon.
public void set_label (string label)
Sets the displayed label.
public void set_use_underline (bool use_underline)
Sets whether an underline in the text indicates a mnemonic.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable