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

#include <gtk/gtk.h>

            gtkcellview;
gtkwidget*  gtk_cell_view_new               (void);
gtkwidget*  gtk_cell_view_new_with_text     (const gchar *text);

gtkwidget*  gtk_cell_view_new_with_markup   (const gchar *markup);
gtkwidget*  gtk_cell_view_new_with_pixbuf   (gdkpixbuf *pixbuf);
void        gtk_cell_view_set_model         (gtkcellview *cell_view,
                                             gtktreemodel *model);
void        gtk_cell_view_set_displayed_row (gtkcellview *cell_view,
                                             gtktreepath *path);

gtktreepath* gtk_cell_view_get_displayed_row
                                            (gtkcellview *cell_view);
gboolean    gtk_cell_view_get_size_of_row   (gtkcellview *cell_view,
                                             gtktreepath *path,
                                             gtkrequisition *requisition);
void        gtk_cell_view_set_background_color

                                            (gtkcellview *cell_view,
                                             const gdkcolor *color);
glist*      gtk_cell_view_get_cell_renderers
                                            (gtkcellview *cell_view);

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

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcellview

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

gtkcellview осуществляет atkimplementoriface и gtkcelllayout.

свойства

  "background"           gchararray            : write
  "background-gdk"       gdkcolor              : read / write
  "background-set"       gboolean              : read / write
  "model"                gtktreemodel          : read / write

описание

gtkcellview отображает единственную строку gtktreemodel, используя отображение ячейки просто как gtktreeview. gtkcellview не поддерживает некоторые более сложные особенности gtktreeview, такие как редактирование ячейки и drag and drop.

детали

gtkcellview

typedef struct _gtkcellview gtkcellview;

gtk_cell_view_new ()

gtkwidget*  gtk_cell_view_new               (void);

создаёт новый виджет gtkcellview.

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

gtk_cell_view_new_with_text ()

gtkwidget*  gtk_cell_view_new_with_text     (const gchar *text);

создаёт новый виджет gtkcellview, добавляет gtkcellrenderertext к нему и заставляет его показывать text.

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

gtk_cell_view_new_with_markup ()

gtkwidget*  gtk_cell_view_new_with_markup   (const gchar *markup);

создаёт новый виджет gtkcellview, добавляет к нему gtkcellrenderertext, и заставляет отображать markup. текст может быть размечен с помощью pango text markup language.

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

gtk_cell_view_new_with_pixbuf ()

gtkwidget*  gtk_cell_view_new_with_pixbuf   (gdkpixbuf *pixbuf);

создаёт новый виджет gtkcellview, добавляет gtkcellrendererpixbuf в него и заставляет отображать pixbuf.

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

gtk_cell_view_set_model ()

void        gtk_cell_view_set_model         (gtkcellview *cell_view,
                                             gtktreemodel *model);

устанавливает модель для cell_view. если cell_view уже имеет установленную модель, то она удаляется перед установкой новой модели. если model равна null, то просто удаляется предустановленная модель.

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

gtk_cell_view_set_displayed_row ()

void        gtk_cell_view_set_displayed_row (gtkcellview *cell_view,
                                             gtktreepath *path);

устанавливает строку модели которая в текущий момент отображается в gtkcellview. если путь не установлен, то содержимое ячейки просмотра "прикрепляется" в последнее значение; это обычно не желательный результат, но может быть необходим промежуточным состояниям, например если модель для gtkcellview стала временно пустой.

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

gtk_cell_view_get_displayed_row ()

gtktreepath* gtk_cell_view_get_displayed_row
                                            (gtkcellview *cell_view);

возвращает gtktreepath относящийся к текущемй отображаемой строке. если нет текущемй отображаемой строки, возвращается null.

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

gtk_cell_view_get_size_of_row ()

gboolean    gtk_cell_view_get_size_of_row   (gtkcellview *cell_view,
                                             gtktreepath *path,
                                             gtkrequisition *requisition);

устанавливает requisition для необходимого размера cell_view отображающего строку модели указанную path.

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

gtk_cell_view_set_background_color ()

void        gtk_cell_view_set_background_color
                                            (gtkcellview *cell_view,
                                             const gdkcolor *color);

устанавливает цвет фона view.

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

gtk_cell_view_get_cell_renderers ()

glist*      gtk_cell_view_get_cell_renderers
                                            (gtkcellview *cell_view);

возвращает ячейку отображения которая добавлена в cell_view.

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

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

свойство "background"

  "background"           gchararray            : write

строка указывающая цвет фона.

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

свойство "background-gdk"

  "background-gdk"       gdkcolor              : read / write

цвет фона как gdkcolor.

свойство "background-set"

  "background-set"       gboolean              : read / write

влияет ли этот тег на цвет фона.

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

свойство "model"

  "model"                gtktreemodel          : read / write

модель для ячейки просмотра

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