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

#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