GtkCellLayout

GtkCellLayouts как GtkBuildable

Реализации GtkCellLayout, которые также реализуют интерфейс GtkBuildable (GtkCellView, GtkIconView, GtkComboBox, GtkEntryCompletion, GtkTreeViewColumn) принимают GtkCellRenderer объекты в качестве элементов <child> в определениях пользовательского интерфейса. Они поддерживают пользовательский элемент <attributes> для своих дочерних элементов, который может содержать несколько элементов <attribute>. Каждый элемент <attribute> имеет атрибут name, который указывает свойство обработчика ячейки; содержимое элемента — это значение атрибута.

Вот пример фрагмента определения пользовательского интерфейса, задающего атрибуты:

Кроме того, для реализаций GtkCellLayout, которые используют GtkCellArea для размещения ячеек (все GtkCellLayouts в GTK+ используют GtkCellArea), свойства ячеек также могут быть определены в формате, задавая атрибут <cell-packing>, который может содержать несколько элементов <property>, определенных обычным способом.

Вот фрагмент определения пользовательского интерфейса, задающий свойства ячейки:

Наследование от реализаций GtkCellLayout

При наследовании от виджета, который реализует GtkCellLayout, например, GtkIconView или GtkComboBox, необходимо учитывать тот факт, что эти виджеты используют GtkCellArea внутри.

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

для использования настраиваемой области ячейки с комбинированным полем. Но свойства только для создания инициализируются только после выполнения функций экземпляра init() , что означает, что использование функций, которые полагаются на существование области ячейки в вашей подклассовой функции init() , приведет к созданию по умолчанию области ячейки. В этом случае предоставленное значение свойства создания будет проигнорировано (с предупреждением, чтобы предупредить вас о проблеме).

<object class="GtkCellView">
  <child>
    <object class="GtkCellRendererText"/>
    <attributes>
      <attribute name="text">0</attribute>
    </attributes>
  </child>"
</object>

Если поддержка альтернативных областей ячеек с вашим производным виджетом не важна, то это вас не должно беспокоить. Если вы хотите поддерживать альтернативные области ячеек, вы можете сделать это, вынеся проблемные вызовы из init() в constructor() для вашего класса.

GtkCellLayout

typedef struct _GtkCellLayout GtkCellLayout;

struct GtkCellLayoutIface

struct GtkCellLayoutIface {
  /* Virtual Table */
  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);
  GList* (* get_cells)        (GtkCellLayout         *cell_layout);

  GtkCellArea *(* get_area)   (GtkCellLayout         *cell_layout);
};