Spec-Zone.ru › GTK 4.0

GtkListItem

GtkListItem — Объект, используемый для представления элементов списка модели

Функции

gpointer gtk_list_item_get_item ()
guint gtk_list_item_get_position ()
GtkWidget * gtk_list_item_get_child ()
void gtk_list_item_set_child ()
gboolean gtk_list_item_get_selected ()
gboolean gtk_list_item_get_selectable ()
void gtk_list_item_set_selectable ()
gboolean gtk_list_item_get_activatable ()
void gtk_list_item_set_activatable ()

Свойства

gboolean activatable Чтение / Запись
GtkWidget * child Чтение / Запись
GObject * item Чтение
guint position Чтение
gboolean selectable Чтение / Запись
gboolean selected Чтение

Типы и значения

GtkListItem

Иерархия объектов

    GObject
    ╰── GtkListItem

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkListItem — это объект, который контейнеры для обработки списков, такие как GtkListView, используют для представления элементов в GListModel. Они управляются контейнером и не могут быть созданы кодом приложения.

GtkListItems должны быть заполнены кодом приложения. Это делается путем вызова gtk_list_item_set_child().

GtkListItems существуют в 2 этапах:

  1. Несвязанный этап, когда элемент списка в данный момент не подключен к элементу списка. В этом случае свойство “item” имеет значение NULL.

  2. Связанный этап, когда элемент списка ссылается на элемент из списка. Свойство “item” не NULL.

Функции

gtk_list_item_get_item ()

gpointer
gtk_list_item_get_item (GtkListItem *self);

Получает элемент, который в данный момент отображается в модели, к которой self в настоящее время привязана, или NULL если self не привязана.

Параметры

self

a GtkListItem

Возвращает

Отображаемый элемент.

[nullable][transfer none][type GObject]

gtk_list_item_get_position ()

guint
gtk_list_item_get_position (GtkListItem *self);

Получает позицию в модели, которую self отображает в данный момент. Если self не привязана, возвращается GTK_INVALID_LIST_POSITION.

Параметры

self

a GtkListItem

Возвращает

Позицию этого элемента

gtk_list_item_get_child ()

GtkWidget *
gtk_list_item_get_child (GtkListItem *self);

Получает дочерний элемент, ранее заданный с помощью gtk_list_item_set_child(), или NULL, если он не был задан.

Параметры

self

a GtkListItem

Возвращает

Дочерний элемент.

[transfer none][nullable]

gtk_list_item_set_child ()

void
gtk_list_item_set_child (GtkListItem *self,
                         GtkWidget *child);

Устанавливает дочерний элемент для этого элемента списка.

Эта функция обычно вызывается приложениями при настройке элемента списка, чтобы виджет можно было повторно использовать при его привязке несколько раз.

Параметры

self

a GtkListItem

child

Дочерний элемент элемента списка или NULL для отмены установки.

[nullable]

gtk_list_item_get_selected ()

gboolean
gtk_list_item_get_selected (GtkListItem *self);

Проверяет, отображается ли элемент как выбранный. Состояние выбора сохраняется контейнером и его моделью списка и не может быть установлено иным способом.

Параметры

self

a GtkListItem

Возвращает

TRUE, если элемент выбран.

gtk_list_item_get_selectable ()

gboolean
gtk_list_item_get_selectable (GtkListItem *self);

Проверяет, был ли элемент списка настроен на выбор с помощью gtk_list_item_set_selectable().

Не путайте эту функцию с gtk_list_item_get_selected().

Параметры

self

a GtkListItem

Возвращает

TRUE, если элемент выбираем.

gtk_list_item_set_selectable ()

void
gtk_list_item_set_selectable (GtkListItem *self,
                              gboolean selectable);

Устанавливает self для выбора. Если элемент выбираем, щелчок мышью по элементу или использование клавиатуры попробует выбрать или отменить выбор элемента. Если это удастся, зависит от модели, так как она управляет состоянием выбора.

Обратите внимание, что это означает, что отмена выбора элемента никак не повлияет на состояние выбора. Невыбираемый элемент может все равно быть выбран.

По умолчанию элементы списка выбираемы. При повторной привязке к новому элементу они также будут сброшены до выбираемых GTK.

Параметры

self

a GtkListItem

selectable

если элемент должен быть выбираем

gtk_list_item_get_activatable ()

gboolean
gtk_list_item_get_activatable (GtkListItem *self);

Проверяет, был ли элемент списка настроен на активацию с помощью gtk_list_item_set_activatable().

Параметры

self

a GtkListItem

Возвращает

TRUE, если элемент активируем.

gtk_list_item_set_activatable ()

void
gtk_list_item_set_activatable (GtkListItem *self,
                               gboolean activatable);

Устанавливает self на активацию.

Если элемент активируем, двойной щелчок мышью по элементу, нажатие клавиши Возврат или вызов gtk_widget_activate() активируют элемент. Активация инструктирует содержащий виджет обработать активацию. GtkListView, например, будет испускать сигнал “activate”.

По умолчанию элементы списка активируемы.

Параметры

self

a GtkListItem

activatable

если элемент должен быть активируемым

Типы и значения

GtkListItem

typedef struct _GtkListItem GtkListItem;

Подробное описание свойств

Свойство “activatable”

  “activatable”              gboolean

Если элемент может быть активирован пользователем

Владелец: GtkListItem

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “child”

  “child”                    GtkWidget *

Виджет, используемый для отображения

Владелец: GtkListItem

Флаги: Чтение / Запись

Свойство “item”

  “item”                     GObject *

Отображаемый элемент

Владелец: GtkListItem

Флаги: Чтение

Свойство “position”

  “position”                 guint

Позиция элемента

Владелец: GtkListItem

Флаги: Чтение

Значение по умолчанию: 4294967295

Свойство “selectable”

  “selectable”               gboolean

Если элемент может быть выбран пользователем

Владелец: GtkListItem

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “selected”

  “selected”                 gboolean

Если элемент в данный момент выбран

Владелец: GtkListItem

Флаги: Чтение

Значение по умолчанию: FALSE

См. также

GtkListView, GListModel

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkListItem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API