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

#include <gtk/gtk.h>


            gtkcelllayout;
            gtkcelllayoutiface;
void        (*gtkcelllayoutdatafunc)        (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gtktreemodel *tree_model,
                                             gtktreeiter *iter,
                                             gpointer data);
void        gtk_cell_layout_pack_start      (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gboolean expand);
void        gtk_cell_layout_pack_end        (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gboolean expand);
void        gtk_cell_layout_reorder         (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gint position);
void        gtk_cell_layout_clear           (gtkcelllayout *cell_layout);
void        gtk_cell_layout_set_attributes  (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             ...);
void        gtk_cell_layout_add_attribute   (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             const gchar *attribute,
                                             gint column);
void        gtk_cell_layout_set_cell_data_func

                                            (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gtkcelllayoutdatafunc func,
                                             gpointer func_data,
                                             gdestroynotify destroy);
void        gtk_cell_layout_clear_attributes

                                            (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell);

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

  ginterface
   +----gtkcelllayout

предпосылки

gtkcelllayout требует gobject.

известные реализации

gtkcelllayout реализован gtkcellview, gtkentrycompletion, gtktreeviewcolumn, gtkcombobox, gtkiconview и gtkcomboboxentry.

описание

gtkcelllayout это интерфейс для реализации всех объектов которые хотят обеспечить gtktreeviewcolumn-подобный api для упаковочных ячеек, установки атрибутов и данных функций.

одной из известных особенностей реализации gtkcelllayout являются атрибуты (attributes). атрибуты позволяют вам устанавливать свойства разными способами. они могут просто устанавливать значения констант как обычные свойства. а так же они могут отображать столбцы основной древовидной модели с помощью gtk_cell_layout_set_attributes(), это значит что значение атрибута может изменяться от ячейки к ячейке, поскольку они представлены ячейкой представления. наконец, можно определить функцию с помощью gtk_cell_layout_set_cell_data_func() которая вызывается для определения значения атрибута для каждой представленной ячейки.

детали

gtkcelllayout

typedef struct _gtkcelllayout gtkcelllayout;

gtkcelllayoutiface

typedef struct {
  gtypeinterface g_iface;

  /* виртуальная таблица */
  void (* pack_start)         (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell,
                               gboolean               expand);
  void (* pack_end)           (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell,
                               gboolean               expand);
  void (* clear)              (gtkcelllayout         *cell_layout);
  void (* add_attribute)      (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell,
                               const gchar           *attribute,
                               gint                   column);
  void (* set_cell_data_func) (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell,
                               gtkcelllayoutdatafunc  func,
                               gpointer               func_data,
                               gdestroynotify         destroy);
  void (* clear_attributes)   (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell);
  void (* reorder)            (gtkcelllayout         *cell_layout,
                               gtkcellrenderer       *cell,
                               gint                   position);
} gtkcelllayoutiface;

gtkcelllayoutdatafunc ()

void        (*gtkcelllayoutdatafunc)        (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gtktreemodel *tree_model,
                                             gtktreeiter *iter,
                                             gpointer data);

функция которая должна установить значение cell_layout's соответствующее ячейки представления.

gtk_cell_layout_pack_start ()

void        gtk_cell_layout_pack_start      (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gboolean expand);

упаковывает cell в начало cell_layout. если expand равен false, то cell не занимает больше пространства чем необходимо. любое свободное пространство распределяется между ячейками для которых expand равен true.

помните, многократное использование той же самой ячейки представления не поддерживается.

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

gtk_cell_layout_pack_end ()

void        gtk_cell_layout_pack_end        (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gboolean expand);

добавляет cell в конец cell_layout. если expand равен false, то cell занимает пространства не больше чем нужно. любое свободное пространство распределяется между ячейками для которых expand равен true.

помните, многократное использование той же самой ячейки представления не поддерживается.

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

gtk_cell_layout_reorder ()

void        gtk_cell_layout_reorder         (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gint position);

пере устанавливает cell в position. помните, cell уже должна быть упакована в cell_layout должным образом.

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

gtk_cell_layout_clear ()

void        gtk_cell_layout_clear           (gtkcelllayout *cell_layout);

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

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

gtk_cell_layout_set_attributes ()

void        gtk_cell_layout_set_attributes  (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             ...);

устанавливает атрибуты в список как атрибуты cell_layout. атрибуты должны быть в attribute/column порядке, как в gtk_cell_layout_add_attribute(). все существующие атрибуты удаляются и переписываются новыми атрибутами.

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

gtk_cell_layout_add_attribute ()

void        gtk_cell_layout_add_attribute   (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             const gchar *attribute,
                                             gint column);

добавляет атрибут отображения для списка в cell_layout. параметр column это столбец в модели из которого получается значение, а attribute это параметр cell для получения значения. так например, если столбец 2 в модели содержит строки, вы могли бы иметь "text" атрибут gtkcellrenderertext получив его значение из столбца 2.

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

gtk_cell_layout_set_cell_data_func ()

void        gtk_cell_layout_set_cell_data_func
                                            (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell,
                                             gtkcelllayoutdatafunc func,
                                             gpointer func_data,
                                             gdestroynotify destroy);

устанавливает gtkcelllayoutdatafunc для использования в cell_layout. эта функция используется вместо стандартных атрибутов отображения для установки значения столбца, и должна устанавливать значение cell_layout's соответствующее ячейки представления. func может быть null для удаления старых значений.

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

gtk_cell_layout_clear_attributes ()

void        gtk_cell_layout_clear_attributes
                                            (gtkcelllayout *cell_layout,
                                             gtkcellrenderer *cell);

очищает все предварительно установленные с помощью gtk_cell_layout_set_attributes() атрибуты.

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