GTK+ Reference Manual |
||||
---|---|---|---|---|
GtkCellRendererComboGtkCellRendererCombo Представляет поле со списком в ячейке |
#include <gtk/gtk.h>
GtkCellRendererCombo;
GtkCellRenderer* gtk_cell_renderer_combo_new
(void);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkCellRenderer
+----GtkCellRendererText
+----GtkCellRendererCombo
"has-entry" gboolean : Read / Write
"model" GtkTreeModel : Read / Write
"text-column" gint : Read / Write
GtkCellRendererCombo представляет текст в ячейке как GtkCellRendererText из которого он происходит. Но в то время как GtkCellRendererText предлагает простой ввод для редактирования текста, GtkCellRendererCombo предлагает GtkComboBox или GtkComboBoxEntry виджеты для редактирования текста. Значения отображаемые в поле со списком взяты из древовидной модели определенной в свойстве model.
Комбинированная ячейка представления заботится о добавлении текста ячейки представления в поле со списком и устанавливает отображение столбца определенного свойством text-column. Дальнейшие свойства поля со списком могут быть установлены обработчиком сигнала editing-started.
Объект GtkCellRendererCombo ячейки представления был добавлен в GTK+ 2.6.
typedef struct _GtkCellRendererCombo GtkCellRendererCombo;
gtk_cell_renderer_combo_new ()
GtkCellRenderer* gtk_cell_renderer_combo_new (void);
Создаёт новый GtkCellRendererCombo. Регулирует отображение текста используя свойства объекта. Свойства объекта могут быть установлены глобально(с помощью
g_object_set()
). Кроме того, с помощью GtkTreeViewColumn, вы можете связать свойство со значением в GtkTreeModel. Например, вы можете связать свойство "text" в ячейке представления со значением строки в модели, таким образом представляя различные строки в каждой строке GtkTreeView.
Возвращает : |
Новая ячейка представления |
Начиная с версии 2.6
has-entry
""has-entry" gboolean : Read / WriteЕсли
TRUE
, ячейка представления будет включать ввод и позволит вводить значения отличающиеся от значений во всплывающем списке.Значение по умолчанию: TRUE
Начиная с версии 2.6
Свойство "
model
""model" GtkTreeModel : Read / WriteДревовидная модель содержащая возможные значения для поля со списком. Используйте свойство text_column для определения столбца содержащего значения.
Начиная с версии 2.6
Свойство "
text-column
""text-column" gint : Read / WriteОпределяет столбец модели который содержит возможные значения для поля со списком. Помните, это относится к модели определенной в свойстве model, а не к модели поддерживаемой деревом просмотра к которому прикреплена ячейка представления.
GtkCellRendererCombo автоматически добавляет текст ячейки представления этого столбца к полю со списком.
Допустимые значения: >= -1
Значение по умолчанию: -1
Начиная с версии 2.6