HdyActionRow as GtkBuildable

The GtkWindow implementation of the GtkBuildable interface supports setting a child at its end by omitting the “type” attribute of a <child> element.

It also supports setting a child as a prefix widget by specifying “prefix” as the “type” attribute of a <child> 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.

hdy_action_row_new ()

GtkWidget *
hdy_action_row_new (void);

Creates a new HdyActionRow.

Since: 0.0.6

hdy_action_row_get_subtitle ()

const gchar *
hdy_action_row_get_subtitle (HdyActionRow *self);

Gets the subtitle for self .

Since: 0.0.6

hdy_action_row_set_subtitle ()

void
hdy_action_row_set_subtitle (HdyActionRow *self,
                             const gchar *subtitle);

Sets the subtitle for self .

Since: 0.0.6

hdy_action_row_get_icon_name ()

const gchar *
hdy_action_row_get_icon_name (HdyActionRow *self);

Gets the icon name for self .

Since: 0.0.6

hdy_action_row_set_icon_name ()

void
hdy_action_row_set_icon_name (HdyActionRow *self,
                              const gchar *icon_name);

Sets the icon name for self .

Since: 0.0.6

hdy_action_row_get_activatable_widget ()

GtkWidget *
hdy_action_row_get_activatable_widget (HdyActionRow *self);

Gets the widget activated when self is activated.

Since: 0.0.7

hdy_action_row_set_activatable_widget ()

void
hdy_action_row_set_activatable_widget (HdyActionRow *self,
                                       GtkWidget *widget);

Sets the widget to activate when self is activated, either by clicking on it, by calling hdy_action_row_activate(), or via mnemonics in the title or the subtitle. See the “use_underline” property to enable mnemonics.

The target widget will be activated by emitting the GtkWidget::mnemonic-activate signal on it.

Since: 0.0.7

hdy_action_row_get_use_underline ()

gboolean
hdy_action_row_get_use_underline (HdyActionRow *self);

Gets whether an embedded underline in the text of the title and subtitle labels indicates a mnemonic. See hdy_action_row_set_use_underline().

Since: 0.0.6

hdy_action_row_set_use_underline ()

void
hdy_action_row_set_use_underline (HdyActionRow *self,
                                  gboolean use_underline);

If true, an underline in the text of the title and subtitle labels indicates the next character should be used for the mnemonic accelerator key.

Since: 0.0.6

hdy_action_row_get_title_lines ()

gint
hdy_action_row_get_title_lines (HdyActionRow *self);

Gets the number of lines at the end of which the title label will be ellipsized. If the value is 0, the number of lines won't be limited.

Since: 1.2

hdy_action_row_set_title_lines ()

void
hdy_action_row_set_title_lines (HdyActionRow *self,
                                gint title_lines);

Sets the number of lines at the end of which the title label will be ellipsized. If the value is 0, the number of lines won't be limited.

Since: 1.2

hdy_action_row_get_subtitle_lines ()

gint
hdy_action_row_get_subtitle_lines (HdyActionRow *self);

Gets the number of lines at the end of which the subtitle label will be ellipsized. If the value is 0, the number of lines won't be limited.

Since: 1.2

hdy_action_row_set_subtitle_lines ()

void
hdy_action_row_set_subtitle_lines (HdyActionRow *self,
                                   gint subtitle_lines);

Sets the number of lines at the end of which the subtitle label will be ellipsized. If the value is 0, the number of lines won't be limited.

Since: 1.2

hdy_action_row_add_prefix ()

void
hdy_action_row_add_prefix (HdyActionRow *self,
                           GtkWidget *widget);

Adds a prefix widget to self .

Since: 0.0.6

hdy_action_row_activate ()

void
hdy_action_row_activate (HdyActionRow *self);

HDY_TYPE_ACTION_ROW

#define HDY_TYPE_ACTION_ROW (hdy_action_row_get_type())

struct HdyActionRowClass

struct HdyActionRowClass {
  /* FIXME This should be HdyPreferencesRowClass but we can't change it without
   * breaking the ABI.
   */
  GtkListBoxRowClass parent_class;

  void (*activate) (HdyActionRow *self);
};

HdyActionRow

typedef struct _HdyActionRow HdyActionRow;

The “activatable-widget” property

  “activatable-widget”       GtkWidget *

The activatable widget for this row.

Flags: Read / Write

Since: 0.0.7

The “icon-name” property

  “icon-name”                gchar *

The icon name for this row.

Flags: Read / Write

Default value: ""

Since: 0.0.6

The “subtitle” property

  “subtitle”                 gchar *

The subtitle for this row.

Flags: Read / Write

Default value: ""

Since: 0.0.6

The “subtitle-lines” property

  “subtitle-lines”           gint

The number of lines at the end of which the subtitle label will be ellipsized. Set this property to 0 if you don't want to limit the number of lines.

Flags: Read / Write

Allowed values: >= 0

Default value: 1

Since: 1.2

The “title-lines” property

  “title-lines”              gint

The number of lines at the end of which the title label will be ellipsized. Set this property to 0 if you don't want to limit the number of lines.

Flags: Read / Write

Allowed values: >= 0

Default value: 1

Since: 1.2

The “use-underline” property

  “use-underline”            gboolean

Whether an embedded underline in the text of the title and subtitle labels indicates a mnemonic.

Flags: Read / Write

Default value: FALSE

Since: 0.0.6

The “activated” signal

void
user_function (HdyActionRow *self,
               gpointer      user_data)

This signal is emitted after the row has been activated.

Flags: Run Last

Since: 1.0