GtkSelectionModel

gtk_selection_model_is_selected ()

gboolean
gtk_selection_model_is_selected (GtkSelectionModel *model,
                                 guint position);

Проверяет, выбран ли данный элемент.

gtk_selection_model_get_selection ()

GtkBitset *
gtk_selection_model_get_selection (GtkSelectionModel *model);

Получает множество, содержащее все выбранные в данный момент элементы в модели.

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

gtk_selection_model_get_selection_in_range ()

GtkBitset *
gtk_selection_model_get_selection_in_range
                               (GtkSelectionModel *model,
                                guint position,
                                guint n_items);

Получает множество, содержащее значения в диапазоне [position, position + n_items), соответствующие выбранному состоянию элементов в этом диапазоне. Все значения вне этого диапазона не определены.

Эта функция является оптимизацией для gtk_selection_model_get_selection(), когда вас интересует только часть выбранного состояния модели. Типичный случай использования — в ответ на сигнал “selection-changed”.

gtk_selection_model_select_item ()

gboolean
gtk_selection_model_select_item (GtkSelectionModel *model,
                                 guint position,
                                 gboolean unselect_rest);

Запрашивает выбор элемента в модели.

gtk_selection_model_unselect_item ()

gboolean
gtk_selection_model_unselect_item (GtkSelectionModel *model,
                                   guint position);

Запрашивает снятие элемента с выбора в модели.

gtk_selection_model_select_range ()

gboolean
gtk_selection_model_select_range (GtkSelectionModel *model,
                                  guint position,
                                  guint n_items,
                                  gboolean unselect_rest);

Запрашивает выбор диапазона элементов в модели.

gtk_selection_model_unselect_range ()

gboolean
gtk_selection_model_unselect_range (GtkSelectionModel *model,
                                    guint position,
                                    guint n_items);

Запрашивает снятие диапазона элементов с выбора в модели.

gtk_selection_model_select_all ()

gboolean
gtk_selection_model_select_all (GtkSelectionModel *model);

Запрашивает выбор всех элементов в модели.

gtk_selection_model_unselect_all ()

gboolean
gtk_selection_model_unselect_all (GtkSelectionModel *model);

Запрашивает снятие с выбора всех элементов в модели.

gtk_selection_model_set_selection ()

gboolean
gtk_selection_model_set_selection (GtkSelectionModel *model,
                                   GtkBitset *selected,
                                   GtkBitset *mask);

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

Запрашивает обновление состояния выделения всех позиций, указанных в mask, до соответствующего значения в битовой маске selected.

В псевдокоде это выглядит примерно так:

for (i = 0; i < n_items; i++)
  {
    // don't change values not in the mask
    if (!gtk_bitset_contains (mask, i))
      continue;

    if (gtk_bitset_contains (selected, i))
      select_item (i);
    else
      unselect_item (i);
  }

gtk_selection_model_selection_changed (model, first_changed_item, n_changed_items);

mask и selected не должны изменяться. Они могут ссылаться на один и тот же битсет, что означает, что каждый элемент в наборе должен быть выбран.

gtk_selection_model_selection_changed ()

void
gtk_selection_model_selection_changed (GtkSelectionModel *model,
                                       guint position,
                                       guint n_items);

Вспомогательная функция для реализации GtkSelectionModel. Вызывайте ее при изменении выделения для отправки сигнала “selection-changed”.