Adap.ButtonContent – libadapta-1 – Vala Binding Reference

Description:

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

A helper widget for creating buttons.

`AdapButtonContent` 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="AdapButtonContent"> <property name="icon-name">document-open-symbolic</property> <property name="label" translatable="yes">_Open</property> < property name="use-underline">True</property> </object> </property> </object> ```

`AdapButtonContent` handles style classes and connecting the mnemonic to the button automatically.

CSS nodes

``` buttoncontent ╰── box ├── image ╰── label ```

`AdapButtonContent`'s CSS node is called `buttoncontent`. It contains a `box` subnode that serves as a container for the `image` and `label` nodes.

When inside a `GtkButton` or `AdapSplitButton`, the button will receive the `.image-text-button` style class. When inside a `GtkMenuButton`, the internal `GtkButton` will receive it instead.

Accessibility

`AdapButtonContent` uses the `GTK_ACCESSIBLE_ROLE_GROUP` role.

Namespace: Adap

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

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:

ButtonContent

Object Hierarchy: