Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkCellRendererCombo

GtkCellRendererCombo Представляет поле со списком в ячейке

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

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

Детали

GtkCellRendererCombo

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