Handy.ActionRow
Description: Reference for Handy.ActionRow

### Class

# HandyActionRow

#### Description [src]

    class Handy.ActionRow : Handy.PreferencesRow {
      parent_instance: HdyPreferencesRow
    }

A `GtkListBoxRow` used to present actions.

The `HdyActionRow` widget can have a title, a subtitle and an icon. The row can receive additional widgets at its end, or prefix widgets at its start.

It is convenient to present a preference and its related actions.

`HdyActionRow` is unactivatable by default, giving it an activatable widget will automatically make it activatable, but unsetting it won’t change the row’s activatability.

## HdyActionRow as GtkBuildable

The `HdyActionRow` implementation of the `GtkBuildable` interface supports adding a child at its end by specifying “suffix” or omitting the “type” attribute of a element.

It also supports adding a child as a prefix widget by specifying “prefix” as the “type” attribute of a element.

## CSS nodes

`HdyActionRow` has a main CSS node with name `row`.

It contains the subnode `box.header` for its main horizontal box, and `box.title` for the vertical box containing the title and subtitle labels.

It contains subnodes `label.title` and `label.subtitle` representing respectively the title label and subtitle label.

Available since: | 1.0

#### Ancestors

- HdyPreferencesRow
- GtkListBoxRow
- GtkBin
- GtkContainer
- GtkWidget
- GInitiallyUnowned
- GObject

#### Implements

- AtkImplementorIface
- GtkActionable
- GtkBuildable

#### Constructors

###### hdy_action_row_new

Creates a new `HdyActionRow`.

Available since: 1.0

#### Instance methods

###### hdy_action_row_activate

Activates `self`.

Available since: 1.0

###### hdy_action_row_add_prefix

Adds a prefix widget to `self`.

Available since: 1.0

###### hdy_action_row_get_activatable_widget

Gets the widget activated when `self` is activated.

Available since: 1.0

###### hdy_action_row_get_icon_name

Gets the icon name for `self`.

Available since: 1.0

###### hdy_action_row_get_subtitle

Gets the subtitle for `self`.

Available since: 1.0

###### hdy_action_row_get_subtitle_lines

Gets the number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.2

###### hdy_action_row_get_title_lines

Gets the number of lines at the end of which the title label will be ellipsized.

Available since: 1.2

###### hdy_action_row_get_use_underline

Gets whether an embedded underline in the title or subtitle indicates a mnemonic.

Available since: 1.0

###### hdy_action_row_set_activatable_widget

Sets the widget to activate when `self` is activated.

Available since: 1.0

###### hdy_action_row_set_icon_name

Sets the icon name for `self`.

Available since: 1.0

###### hdy_action_row_set_subtitle

Sets the subtitle for `self`.

Available since: 1.0

###### hdy_action_row_set_subtitle_lines

Sets the number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.2

###### hdy_action_row_set_title_lines

Sets the number of lines at the end of which the title label will be ellipsized.

Available since: 1.2

###### hdy_action_row_set_use_underline

Sets whether an embedded underline in the title or subtitle indicates a mnemonic.

Available since: 1.0

##### Methods inherited from HdyPreferencesRow (4)

###### hdy_preferences_row_get_title

Gets the title of the preference represented by `self`.

Available since: 1.0

###### hdy_preferences_row_get_use_underline

Gets whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

###### hdy_preferences_row_set_title

Sets the title of the preference represented by `self`.

Available since: 1.0

###### hdy_preferences_row_set_use_underline

Sets whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

#### Properties

###### Handy.ActionRow:activatable-widget

The activatable widget for this row.

Available since: 1.0

###### Handy.ActionRow:icon-name

The icon name for this row.

Available since: 1.0

###### Handy.ActionRow:subtitle

The subtitle for this row.

Available since: 1.0

###### Handy.ActionRow:subtitle-lines

The number of lines at the end of which the subtitle label will be ellipsized.

Available since: 1.2

###### Handy.ActionRow:title-lines

The number of lines at the end of which the title label will be ellipsized.

Available since: 1.2

###### Handy.ActionRow:use-underline

Whether embedded underlines in the title or subtitle indicates a mnemonic.

Available since: 1.0

##### Properties inherited from HdyPreferencesRow (2)

###### Handy.PreferencesRow:title

The title of the preference represented by this row.

Available since: 1.0

###### Handy.PreferencesRow:use-underline

Whether an embedded underline in the title indicates a mnemonic.

Available since: 1.0

#### Signals

###### Handy.ActionRow::activated

This signal is emitted after the row has been activated.

Available since: 1.0

#### Class structure

    struct HandyActionRowClass {
      GtkListBoxRowClass parent_class;
      void (* activate) (
        HdyActionRow* self
      );

    }

###### Class members

`parent_class` |
    GtkListBoxRowClass
| The parent class.
`activate` |
    void (* activate) (
        HdyActionRow* self
      )
| No description available.

#### Virtual methods

###### Handy.ActionRowClass.activate

Activates `self`.

Available since: 1.0