GtkComboBox

gtk_combo_box_new ()

GtkWidget *
gtk_combo_box_new (void);

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

Since: 2.4

gtk_combo_box_new_with_entry ()

GtkWidget *
gtk_combo_box_new_with_entry (void);

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

Since: 2.24

gtk_combo_box_new_with_model ()

GtkWidget *
gtk_combo_box_new_with_model (GtkTreeModel *model);

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

Since: 2.4

gtk_combo_box_new_with_model_and_entry ()

GtkWidget *
gtk_combo_box_new_with_model_and_entry
                               (GtkTreeModel *model);

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

Since: 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, выпадающий список находится в табличном режиме.

Since: 2.6

gtk_combo_box_set_wrap_width ()

void
gtk_combo_box_set_wrap_width (GtkComboBox *combo_box,
                              gint width);

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

Since: 2.4

gtk_combo_box_get_row_span_column ()

gint
gtk_combo_box_get_row_span_column (GtkComboBox *combo_box);

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

Since: 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. Столбец пролёта строк содержит целые числа, указывающие, сколько строк должна занимать строка.

Since: 2.4

gtk_combo_box_get_column_span_column ()

gint
gtk_combo_box_get_column_span_column (GtkComboBox *combo_box);

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

Since: 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. Столбец пролёта столбцов содержит целые числа, указывающие, сколько столбцов должна занимать строка.

Since: 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 активного элемента.

Since: 2.4

gtk_combo_box_set_active ()

void
gtk_combo_box_set_active (GtkComboBox *combo_box,
                          gint index_);

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

Since: 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() самостоятельно, если необходимо настроить разные обработчики ячеек для новой модели.

С: 2.4

gtk_combo_box_popup_for_device ()

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

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

С: 3.0

gtk_combo_box_popup ()

void
gtk_combo_box_popup (GtkComboBox *combo_box);

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

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

С: 2.4

gtk_combo_box_popdown ()

void
gtk_combo_box_popdown (GtkComboBox *combo_box);

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

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

С: 2.4

gtk_combo_box_get_popup_accessible ()

AtkObject *
gtk_combo_box_get_popup_accessible (GtkComboBox *combo_box);

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

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

С: 2.6

gtk_combo_box_get_row_separator_func ()

GtkTreeViewRowSeparatorFunc
gtk_combo_box_get_row_separator_func (GtkComboBox *combo_box);

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

[skip]

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

С: 2.6

gtk_combo_box_set_add_tearoffs ()

void
gtk_combo_box_set_add_tearoffs (GtkComboBox *combo_box,
                                gboolean add_tearoffs);

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

С: 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);

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

С: 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