GtkComboBox

gtk_combo_box_new ()

GtkWidget *
gtk_combo_box_new (void);

Создаёт новую пустую GtkComboBox.

gtk_combo_box_new_with_entry ()

GtkWidget *
gtk_combo_box_new_with_entry (void);

Создаёт новую пустую GtkComboBox с элементом ввода.

gtk_combo_box_new_with_model ()

GtkWidget *
gtk_combo_box_new_with_model (GtkTreeModel *model);

Создаёт новую GtkComboBox с моделью, инициализированной до model .

gtk_combo_box_new_with_model_and_entry ()

GtkWidget *
gtk_combo_box_new_with_model_and_entry
                               (GtkTreeModel *model);

Создаёт новую пустую GtkComboBox с элементом ввода и с моделью, инициализированной до model .

gtk_combo_box_get_active ()

int
gtk_combo_box_get_active (GtkComboBox *combo_box);

Возвращает индекс текущего активного элемента или -1, если активного элемента нет. Если модель — не плоская треевая модель, и активный элемент не является непосредственным потомком корня дерева, эта функция возвращает gtk_tree_path_get_indices (path)[0], где path — GtkTreePath активного элемента.

gtk_combo_box_set_active ()

void
gtk_combo_box_set_active (GtkComboBox *combo_box,
                          int index_);

Устанавливает активный элемент combo_box в элемент с индексом index .

gtk_combo_box_get_active_iter ()

gboolean
gtk_combo_box_get_active_iter (GtkComboBox *combo_box,
                               GtkTreeIter *iter);

Устанавливает iter на указание на текущий активный элемент, если активный элемент есть. В противном случае iter остаётся без изменений.

gtk_combo_box_set_active_iter ()

void
gtk_combo_box_set_active_iter (GtkComboBox *combo_box,
                               GtkTreeIter *iter);

Устанавливает текущий активный элемент в тот, который ссылается iter , или отменяет установку активного элемента, если iter является NULL.

gtk_combo_box_get_id_column ()

int
gtk_combo_box_get_id_column (GtkComboBox *combo_box);

Возвращает столбец, который combo_box использует для получения строковых идентификаторов значений.

gtk_combo_box_set_id_column ()

void
gtk_combo_box_set_id_column (GtkComboBox *combo_box,
                             int id_column);

Устанавливает столбец модели, который combo_box должен использовать для получения строковых идентификаторов значений. Столбец id_column в модели combo_box должен быть типа G_TYPE_STRING.

gtk_combo_box_get_active_id ()

const char *
gtk_combo_box_get_active_id (GtkComboBox *combo_box);

Возвращает идентификатор активной строки combo_box . Это значение взято из активной строки и столбца, указанного свойством “id-column” combo_box (см. gtk_combo_box_set_id_column()).

Возвращаемое значение — интернированная строка, что означает, что вы можете сравнивать указатель по значению с другими интернированными строками и что вы не должны освобождать его.

Если свойство “id-column” combo_box не установлено, или если активная строка отсутствует, или если у активной строки есть NULL значение идентификатора, то возвращается NULL.

gtk_combo_box_set_active_id ()

gboolean
gtk_combo_box_set_active_id (GtkComboBox *combo_box,
                             const char *active_id);

Изменяет активную строку combo_box на строку с идентификатором, равным active_id, или отменяет активную строку, если active_id имеет значение NULL. Строки с идентификатором в виде строки NULL нельзя сделать активными с помощью этой функции.

Если свойство “id-column” combo_box не задано или если ни одна строка не имеет заданного идентификатора, функция ничего не делает и возвращает FALSE.

gtk_combo_box_get_model ()

GtkTreeModel *
gtk_combo_box_get_model (GtkComboBox *combo_box);

Возвращает GtkTreeModel, который действует в качестве источника данных для combo_box .

gtk_combo_box_set_model ()

void
gtk_combo_box_set_model (GtkComboBox *combo_box,
                         GtkTreeModel *model);

Устанавливает модель, используемую combo_box, на model. Отменяет ранее установленную модель (если применимо). Если модель NULL, модель будет отменена.

