GtkCellRenderer

перечисление GtkCellRendererState

Указывает, как отображать ячейку.

перечисление GtkCellRendererMode

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

структура GtkCellRenderer

struct GtkCellRenderer;

структура GtkCellRendererClass

struct GtkCellRendererClass {
  /* vtable - not signals */
  GtkSizeRequestMode (* get_request_mode)                (GtkCellRenderer      *cell);
  void               (* get_preferred_width)             (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          int                  *minimum_size,
                                                          int                  *natural_size);
  void               (* get_preferred_height_for_width)  (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          int                   width,
                                                          int                  *minimum_height,
                                                          int                  *natural_height);
  void               (* get_preferred_height)            (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          int                  *minimum_size,
                                                          int                  *natural_size);
  void               (* get_preferred_width_for_height)  (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          int                   height,
                                                          int                  *minimum_width,
                                                          int                  *natural_width);
  void               (* get_aligned_area)                (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
							  GtkCellRendererState  flags,
                                                          const GdkRectangle   *cell_area,
                                                          GdkRectangle         *aligned_area);
  void               (* snapshot)                        (GtkCellRenderer      *cell,
                                                          GtkSnapshot          *snapshot,
                                                          GtkWidget            *widget,
                                                          const GdkRectangle   *background_area,
                                                          const GdkRectangle   *cell_area,
                                                          GtkCellRendererState  flags);
  gboolean           (* activate)                        (GtkCellRenderer      *cell,
                                                          GdkEvent             *event,
                                                          GtkWidget            *widget,
                                                          const char           *path,
                                                          const GdkRectangle   *background_area,
                                                          const GdkRectangle   *cell_area,
                                                          GtkCellRendererState  flags);
  GtkCellEditable *  (* start_editing)                   (GtkCellRenderer      *cell,
                                                          GdkEvent             *event,
                                                          GtkWidget            *widget,
                                                          const char           *path,
                                                          const GdkRectangle   *background_area,
                                                          const GdkRectangle   *cell_area,
                                                          GtkCellRendererState  flags);

  /* Signals */
  void (* editing_canceled) (GtkCellRenderer *cell);
  void (* editing_started)  (GtkCellRenderer *cell,
			     GtkCellEditable *editable,
			     const char      *path);
};

Свойство “cell-background”

  “cell-background”          char *

Цвет фона ячейки в виде строки.

Владелец: GtkCellRenderer

Флаги: Запись

Значение по умолчанию: NULL

Свойство “cell-background-rgba”

  “cell-background-rgba”     GdkRGBA *

Фон ячейки в виде GdkRGBA.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Свойство “cell-background-set”

  “cell-background-set”      gboolean

Установлен ли цвет фона ячейки.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “editing”

  “editing”                  gboolean

Находится ли рендерер ячейки в режиме редактирования.

Владелец: GtkCellRenderer

Флаги: Чтение

Значение по умолчанию: FALSE

Свойство “height”

  “height”                   int

Фиксированная высота.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Допустимые значения: >= -1

Значение по умолчанию: -1

Свойство “is-expanded”

  “is-expanded”              gboolean

Строка — это строка раскрытия, и она раскрыта.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “is-expander”

  “is-expander”              gboolean

Строка имеет дочерние элементы.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “mode”

  “mode”                     GtkCellRendererMode

Режим редактирования CellRenderer.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: GTK_CELL_RENDERER_MODE_INERT

Свойство “sensitive”

  “sensitive”                gboolean

Отображать ячейку в активном состоянии.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “visible”

  “visible”                  gboolean

Отображать ячейку.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: TRUE

Свойство “width”

  “width”                    int

Фиксированная ширина.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Допустимые значения: >= -1

Значение по умолчанию: -1

Свойство “xalign”

  “xalign”                   float

Выравнивание по горизонтали.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0.5

Свойство “xpad”

  “xpad”                     guint

Отступ по горизонтали.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: 0

Свойство “yalign”

  “yalign”                   float

Выравнивание по вертикали.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Допустимые значения: [0,1]

Значение по умолчанию: 0.5

Свойство “ypad”

  “ypad”                     guint

Отступ по вертикали.

Владелец: GtkCellRenderer

Флаги: Чтение / Запись

Значение по умолчанию: 0

Сигнал “editing-canceled”

void
user_function (GtkCellRenderer *renderer,
               gpointer         user_data)

Этот сигнал генерируется, когда пользователь отменяет процесс редактирования ячейки. Например, рендерер редактируемой ячейки может быть написан так, чтобы отменять редактирование при нажатии клавиши Escape.

См. также: gtk_cell_renderer_stop_editing().

Флаги: Run First

Сигнал “editing-started”

void
user_function (GtkCellRenderer *renderer,
               GtkCellEditable *editable,
               char            *path,
               gpointer         user_data)

Этот сигнал генерируется, когда ячейка начинает редактироваться. Целевое использование этого сигнала заключается в выполнении специальной настройки editable, например, добавление GtkEntryCompletion или настройка дополнительных столбцов в GtkComboBox.

См. gtk_cell_editable_start_editing() для получения информации о жизненном цикле editable и способе выполнения настройки, который не зависит от renderer.

Обратите внимание, что GTK не гарантирует, что рендереры ячеек будут продолжать использовать тот же виджет для редактирования в будущих выпусках, поэтому вы должны проверить тип editable перед выполнением любой специальной настройки, как показано в следующем примере:

static void
text_editing_started (GtkCellRenderer *cell,
                      GtkCellEditable *editable,
                      const char      *path,
                      gpointer         data)
{
  if (GTK_IS_ENTRY (editable))

    {
      GtkEntry *entry = GTK_ENTRY (editable);

      // ... create a GtkEntryCompletion

      gtk_entry_set_completion (entry, completion);
    }
}

Флаги: Run First