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,
                                                          gint                 *minimum_size,
                                                          gint                 *natural_size);
  void               (* get_preferred_height_for_width)  (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          gint                  width,
                                                          gint                 *minimum_height,
                                                          gint                 *natural_height);
  void               (* get_preferred_height)            (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          gint                 *minimum_size,
                                                          gint                 *natural_size);
  void               (* get_preferred_width_for_height)  (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          gint                  height,
                                                          gint                 *minimum_width,
                                                          gint                 *natural_width);
  void               (* get_aligned_area)                (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
							  GtkCellRendererState  flags,
                                                          const GdkRectangle   *cell_area,
                                                          GdkRectangle         *aligned_area);
  void               (* get_size)                        (GtkCellRenderer      *cell,
                                                          GtkWidget            *widget,
                                                          const GdkRectangle   *cell_area,
                                                          gint                 *x_offset,
                                                          gint                 *y_offset,
                                                          gint                 *width,
                                                          gint                 *height);
  void               (* render)                          (GtkCellRenderer      *cell,
                                                          cairo_t              *cr,
                                                          GtkWidget            *widget,
                                                          const GdkRectangle   *background_area,
                                                          const GdkRectangle   *cell_area,
                                                          GtkCellRendererState  flags);
  gboolean           (* activate)                        (GtkCellRenderer      *cell,
                                                          GdkEvent             *event,
                                                          GtkWidget            *widget,
                                                          const gchar          *path,
                                                          const GdkRectangle   *background_area,
                                                          const GdkRectangle   *cell_area,
                                                          GtkCellRendererState  flags);
  GtkCellEditable *  (* start_editing)                   (GtkCellRenderer      *cell,
                                                          GdkEvent             *event,
                                                          GtkWidget            *widget,
                                                          const gchar          *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 gchar     *path);
};

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

  “cell-background”          char *

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

Владелец: GtkCellRenderer

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

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

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

  “cell-background-gdk”      GdkColor *

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

Владелец: GtkCellRenderer

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

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

  “cell-background-rgba”     GdkRGBA *

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

Владелец: GtkCellRenderer

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

С версии: 3.0

Свойство “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

Выравнивание по оси X.

Владелец: GtkCellRenderer

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

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

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

Свойство “xpad”

  “xpad”                     guint

xpad.

Владелец: GtkCellRenderer

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

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

Свойство “yalign”

  “yalign”                   float

Выравнивание по оси Y.

Владелец: GtkCellRenderer

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

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

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

Свойство “ypad”

  “ypad”                     guint

ypad.

Владелец: GtkCellRenderer

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

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

Сигнал “editing-canceled”

void
user_function (GtkCellRenderer *renderer,
               gpointer         user_data)

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

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

Флаги: Выполнение в первую очередь

С версии: 2.4

Сигнал “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 gchar     *path,
                      gpointer         data)
{
  if (GTK_IS_ENTRY (editable))

    {
      GtkEntry *entry = GTK_ENTRY (editable);

      // ... create a GtkEntryCompletion

      gtk_entry_set_completion (entry, completion);
    }
}

Флаги: Выполнение в первую очередь

С версии: 2.6