Обратите внимание, что эта функция не очищает обработчики ячеек, необходимо самостоятельно вызвать gtk_cell_layout_clear(), если требуется настроить разные обработчики ячеек для новой модели.

gtk_combo_box_popup ()

void
gtk_combo_box_popup (GtkComboBox *combo_box);

Открывает меню или выпадающий список combo_box.

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

Перед вызовом этой функции combo_box должна быть отображена; в противном случае ничего не произойдёт.

gtk_combo_box_popup_for_device ()

void
gtk_combo_box_popup_for_device (GtkComboBox *combo_box,
                                GdkDevice *device);

Открывает меню combo_box. Обратите внимание, что в настоящее время это не делает ничего с устройством, так как ранее использовалось только для combo-боксов в режиме списка, а они были удалены в GTK 4. Однако оно сохраняется на случай, если подобная функциональность будет добавлена позже.

gtk_combo_box_popdown ()

void
gtk_combo_box_popdown (GtkComboBox *combo_box);

Скрывает меню или выпадающий список combo_box.

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

gtk_combo_box_get_row_separator_func ()

GtkTreeViewRowSeparatorFunc
gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box);

Возвращает текущую функцию разделителя строк.

[skip]

gtk_combo_box_set-row-separator-func ()

void
gtk_combo_box_set_row_separator_func (GtkComboBox *combo_box,
                                      GtkTreeViewRowSeparatorFunc func,
                                      gpointer data,
                                      GDestroyNotify destroy);

Устанавливает функцию разделителя строк, которая используется для определения, следует ли отображать строку в виде разделителя. Если функция разделителя строк NULL, разделители не отображаются. Это значение по умолчанию.

gtk_combo_box_set_button_sensitivity ()

void
gtk_combo_box_set_button_sensitivity (GtkComboBox *combo_box,
                                      GtkSensitivityType sensitivity);

Устанавливает, следует ли кнопке раскрытия combo-бокса быть всегда активной (GTK_SENSITIVITY_ON), никогда не активной (GTK_SENSITIVITY_OFF) или только если для отображения есть хотя бы один элемент (GTK_SENSITIVITY_AUTO).

gtk_combo_box_get_button_sensitivity ()

GtkSensitivityType
gtk_combo_box_get_button_sensitivity (GtkComboBox *combo_box);

Возвращает, устанавливает ли комбинация кнопок чувствительность раскрывающегося списка, когда в модели нет элементов.

gtk_combo_box_get_has_entry ()

gboolean
gtk_combo_box_get_has_entry (GtkComboBox *combo_box);

Возвращает, имеет ли комбинация кнопок поле ввода.

gtk_combo_box_set_entry_text_column ()

void
gtk_combo_box_set_entry_text_column (GtkComboBox *combo_box,
                                     int text_column);

Устанавливает столбец модели, который combo_box должен использовать для получения строк, которые нужно text_column . Столбец text_column в модели combo_box должен быть типа G_TYPE_STRING.

Это актуально только в том случае, если combo_box был создан с “has-entry” в качестве TRUE.

gtk_combo_box_get_entry_text_column ()

int
gtk_combo_box_get_entry_text_column (GtkComboBox *combo_box);

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

gtk_combo_box_set_popup_fixed_width ()

void
gtk_combo_box_set_popup_fixed_width (GtkComboBox *combo_box,
                                     gboolean fixed);

Указывает, должна ли ширина всплывающего окна быть фиксированной, соответствующей выделенной ширине комбинации кнопок.

gtk_combo_box_get_popup_fixed_width ()

gboolean
gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box);

Получает, использует ли всплывающее окно фиксированную ширину, соответствующую выделенной ширине комбинации кнопок.

gtk_combo_box_set_child ()

void
gtk_combo_box_set_child (GtkComboBox *combo_box,
                         GtkWidget *child);

Устанавливает дочерний виджет combo_box .

gtk_combo_box_get_child ()

GtkWidget *
gtk_combo_box_get_child (GtkComboBox *combo_box);

Получает дочерний виджет combo_box .