Gtk.ListBoxRow¶

Subclasses:: None

Methods¶

Inherited:: Gtk.Bin (1), Gtk.Container (35), Gtk.Widget (278), GObject.Object (37), Gtk.Buildable (10), Gtk.Actionable (5)
Structs:: Gtk.ContainerClass (5), Gtk.WidgetClass (12), GObject.ObjectClass (5)

class	`new` ()
	`changed` ()
	`get_activatable` ()
	`get_header` ()
	`get_index` ()
	`get_selectable` ()
	`is_selected` ()
	`set_activatable` (activatable)
	`set_header` (header)
	`set_selectable` (selectable)

Virtual Methods¶

Inherited:: Gtk.Container (10), Gtk.Widget (82), GObject.Object (7), Gtk.Buildable (10), Gtk.Actionable (4)

do_activate ()

Properties¶

Inherited:: Gtk.Container (3), Gtk.Widget (39), Gtk.Actionable (2)

Name	Type	Flags	Short Description
`activatable`	`bool`	r/w/en	Whether this row can be activated
`selectable`	`bool`	r/w/en	Whether this row can be selected

Style Properties¶

Inherited:: Gtk.Widget (17)

Signals¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Short Description
`activate`	This is a keybinding signal, which will cause this row to be activated.

Fields¶

Inherited:: Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)

Name	Type	Access	Description
parent_instance	`Gtk.Bin`	r

Class Details¶

class Gtk.ListBoxRow(**kwargs)¶

Bases:: Gtk.Bin, Gtk.Actionable
Abstract:: No
Structure:: Gtk.ListBoxRowClass

classmethod new()[source]¶

Returns:: a new Gtk.ListBoxRow
Return type:: Gtk.Widget

Creates a new Gtk.ListBoxRow, to be used as a child of a Gtk.ListBox.

New in version 3.10.

changed()[source]¶

Marks self as changed, causing any state that depends on this to be updated. This affects sorting, filtering and headers.

Note that calls to this method must be in sync with the data used for the row functions. For instance, if the list is mirroring some external data set, and *two* rows changed in the external data set then when you call Gtk.ListBoxRow.changed() on the first row the sort function must only read the new data for the first of the two changed rows, otherwise the resorting of the rows will be wrong.

This generally means that if you don’t fully control the data model you have to duplicate the data that affects the listbox row functions into the row widgets themselves. Another alternative is to call Gtk.ListBox.invalidate_sort() on any model change, but that is more expensive.

New in version 3.10.

get_activatable()[source]¶

Returns:: True if the row is activatable
Return type:: bool

Gets the value of the Gtk.ListBoxRow :activatable property for this row.

New in version 3.14.

get_header()[source]¶

Returns:: the current header, or None if none
Return type:: Gtk.Widget or None

Returns the current header of the self. This can be used in a Gtk.ListBoxUpdateHeaderFunc to see if there is a header set already, and if so to update the state of it.

New in version 3.10.

get_index()[source]¶

Returns:: the index of the self, or -1 if the self is not in a listbox
Return type:: int

Gets the current index of the self in its Gtk.ListBox container.

New in version 3.10.

get_selectable()[source]¶

Returns:: True if the row is selectable
Return type:: bool

Gets the value of the Gtk.ListBoxRow :selectable property for this row.

New in version 3.14.

is_selected()[source]¶

Returns:: True if self is selected
Return type:: bool

Returns whether the child is currently selected in its Gtk.ListBox container.

New in version 3.14.

set_activatable(activatable)[source]¶

Parameters:: activatable (bool) – True to mark the row as activatable

Set the Gtk.ListBoxRow :activatable property for this row.

New in version 3.14.

set_header(header)[source]¶

Parameters:: header (Gtk.Widget or None) – the header, or None

Sets the current header of the self. This is only allowed to be called from a Gtk.ListBoxUpdateHeaderFunc. It will replace any existing header in the row, and be shown in front of the row in the listbox.

New in version 3.10.

set_selectable(selectable)[source]¶

Parameters:: selectable (bool) – True to mark the row as selectable

Set the Gtk.ListBoxRow :selectable property for this row.

New in version 3.14.

do_activate() virtual¶

Signal Details¶

Gtk.ListBoxRow.signals.activate(list_box_row)¶

Signal Name:: activate
Flags:: RUN_FIRST, ACTION
Parameters:: list_box_row (Gtk.ListBoxRow) – The object which received the signal

This is a keybinding signal, which will cause this row to be activated.

If you want to be notified when the user activates a row (by key or not), use the Gtk.ListBox ::row-activated signal on the row’s parent Gtk.ListBox.

New in version 3.10.

Property Details¶

Gtk.ListBoxRow.props.activatable¶

Name:: activatable
Type:: bool
Default Value:: True
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The property determines whether the Gtk.ListBox ::row-activated signal will be emitted for this row.

New in version 3.14.

Gtk.ListBoxRow.props.selectable¶

Name:: selectable
Type:: bool
Default Value:: True
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The property determines whether this row can be selected.

New in version 3.14.