GtkComboBox

gtk_combo_box_new ()

GtkWidget *
gtk_combo_box_new (void);

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

С версии: 2.4

gtk_combo_box_new_with_entry ()

GtkWidget *
gtk_combo_box_new_with_entry (void);

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

С версии: 2.24

gtk_combo_box_new_with_model ()

GtkWidget *
gtk_combo_box_new_with_model (GtkTreeModel *model);

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

С версии: 2.4

gtk_combo_box_new_with_model_and_entry ()

GtkWidget *
gtk_combo_box_new_with_model_and_entry
                               (GtkTreeModel *model);

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

С версии: 2.24

gtk_combo_box_new_with_area ()

GtkWidget *
gtk_combo_box_new_with_area (GtkCellArea *area);

Создаёт новую пустую GtkComboBox с использованием area для размещения ячеек.

gtk_combo_box_new_with_area_and_entry ()

GtkWidget *
gtk_combo_box_new_with_area_and_entry (GtkCellArea *area);

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

Новая комбинация будет использовать area для размещения ячеек.

gtk_combo_box_get_wrap_width ()

gint
gtk_combo_box_get_wrap_width (GtkComboBox *combo_box);

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

С версии: 2.6

gtk_combo_box_set_wrap_width ()

void
gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
                              gint width);

Устанавливает ширину выравнивания для combo_box на width . Ширина выравнивания — это предпочтительное количество столбцов, когда всплывающее меню должно быть организовано в таблицу.

С версии: 2.4

gtk_combo_box_get_row_span_column ()

gint
gtk_combo_box_get_row_span_column (GtkComboBox *combo_box);

Возвращает столбец с информацией о пролёте строк для combo_box .

С версии: 2.6

gtk_combo_box_set_row_span_column ()

void
gtk_combo_box_set_row_span_column (GtkComboBox *combo_box,
                                   gint row_span);

Устанавливает столбец с информацией о пролёте строк для combo_box на row_span . Столбец пролёта строк содержит целые числа, указывающие, сколько строк должен занимать элемент.

С версии: 2.4

gtk_combo_box_get_column_span_column ()

gint
gtk_combo_box_get_column_span_column (GtkComboBox *combo_box);

Возвращает столбец с информацией о пролёте столбцов для combo_box .

С версии: 2.6

gtk_combo_box_set_column_span_column ()

void
gtk_combo_box_set_column_span_column (GtkComboBox *combo_box,
                                      gint column_span);

Устанавливает столбец с информацией о пролёте столбцов для combo_box на column_span . Столбец пролёта столбцов содержит целые числа, указывающие, сколько столбцов должен занимать элемент.

С версии: 2.4

gtk_combo_box_get_active ()

gint
gtk_combo_box_get_active (GtkComboBox *combo_box);

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

С версии: 2.4

gtk_combo_box_set_active ()

void
gtk_combo_box_set_active (GtkComboBox *combo_box,
                          gint index_);

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

С: 2.4

gtk_combo_box_get_active_iter ()

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

Устанавливает iter для указания текущего активного элемента, если он существует.

С: 2.4

gtk_combo_box_set_active_iter ()

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

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

С: 2.4

gtk_combo_box_get_id_column ()

gint
gtk_combo_box_get_id_column (GtkComboBox *combo_box);

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

С: 3.0

gtk_combo_box_set_id_column ()

void
gtk_combo_box_set_id_column (GtkComboBox *combo_box,
                             gint id_column);

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

С: 3.0

gtk_combo_box_get_active_id ()

const gchar *
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.

С: 3.0

gtk_combo_box_set_active_id ()

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

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

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

С: 3.0

gtk_combo_box_get_model ()

GtkTreeModel *
gtk_combo_box_get_model (GtkComboBox *combo_box);

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

С: 2.4

gtk_combo_box_set_model ()

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

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

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

Since: 2.4

gtk_combo_box_popup_for_device ()

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

Выводит меню или раскрывающийся список combo_box. Окно всплывающего меню будет захвачено, так что только device и его связанный указатель/клавиатура являются единственными GdkDevices, способными отправлять в него события.

Since: 3.0

gtk_combo_box_popup ()

void
gtk_combo_box_popup (GtkComboBox *combo_box);

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

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

Since: 2.4

gtk_combo_box_popdown ()

void
gtk_combo_box_popdown (GtkComboBox *combo_box);

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

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

Since: 2.4

gtk_combo_box_get_popup_accessible ()

AtkObject *
gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box);

Получает объект доступности, соответствующий всплывающему окну комбинационного поля.

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

Since: 2.6

gtk_combo_box_get_row_separator_func ()

GtkTreeViewRowSeparatorFunc
gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box);

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

[skip]

Since: 2.6

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, разделители не выводятся. Это значение по умолчанию.

Since: 2.6

gtk_combo_box_set_add_tearoffs ()

void
gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
                                gboolean add_tearoffs);

Устанавливает, должен ли всплывающее меню иметь элемент меню с отрывным элементом.

Since: 2.6

gtk_combo_box_get_add_tearoffs ()

gboolean
gtk_combo_box_get_add_tearoffs (GtkComboBox *combo_box);

Получает текущее значение свойства :add-tearoffs.

gtk_combo_box_set_title ()

void
gtk_combo_box_set_title (GtkComboBox *combo_box,
                         const gchar *title);

Устанавливает заголовок меню в режиме отрывного меню.

Since: 2.10

gtk_combo_box_get_title ()

const gchar *
gtk_combo_box_get_title (GtkComboBox *combo_box);

Получает текущее название меню в режиме отрыва. См. gtk_combo_box_set_add_tearoffs().

С версии: 2.10

gtk_combo_box_set_focus_on_click ()

void
gtk_combo_box_set_focus_on_click (GtkComboBox *combo,
                                  gboolean focus_on_click);

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

С версии: 2.6

gtk_combo_box_get_focus_on_click ()

gboolean
gtk_combo_box_get_focus_on_click (GtkComboBox *combo);

Возвращает, получает ли combo box фокус при нажатии мыши. См. gtk_combo_box_set_focus_on_click().

С версии: 2.6

gtk_combo_box_set_button_sensitivity ()

void
gtk_combo_box_set_button_sensitivity (GtkComboBox *combo_box,
                                      GtkSensitivityType sensitivity);

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

С версии: 2.14

gtk_combo_box_get_button_sensitivity ()

GtkSensitivityType
gtk_combo_box_get_button_sensitivity (GtkComboBox *combo_box);

Возвращает, делает ли combo box кнопку раскрывающегося списка активной или нет, когда в модели нет элементов.

С версии: 2.14

gtk_combo_box_get_has_entry ()

gboolean
gtk_combo_box_get_has_entry (GtkComboBox *combo_box);

Возвращает, имеет ли combo box поле ввода.

С версии: 2.24

gtk_combo_box_set_entry_text_column ()

void
gtk_combo_box_set_entry_text_column (GtkComboBox *combo_box,
                                     gint text_column);

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

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

С версии: 2.24

gtk_combo_box_get_entry_text_column ()

gint
gtk_combo_box_get_entry_text_column (GtkComboBox *combo_box);

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

С версии: 2.24

gtk_combo_box_set_popup-fixed-width ()

void
gtk_combo_box_set_popup_fixed_width (GtkComboBox *combo_box,
                                     gboolean fixed);

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

С версии: 3.0

gtk_combo_box_get_popup-fixed-width ()

gboolean
gtk_combo_box_get_popup_fixed_width (GtkComboBox *combo_box);

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

С версии: 3.0