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 | Чтение |
Типы и значения
Иерархия объектов
GObject
╰── GtkListItem
Файлы заголовков
#include <gtk/gtk.h>
Описание
GtkListItem — это объект, который контейнеры для обработки списков, такие как GtkListView, используют для представления элементов в GListModel. Они управляются контейнером и не могут быть созданы кодом приложения.
GtkListItems должны быть заполнены кодом приложения. Это делается путем вызова gtk_list_item_set_child().
GtkListItems существуют в 2 этапах:
Функции
gtk_list_item_get_item ()
gpointer
gtk_list_item_get_item (GtkListItem *self); Получает элемент, который в данный момент отображается в модели, к которой self в настоящее время привязана, или NULL если self не привязана.
Параметры
self |
Возвращает
Отображаемый элемент.
[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 |
Возвращает
Позицию этого элемента
gtk_list_item_get_child ()
GtkWidget *
gtk_list_item_get_child (GtkListItem *self); Получает дочерний элемент, ранее заданный с помощью gtk_list_item_set_child(), или NULL, если он не был задан.
Параметры
self |
Возвращает
Дочерний элемент.
[transfer none][nullable]
gtk_list_item_set_child ()
void gtk_list_item_set_child (GtkListItem *self,GtkWidget *child);
Устанавливает дочерний элемент для этого элемента списка.
Эта функция обычно вызывается приложениями при настройке элемента списка, чтобы виджет можно было повторно использовать при его привязке несколько раз.
Параметры
self | ||
child | Дочерний элемент элемента списка или | [nullable] |
gtk_list_item_get_selected ()
gboolean
gtk_list_item_get_selected (GtkListItem *self); Проверяет, отображается ли элемент как выбранный. Состояние выбора сохраняется контейнером и его моделью списка и не может быть установлено иным способом.
Параметры
self |
Возвращает
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 |
Возвращает
TRUE, если элемент выбираем.
gtk_list_item_set_selectable ()
void gtk_list_item_set_selectable (GtkListItem *self,gboolean selectable);
Устанавливает self для выбора. Если элемент выбираем, щелчок мышью по элементу или использование клавиатуры попробует выбрать или отменить выбор элемента. Если это удастся, зависит от модели, так как она управляет состоянием выбора.
Обратите внимание, что это означает, что отмена выбора элемента никак не повлияет на состояние выбора. Невыбираемый элемент может все равно быть выбран.
По умолчанию элементы списка выбираемы. При повторной привязке к новому элементу они также будут сброшены до выбираемых GTK.
Параметры
self | ||
selectable | если элемент должен быть выбираем |
gtk_list_item_get_activatable ()
gboolean
gtk_list_item_get_activatable (GtkListItem *self); Проверяет, был ли элемент списка настроен на активацию с помощью gtk_list_item_set_activatable().
Параметры
self |
Возвращает
TRUE, если элемент активируем.
gtk_list_item_set_activatable ()
void gtk_list_item_set_activatable (GtkListItem *self,gboolean activatable);
Устанавливает self на активацию.
Если элемент активируем, двойной щелчок мышью по элементу, нажатие клавиши Возврат или вызов gtk_widget_activate() активируют элемент. Активация инструктирует содержащий виджет обработать активацию. GtkListView, например, будет испускать сигнал “activate”.
По умолчанию элементы списка активируемы.
Параметры
self | ||
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