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

#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().

начиная с версии 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 для обработки данных.

начиная с версии 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().

начиная с версии 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.

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

gtk_combo_box_entry_get_text_column ()

gint        gtk_combo_box_entry_get_text_column
                                            (gtkcomboboxentry *entry_box);

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

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

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

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

  "text-column"          gint                  : read / write

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

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

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

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

gtkcombobox