### Class

# Gtk ListItem

since: 4.0

#### Description [src]

    final class Gtk.ListItem : GObject.Object
    {
      /* No available fields */
    }

`GtkListItem` is used by list widgets to represent items in a `GListModel`.

`GtkListItem` objects are managed by the list widget (with its factory) and cannot be created by applications, but they need to be populated by application code. This is done by calling `gtk_list_item_set_child()`.

`GtkListItem` objects exist in 2 stages:

1. The unbound stage where the listitem is not currently connected to an item in the list. In that case, the `GtkListItem:item` property is set to `NULL`.

2. The bound stage where the listitem references an item from the list. The `GtkListItem:item` property is not `NULL`.

Available since: 4.0

#### Ancestors

- GObject

#### Descendants

- GtkColumnViewCell

#### Instance methods

###### gtk_list_item_get_accessible_description

Gets the accessible description of `self`.

since: 4.12

###### gtk_list_item_get_accessible_label

Gets the accessible label of `self`.

since: 4.12

###### gtk_list_item_get_activatable

Checks if a list item has been set to be activatable via gtk_list_item_set_activatable().

since: 4.0

###### gtk_list_item_get_child

Gets the child previously set via `gtk_list_item_set_child()` or `NULL` if none was set.

since: 4.0

###### gtk_list_item_get_focusable

Checks if a list item has been set to be focusable via gtk_list_item_set_focusable().

since: 4.12

###### gtk_list_item_get_item

Gets the model item that associated with `self`.

since: 4.0

###### gtk_list_item_get_position

Gets the position in the model that `self` currently displays.

since: 4.0

###### gtk_list_item_get_selectable

Checks if a list item has been set to be selectable via gtk_list_item_set_selectable().

since: 4.0

###### gtk_list_item_get_selected

Checks if the item is displayed as selected.

since: 4.0

###### gtk_list_item_set_accessible_description

Sets the accessible description for the list item, which may be used by e.g. screen readers.

since: 4.12

###### gtk_list_item_set_accessible_label

Sets the accessible label for the list item, which may be used by e.g. screen readers.

since: 4.12

###### gtk_list_item_set_activatable

Sets `self` to be activatable.

since: 4.0

###### gtk_list_item_set_child

Sets the child to be used for this listitem.

since: 4.0

###### gtk_list_item_set_focusable

Sets `self` to be focusable.

since: 4.12

###### gtk_list_item_set_selectable

Sets `self` to be selectable.

since: 4.0

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Properties

###### Gtk.ListItem:accessible-description

The accessible description to set on the list item.

since: 4.12

###### Gtk.ListItem:accessible-label

The accessible label to set on the list item.

since: 4.12

###### Gtk.ListItem:activatable

If the item can be activated by the user.

since: 4.0

###### Gtk.ListItem:child

Widget used for display.

since: 4.0

###### Gtk.ListItem:focusable

If the item can be focused with the keyboard.

since: 4.12

###### Gtk.ListItem:item

Displayed item.

since: 4.0

###### Gtk.ListItem:position

Position of the item.

since: 4.0

###### Gtk.ListItem:selectable

If the item can be selected by the user.

since: 4.0

###### Gtk.ListItem:selected

If the item is currently selected.

since: 4.0

#### Signals

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

since: 2.0

#### Class structure

    struct GtkListItemClass {
      /* no available fields */
    }

No description available.