Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties

GtkComboBoxEntry

GtkComboBoxEntry поле ввода текста с выпадающим списком

Краткое описание

#include <gtk/gtk.h> GtkComboBoxEntry; GtkWidget* gtk_combo_box_entry_new (void); GtkWidget* gtk_combo_box_entry_new_with_model (GtkTreeModel *model, gint text_column); GtkWidget* gtk_combo_box_entry_new_text (void); void gtk_combo_box_entry_set_text_column (GtkComboBoxEntry *entry_box, gint text_column); gint gtk_combo_box_entry_get_text_column (GtkComboBoxEntry *entry_box);

Иерархия объектов

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkComboBox +----GtkComboBoxEntry

Осуществляемые интерфейсы

GtkComboBoxEntry осуществляет AtkImplementorIface, GtkCellEditable и GtkCellLayout.

Свойства

"text-column" gint : Read / Write

Описание

GtkComboBoxEntry это виджет который позволяет пользователю выбирать из списка доступных значений или вводить собственное значение. Это очень похоже на GtkComboBox, но отображает выбранное значение с возможностью его редактирования.

В отличие от GtkComboBox, основная модель GtkComboBoxEntry должна всегда иметь текстовую колонку (смотрите gtk_combo_box_entry_set_text_column()), и ввод отображает содержимое текстового столбца в выбранной строке. Для получения текста из ввода, используйте gtk_combo_box_get_active_text().

Сигнал изменения издается при вводе в GtkComboBoxEntry, также как при выборе пункта из списка GtkComboBoxEntry's. Используйте gtk_combo_box_get_active() или gtk_combo_box_get_active_iter() для обнаружения был ли пункт действительно выбран из списка.

Подключайте сигнал активизации GtkEntry (используя gtk_bin_get_child()) для определения когда пользователь действительно прекратит вводить текст.

API для создания простого текстового GtkComboBoxes может быть использовано также для GtkComboBoxEntrys который был создан с помощью gtk_combo_box_entry_new_text().

Детали

GtkComboBoxEntry

typedef struct _GtkComboBoxEntry GtkComboBoxEntry;

gtk_combo_box_entry_new ()

GtkWidget*  gtk_combo_box_entry_new         (void);

Создаёт новый GtkComboBoxEntry который имеет дочерний GtkEntry. После создания, вы должны установить модель используя gtk_combo_box_set_model() и text_column * используя gtk_combo_box_entry_set_text_column().

Возвращает :

Новый GtkComboBoxEntry.

Начиная с версии 2.4


gtk_combo_box_entry_new_with_model ()

GtkWidget* gtk_combo_box_entry_new_with_model (GtkTreeModel *model, gint text_column);

Создаёт новый GtkComboBoxEntry который имеет дочерний GtkEntry и список всплывающих строк. Вы можете получить GtkEntry из GtkComboBoxEntry используя GTK_ENTRY (GTK_BIN (combo_box_entry)->child). Для добавления или удаления строк из списка, просто измените model используя её API для обработки данных.

model :

GtkTreeModel.

text_column :

Столбец в model для получения строк.

Возвращает :

Новый GtkComboBoxEntry.

Начиная с версии 2.4


gtk_combo_box_entry_new_text ()

GtkWidget*  gtk_combo_box_entry_new_text    (void);

Удобная функция которая создаёт изменяемый текст поля со списком, который является GtkComboBoxEntry просто отображающий строки. Если вы используете эту функцию для создания поля со списком, вы должны только манипулировать его источником данных с помощью следующих удобных функций: gtk_combo_box_append_text(), gtk_combo_box_insert_text(), gtk_combo_box_prepend_text() и gtk_combo_box_remove_text().

Возвращает :

Новый текст GtkComboBoxEntry.

Начиная с версии 2.4


gtk_combo_box_entry_set_text_column ()

void gtk_combo_box_entry_set_text_column (GtkComboBoxEntry *entry_box, gint text_column);

Устанавливает модель колонки которая должна использовать entry_box для получения строк text_column.

entry_box :

GtkComboBoxEntry.

text_column :

Колонка в model для получения из неё строк.

Начиная с версии 2.4.


gtk_combo_box_entry_get_text_column ()

gint gtk_combo_box_entry_get_text_column (GtkComboBoxEntry *entry_box);

Возвращает колонку entry_box использует для получения из неё строк.

entry_box :

GtkComboBoxEntry.

Возвращает :

Колонка в источнике данных модели entry_box.

Начиная с версии 2.4

Детали свойств

Свойство "text-column"

  "text-column"          gint                  : Read / Write

Колонка в источнике данных модели для получения из неё строк.

Допустимые значения : >= -1

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

Смотрите также

GtkComboBox