GtkSingleSelection

gtk_single_selection_new ()

GtkSingleSelection *
gtk_single_selection_new (GListModel *model);

Создаёт новую селекцию для обработки model.

gtk_single_selection_get_model ()

GListModel *
gtk_single_selection_get_model (GtkSingleSelection *self);

Возвращает модель, которую оборачивает self.

gtk_single_selection_set_model ()

void
gtk_single_selection_set_model (GtkSingleSelection *self,
                                GListModel *model);

Устанавливает модель, которую должен обернуть self. Если model равно NULL, self будет пустой.

gtk_single_selection_get_selected ()

guint
gtk_single_selection_get_selected (GtkSingleSelection *self);

Возвращает позицию выбранного элемента. Если элемент не выбран, возвращается GTK_INVALID_LIST_POSITION.

gtk_single_selection_set_selected ()

void
gtk_single_selection_set_selected (GtkSingleSelection *self,
                                   guint position);

Выбирает элемент по заданной позиции.

Если в списке нет элемента по position или указано GTK_INVALID_LIST_POSITION, поведение зависит от значения свойства «autoselect»: если оно установлено, изменение не произойдёт, и старый элемент останется выбранным. Если оно не установлено, выбор будет снят, и ни один элемент не будет выбран.

gtk_single_selection_get_selected_item ()

gpointer
gtk_single_selection_get_selected_item
                               (GtkSingleSelection *self);

Возвращает выбранный элемент.

Если элемент не выбран, возвращается NULL.

gtk_single_selection_get_autoselect ()

gboolean
gtk_single_selection_get_autoselect (GtkSingleSelection *self);

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

gtk_single_selection_set_autoselect ()

void
gtk_single_selection_set_autoselect (GtkSingleSelection *self,
                                     gboolean autoselect);

Если autoselect равно TRUE, self будет обеспечивать, чтобы элемент всегда был выбран. Он будет выбирать новый элемент, когда текущий выбранный элемент удалён, и он запретит снятие выбора с текущего элемента.

gtk_single_selection_get_can_unselect ()

gboolean
gtk_single_selection_get_can_unselect (GtkSingleSelection *self);

Если TRUE, gtk_selection_model_unselect_item() поддерживается и позволяет снять выбор с выбранного элемента.

gtk_single_selection_set_can_unselect ()

void
gtk_single_selection_set_can_unselect (GtkSingleSelection *self,
                                       gboolean can_unselect);

Если TRUE, снятие выбора текущего элемента с помощью gtk_selection_model_unselect_item() поддерживается.

Обратите внимание, что установка «autoselect» приведёт к тому, что снятие выбора не будет работать, поэтому в данном случае устанавливать и то и другое не имеет смысла.

GtkSingleSelection

typedef struct _GtkSingleSelection GtkSingleSelection;

GTK_INVALID_LIST_POSITION

#define GTK_INVALID_LIST_POSITION (G_MAXUINT)

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

Обратитесь к документации каждой функции, чтобы узнать, разрешено ли это значение и что оно делает.

Свойство “autoselect”

  “autoselect”               gboolean

Если выделение элемента всегда происходит автоматически

Владелец: GtkSingleSelection

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

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

Свойство “can-unselect”

  “can-unselect”             gboolean

Разрешено ли снятие выделения с выбранного элемента

Владелец: GtkSingleSelection

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

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

Свойство “model”

  “model”                    GListModel *

Управляемый список (модель)

Владелец: GtkSingleSelection

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

Свойство “selected”

  “selected”                 guint

Позиция выделенного элемента

Владелец: GtkSingleSelection

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

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

Свойство “selected-item”

  “selected-item”            GObject *

Выделенный элемент

Владелец: GtkSingleSelection

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