GtkCellRenderer

GtkCellRenderer — Объект для отрисовки одной ячейки

Функции

void	gtk_cell_renderer_class_set_accessible_type ()
void	gtk_cell_renderer_get_aligned_area ()
void	gtk_cell_renderer_get_size ()
void	gtk_cell_renderer_render ()
gboolean	gtk_cell_renderer_activate ()
GtkCellEditable *	gtk_cell_renderer_start_editing ()
void	gtk_cell_renderer_stop_editing ()
void	gtk_cell_renderer_get_fixed_size ()
void	gtk_cell_renderer_set_fixed_size ()
gboolean	gtk_cell_renderer_get_visible ()
void	gtk_cell_renderer_set_visible ()
gboolean	gtk_cell_renderer_get_sensitive ()
void	gtk_cell_renderer_set_sensitive ()
void	gtk_cell_renderer_get_alignment ()
void	gtk_cell_renderer_set_alignment ()
void	gtk_cell_renderer_get_padding ()
void	gtk_cell_renderer_set_padding ()
GtkStateFlags	gtk_cell_renderer_get_state ()
gboolean	gtk_cell_renderer_is_activatable ()
void	gtk_cell_renderer_get_preferred_height ()
void	gtk_cell_renderer_get_preferred_height_for_width ()
void	gtk_cell_renderer_get_preferred_size ()
void	gtk_cell_renderer_get_preferred_width ()
void	gtk_cell_renderer_get_preferred_width_for_height ()
GtkSizeRequestMode	gtk_cell_renderer_get_request_mode ()

Свойства

gchar *	cell-background	Запись
GdkColor *	cell-background-gdk	Чтение / Запись
GdkRGBA *	cell-background-rgba	Чтение / Запись
gboolean	cell-background-set	Чтение / Запись
gboolean	editing	Чтение
gint	высота	Чтение / Запись
gboolean	is-expanded	Чтение / Запись
gboolean	is-expander	Чтение / Запись
GtkCellRendererMode	режим	Чтение / Запись
gboolean	активность	Чтение / Запись
gboolean	видимость	Чтение / Запись
gint	ширина	Чтение / Запись
gfloat	выравнивание по X	Чтение / Запись
guint	отступ по X	Чтение / Запись
gfloat	выравнивание по Y	Чтение / Запись
guint	отступ по Y	Чтение / Запись

Сигналы

void	editing-canceled	Запуск вначале
void	editing-started	Запуск вначале

Типы и значения

перечисление	GtkCellRendererState
перечисление	GtkCellRendererMode
структура	GtkCellRenderer
структура	GtkCellRendererClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkCellRenderer
            ├── GtkCellRendererText
            ├── GtkCellRendererPixbuf
            ├── GtkCellRendererProgress
            ├── GtkCellRendererSpinner
            ╰── GtkCellRendererToggle

Файлы включения

#include <gtk/gtk.h>

Описание

Класс GtkCellRenderer — базовый класс набора объектов, используемых для отрисовки ячейки в cairo_t. Эти объекты преимущественно используются виджетом GtkTreeView, хотя они не привязаны к нему каким-либо специфическим образом. Следует отметить, что GtkCellRenderer не является GtkWidget и не может быть обработан как таковой.

Основное назначение GtkCellRenderer — отрисовка определённых графических элементов на cairo_t. Как правило, один объект cell renderer используется для отрисовки множества ячеек на экране. В этой связи не ожидается, что CellRenderer будет хранить какое-либо постоянное состояние. Вместо этого, любое состояние устанавливается непосредственно перед использованием с помощью системы свойств GObjects. Затем, ячейка измеряется с помощью gtk_cell_renderer_get_size(). Наконец, ячейка отрисовывается в правильном месте с помощью gtk_cell_renderer_render().

При написании нового GtkCellRenderer необходимо соблюдать ряд правил. Прежде всего, важно, чтобы определённый набор свойств всегда давал ячейку render одинакового размера, за исключением изменения GtkStyle. GtkCellRenderer также имеет ряд общих свойств, соблюдение которых ожидается от всех наследников.

Помимо простой отрисовки ячейки, renderers ячеек могут по желанию предоставлять активные элементы пользовательского интерфейса. Cell renderer может быть «активируемым», например, GtkCellRendererToggle, который переключается при активации щелчком мыши, или «редактируемым», например, GtkCellRendererText, который позволяет пользователю редактировать текст с помощью GtkEntry. Для того чтобы сделать ячейку render активируемой или редактируемой, необходимо реализовать виртуальные функции GtkCellRendererClass.activate или GtkCellRendererClass.start_editing соответственно.

Многие свойства GtkCellRenderer и его подклассов имеют соответствующее свойство «set», например, «cell-background-set» соответствует «cell-background». Эти свойства «set» отражают установлено или нет соответствующее свойство. Необходимо обращаться к ним в связке.

Функции

gtk_cell_renderer_class_set_accessible_type ()

void
gtk_cell_renderer_class_set_accessible_type
                               (GtkCellRendererClass *renderer_class,
                                GType type);

Устанавливает тип, используемый для создания элементов доступности для ячеек, отрисовываемых обработчиками ячеек renderer_class. Обратите внимание, что будет создано несколько элементов доступности.

Эта функция должна вызываться только из функций инициализации класса обработчиков ячеек.

Параметры

renderer_class	класс, для которого устанавливается тип доступности
type	Тип объекта, реализующего доступность для `widget_class`. Тип должен быть подтипом GtkRendererCellAccessible

gtk_cell_renderer_get_aligned_area ()

void
gtk_cell_renderer_get_aligned_area (GtkCellRenderer *cell,
                                    GtkWidget *widget,
                                    GtkCellRendererState flags,
                                    const GdkRectangle *cell_area,
                                    GdkRectangle *aligned_area);

Получает выровненную область, используемую cell внутри cell_area. Используется для поиска подходящей области редактирования и фокуса.

Параметры

cell	экземпляр GtkCellRenderer
widget	the GtkWidget, на котором будет отрисовываться ячейка
flags	флаги отрисовки
cell_area	область ячейки, которая будет передана в `gtk_cell_renderer_render()`
aligned_area	место возврата для области внутри `cell_area`, которая фактически будет использована для отрисовки.	[out]

С: 3.0

gtk_cell_renderer_get_size ()

void
gtk_cell_renderer_get_size (GtkCellRenderer *cell,
                            GtkWidget *widget,
                            const GdkRectangle *cell_area,
                            gint *x_offset,
                            gint *y_offset,
                            gint *width,
                            gint *height);

gtk_cell_renderer_get_size устарело с версии 3.0 и не должно использоваться в новом коде.

Используйте gtk_cell_renderer_get_preferred_size() вместо этого.

Получает ширину и высоту, необходимые для отрисовки ячейки. Используется виджетами представлений для определения подходящего размера для области ячейки, переданной в gtk_cell_renderer_render(). Если cell_area не NULL, заполняет x и y смещения ячейки относительно этого местоположения.

Обратите внимание, что значения, установленные в width и height, а также в x_offset и y_offset, включают свойства xpad и ypad.

Параметры

cell	a GtkCellRenderer
widget	виджет, в который отрисовывается рендерер
cell_area	Область, которая будет выделена для ячейки, или `NULL`.	[allow-none]
x_offset	место для возврата x смещения ячейки относительно `cell_area`, или `NULL`.	[out][allow-none]
y_offset	место для возврата y смещения ячейки относительно `cell_area`, или `NULL`.	[out][allow-none]
width	место для возврата ширины, необходимой для отрисовки ячейки, или `NULL`.	[out][allow-none]
height	место для возврата высоты, необходимой для отрисовки ячейки, или `NULL`.	[out][allow-none]

gtk_cell_renderer_render ()

void
gtk_cell_renderer_render (GtkCellRenderer *cell,
                          cairo_t *cr,
                          GtkWidget *widget,
                          const GdkRectangle *background_area,
                          const GdkRectangle *cell_area,
                          GtkCellRendererState flags);

Вызывает виртуальную функцию отрисовки GtkCellRenderer. Три переданных прямоугольника — области в cr. Большинство обработчиков будут рисовать внутри cell_area; поля xalign, yalign, xpad и ypad обработчика ячеек должны учитываться относительно cell_area. background_area включает пустое пространство вокруг ячейки, а также область, содержащую раскрывающийся элемент дерева; поэтому прямоугольники background_area всех ячеек выкладываются так, чтобы покрыть всю window.

Параметры

cell	a GtkCellRenderer
cr	контекст cairo для отрисовки
widget	виджет, владеющий `window`
background_area	вся область ячейки (включая раскрывающиеся элементы дерева и, возможно, отступы по бокам)
cell_area	область, обычно отрисовываемая обработчиком ячеек
flags	флаги, влияющие на отрисовку

gtk_cell_renderer_activate ()

gboolean
gtk_cell_renderer_activate (GtkCellRenderer *cell,
                            GdkEvent *event,
                            GtkWidget *widget,
                            const gchar *path,
                            const GdkRectangle *background_area,
                            const GdkRectangle *cell_area,
                            GtkCellRendererState flags);

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

Параметры

cell	a GtkCellRenderer
event	a GdkEvent
widget	виджет, получивший событие
path	зависимая от виджета строковая запись местоположения события; например, для GtkTreeView, строковая запись GtkTreePath
background_area	область фона, переданная в `gtk_cell_renderer_render()`
cell_area	область ячейки, переданная в `gtk_cell_renderer_render()`
flags	флаги отрисовки

Возвращаемое значение

TRUE, если событие было обработано/поглощено

gtk_cell_renderer_start_editing ()

GtkCellEditable *
gtk_cell_renderer_start_editing (GtkCellRenderer *cell,
                                 GdkEvent *event,
                                 GtkWidget *widget,
                                 const gchar *path,
                                 const GdkRectangle *background_area,
                                 const GdkRectangle *cell_area,
                                 GtkCellRendererState flags);

Передает событие активации в обработчик ячейки для возможной обработки.

Параметры

cell	a GtkCellRenderer
event	a GdkEvent.	[nullable]
widget	виджет, получивший событие
path	зависимая от виджета строковая запись местоположения события; например, для GtkTreeView, строковая запись GtkTreePath
background_area	область фона, переданная в `gtk_cell_renderer_render()`
cell_area	область ячейки, переданная в `gtk_cell_renderer_render()`
flags	флаги отрисовки

Возвращаемое значение

Новый GtkCellEditable, или NULL.

[nullable][transfer none]

gtk_cell_renderer_stop_editing ()

void
gtk_cell_renderer_stop_editing (GtkCellRenderer *cell,
                                gboolean canceled);

Сообщает обработчику ячейки, что редактирование остановлено. Если canceled равно TRUE, обработчик ячейки отправит сигнал “editing-canceled”.

Эта функция должна вызываться реализациями обработчиков ячеек в ответ на сигнал “editing-done” объекта GtkCellEditable.

Параметры

cell	A GtkCellRenderer
canceled	`TRUE`, если редактирование было отменено

С: 2.6

gtk_cell_renderer_get_fixed_size ()

void
gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell,
                                  gint *width,
                                  gint *height);

Заполняет width и height соответствующим размером cell.

Параметры

cell	A GtkCellRenderer
width	место для заполнения фиксированной ширины ячейки, или `NULL`.	[out][allow-none]
height	место для заполнения фиксированной высоты ячейки, или `NULL`.	[out][allow-none]

gtk_cell_renderer_set_fixed_size ()

void
gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
                                  gint width,
                                  gint height);

Устанавливает размер обработчика ячейки в явном виде, независимо от установленных свойств.

Параметры

cell	A GtkCellRenderer
width	ширина обработчика ячейки, или -1
height	высота обработчика ячейки, или -1

gtk_cell_renderer_get_visible ()

gboolean
gtk_cell_renderer_get_visible (GtkCellRenderer *cell);

Возвращает видимость обработчика ячейки.

Параметры

cell

A GtkCellRenderer

Возвращаемое значение

TRUE, если обработчик ячейки видим

С: 2.18

gtk_cell_renderer_set_visible ()

void
gtk_cell_renderer_set_visible (GtkCellRenderer *cell,
                               gboolean visible);

Устанавливает видимость обработчика ячейки.

Параметры

cell	A GtkCellRenderer
visible	видимость ячейки

С: 2.18

gtk_cell_renderer_get_sensitive ()

gboolean
gtk_cell_renderer_get_sensitive (GtkCellRenderer *cell);

Возвращает чувствительность ячейки-рендерера.

Параметры

cell

A GtkCellRenderer

Возвращает

TRUE, если ячейка-рендерер чувствительна

С: 2.18

gtk_cell_renderer_set_sensitive ()

void
gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell,
                                 gboolean sensitive);

Устанавливает чувствительность ячейки-рендерера.

Параметры

cell	A GtkCellRenderer
sensitive	чувствительность ячейки

С: 2.18

gtk_cell_renderer_get_alignment ()

void
gtk_cell_renderer_get_alignment (GtkCellRenderer *cell,
                                 gfloat *xalign,
                                 gfloat *yalign);

Заполняет xalign и yalign соответствующими значениями cell.

Параметры

cell	A GtkCellRenderer
xalign	место для заполнения выравниванием по горизонтали ячейки, или `NULL`.	[out][allow-none]
yalign	место для заполнения выравниванием по вертикали ячейки, или `NULL`.	[out][allow-none]

С: 2.18

gtk_cell_renderer_set_alignment ()

void
gtk_cell_renderer_set_alignment (GtkCellRenderer *cell,
                                 gfloat xalign,
                                 gfloat yalign);

Устанавливает выравнивание рендерера внутри доступного пространства.

Параметры

cell	A GtkCellRenderer
xalign	горизонтальное выравнивание ячейки-рендерера
yalign	вертикальное выравнивание ячейки-рендерера

С: 2.18

gtk_cell_renderer_get_padding ()

void
gtk_cell_renderer_get_padding (GtkCellRenderer *cell,
                               gint *xpad,
                               gint *ypad);

Заполняет xpad и ypad соответствующими значениями cell.

Параметры

cell	A GtkCellRenderer
xpad	место для заполнения отступом по горизонтали ячейки, или `NULL`.	[out][allow-none]
ypad	место для заполнения отступом по вертикали ячейки, или `NULL`.	[out][allow-none]

С: 2.18

gtk_cell_renderer_set_padding ()

void
gtk_cell_renderer_set_padding (GtkCellRenderer *cell,
                               gint xpad,
                               gint ypad);

Устанавливает отступы рендерера.

Параметры

cell	A GtkCellRenderer
xpad	горизонтальный отступ ячейки-рендерера
ypad	вертикальный отступ ячейки-рендерера

С: 2.18

gtk_cell-renderer-get-state ()

GtkStateFlags
gtk_cell_renderer_get_state (GtkCellRenderer *cell,
                             GtkWidget *widget,
                             GtkCellRendererState cell_state);

Преобразует состояние ячейки-рендерера в GtkStateFlags, исходя из состояния ячейки-рендерера, чувствительности виджета и заданного GtkCellRendererState.

Параметры

cell	a GtkCellRenderer, или `NULL`.	[nullable]
widget	a GtkWidget, или `NULL`.	[nullable]
cell_state	состояние ячейки-рендерера

Возвращает

флаги состояния виджета, применимые к cell

С: 3.0

gtk_cell_renderer_is_activatable ()

gboolean
gtk_cell_renderer_is_activatable (GtkCellRenderer *cell);

Проверяет, может ли ячейка-рендерер выполнить какое-либо действие при активации.

Параметры

cell

A GtkCellRenderer

Возвращает

TRUE, если ячейка-рендерер может выполнить какое-либо действие при активации

С: 3.0

gtk_cell_renderer_get_preferred_height ()

void
gtk_cell_renderer_get_preferred_height
                               (GtkCellRenderer *cell,
                                GtkWidget *widget,
                                gint *minimum_size,
                                gint *natural_size);

Получает естественный размер рендерера при отрисовке в widget.

Параметры

cell	экземпляр GtkCellRenderer
widget	элемент GtkWidget, в который будет отрисовываться ячейка
minimum_size	место для хранения минимального размера или `NULL`.	[out][allow-none]
natural_size	место для хранения естественного размера или `NULL`.	[out][allow-none]

С: 3.0

gtk_cell_renderer_get_preferred_height_for_width ()

void
gtk_cell_renderer_get_preferred_height_for_width
                               (GtkCellRenderer *cell,
                                GtkWidget *widget,
                                gint width,
                                gint *minimum_height,
                                gint *natural_height);

Возвращает минимальную и естественную высоту рендерера ячейки, если бы она была отрисована в widget с заданной width шириной.

Параметры

cell	экземпляр GtkCellRenderer
widget	элемент GtkWidget, в который будет отрисовываться ячейка
width	доступная ширина для выделения
minimum_height	место для хранения минимального размера, или `NULL`.	[out][allow-none]
natural_height	место для хранения предпочтительного размера, или `NULL`.	[out][allow-none]

С: 3.0

gtk_cell_renderer_get_preferred_size ()

void
gtk_cell_renderer_get_preferred_size (GtkCellRenderer *cell,
                                      GtkWidget *widget,
                                      GtkRequisition *minimum_size,
                                      GtkRequisition *natural_size);

Возвращает минимальный и естественный размеры ячейки с учётом предпочтений элемента для управления высотой в зависимости от ширины.

Параметры

cell	экземпляр GtkCellRenderer
widget	элемент GtkWidget, в который будет отрисовываться ячейка
minimum_size	место для хранения минимального размера, или `NULL`.	[out][allow-none]
natural_size	место для хранения естественного размера, или `NULL`.	[out][allow-none]

С: 3.0

gtk_cell_renderer_get_preferred_width ()

void
gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell,
                                       GtkWidget *widget,
                                       gint *minimum_size,
                                       gint *natural_size);

Возвращает естественный размер рендерера при отрисовке в widget.

Параметры

cell	экземпляр GtkCellRenderer
widget	элемент GtkWidget, в который будет отрисовываться ячейка
minimum_size	место для хранения минимального размера, или `NULL`.	[out][allow-none]
natural_size	место для хранения естественного размера, или `NULL`.	[out][allow-none]

С: 3.0

gtk_cell_renderer_get_preferred_width_for_height ()

void
gtk_cell_renderer_get_preferred_width_for_height
                               (GtkCellRenderer *cell,
                                GtkWidget *widget,
                                gint height,
                                gint *minimum_width,
                                gint *natural_width);

Возвращает минимальную и естественную ширину рендерера ячейки, если бы она была отрисована в widget с заданной height высотой.

Параметры

cell	экземпляр GtkCellRenderer
widget	элемент GtkWidget, в который будет отрисовываться ячейка
height	доступная высота для выделения
minimum_width	место для хранения минимального размера, или `NULL`.	[out][allow-none]
natural_width	место для хранения предпочтительного размера, или `NULL`.	[out][allow-none]

С: 3.0

gtk_cell_renderer_get_request_mode ()

GtkSizeRequestMode
gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell);

Определяет, предпочитает ли рендерер ячейки макет «высота по ширине» или «ширина по высоте».

Параметры

cell

экземпляр GtkCellRenderer

Возвращаемое значение

GtkSizeRequestMode , предпочитаемый этим рендерером.

С: 3.0

Типы и значения

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

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

Элементы

GTK_CELL_RENDERER_SELECTED	Ячейка в данный момент выбрана и, вероятно, имеет цветной фон выделения.
GTK_CELL_RENDERER_PRELIT	Над ячейкой находится указатель мыши.
GTK_CELL_RENDERER_INSENSITIVE	Ячейка отрисовывается как неактивная.
GTK_CELL_RENDERER_SORTED	Ячейка находится в сортированной строке.
GTK_CELL_RENDERER_FOCUSED	Ячейка находится в строке фокуса.
GTK_CELL_RENDERER_EXPANDABLE	Ячейка находится в строке, которую можно развернуть. С версии 3.4
GTK_CELL_RENDERER_EXPANDED	Ячейка находится в развернутой строке. С версии 3.4

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

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

Элементы

GTK_CELL_RENDERER_MODE_INERT	Ячейка предназначена только для отображения и с ней нельзя взаимодействовать. Обратите внимание, что это не означает, что, например, строка, которая рисуется, не может быть выбрана — просто отдельный элемент не может быть изменён.
GTK_CELL_RENDERER_MODE_ACTIVATABLE	Ячейка может быть нажата.
GTK_CELL_RENDERER_MODE_EDITABLE	Ячейку можно редактировать или изменять другими способами.

структура 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);
};

Элементы

`get_request_mode` ()	Вызывается для определения, предпочитает ли рендерер ячейки макет «высота по ширине» или «ширина по высоте».
`get_preferred_width` ()	Вызывается для получения естественной ширины рендерера.
`get_preferred_height_for_width` ()	Вызывается для получения естественной высоты рендерера для заданной ширины.
`get_preferred_height` ()	Вызывается для получения естественной высоты рендерера.
`get_preferred_width_for_height` ()	Вызывается для получения естественной ширины рендерера для заданной высоты.
`get_aligned_area` ()	Вызывается для получения выровненной области, используемой `cell` внутри `cell_area` .
`get_size` ()	Вызывается для получения ширины и высоты, необходимой для отрисовки ячейки. Устарело: 3.0.
`render` ()	Вызывается для отрисовки содержимого GtkCellRenderer.
`activate` ()	Вызывается для активации содержимого GtkCellRenderer.
`start_editing` ()	Вызывается для начала редактирования содержимого GtkCellRenderer.
`editing_canceled` ()	Сигнал генерируется, когда пользователь отменяет процесс редактирования ячейки.
`editing_started` ()	Сигнал генерируется, когда ячейка начинает редактироваться.

Подробное описание свойств

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

  “cell-background”          gchar *

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

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

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

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

  “cell-background-gdk”      GdkColor *

Фон ячейки как GdkColor

GtkCellRenderer:cell-background-gdk устарел с версии 3.4 и не должен использоваться в новом коде.

Используйте «cell-background-rgba» вместо этого.

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

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

  “cell-background-rgba”     GdkRGBA *

Фон ячейки как GdkRGBA

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

С версии: 3.0

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

  “cell-background-set”      gboolean

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

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

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

Свойство `“editing”`

  “editing”                  gboolean

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

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

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

Свойство `“height”`

  “height”                   gint

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

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

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

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

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

  “is-expanded”              gboolean

Строка — строка-расширитель, и она расширена.

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

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

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

  “is-expander”              gboolean

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

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

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

Свойство `“mode”`

  “mode”                     GtkCellRendererMode

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

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

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

Свойство `“sensitive”`

  “sensitive”                gboolean

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

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

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

Свойство `“visible”`

  “visible”                  gboolean

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

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

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

Свойство `“width”`

  “width”                    gint

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

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

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

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

Свойство `“xalign”`

  “xalign”                   gfloat

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

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

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

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

Свойство `“xpad”`

  “xpad”                     guint

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

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

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

Свойство `“yalign”`

  “yalign”                   gfloat

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

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

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

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

Свойство `“ypad”`

  “ypad”                     guint

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

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

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

Подробное описание сигналов

Сигнал `“editing-canceled”`

void
user_function (GtkCellRenderer *renderer,
               gpointer         user_data)

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

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

Параметры

renderer	объект, получивший сигнал
user_data	пользовательские данные, установленные при подключении обработчика сигнала.

Флаги: Выполнить сначала

С версии: 2.4

Сигнал `“editing-started”`

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

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

Обратите внимание, что 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);
    }
}

Параметры

renderer	объект, получивший сигнал
editable	GtkCellEditable
path	путь, определяющий редактируемую ячейку
user_data	пользовательские данные, установленные при подключении обработчика сигнала.

Флаги: Выполнить сначала

С версии: 2.6

См. также

GtkCellRendererText, GtkCellRendererPixbuf, GtkCellRendererToggle

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/GtkCellRenderer.html

GtkCellRenderer

Функции

Свойства

Сигналы

Типы и значения

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

Файлы включения

Описание

Функции

gtk_cell_renderer_class_set_accessible_type ()

Параметры

gtk_cell_renderer_get_aligned_area ()

Параметры

gtk_cell_renderer_get_size ()

Параметры

gtk_cell_renderer_render ()

Параметры

gtk_cell_renderer_activate ()

Параметры

Возвращаемое значение

gtk_cell_renderer_start_editing ()

Параметры

Возвращаемое значение

gtk_cell_renderer_stop_editing ()

Параметры

gtk_cell_renderer_get_fixed_size ()

Параметры

gtk_cell_renderer_set_fixed_size ()

Параметры

gtk_cell_renderer_get_visible ()

Параметры

Возвращаемое значение

gtk_cell_renderer_set_visible ()

Параметры

gtk_cell_renderer_get_sensitive ()

Параметры

Возвращает

gtk_cell_renderer_set_sensitive ()

Параметры

gtk_cell_renderer_get_alignment ()

Параметры

gtk_cell_renderer_set_alignment ()

Параметры

gtk_cell_renderer_get_padding ()

Параметры

gtk_cell_renderer_set_padding ()

Параметры

gtk_cell-renderer-get-state ()

Параметры

Возвращает

gtk_cell_renderer_is_activatable ()

Параметры

Возвращает

gtk_cell_renderer_get_preferred_height ()

Параметры

gtk_cell_renderer_get_preferred_height_for_width ()

Параметры

gtk_cell_renderer_get_preferred_size ()

Параметры

gtk_cell_renderer_get_preferred_width ()

Параметры

gtk_cell_renderer_get_preferred_width_for_height ()

Параметры

gtk_cell_renderer_get_request_mode ()

Параметры

Возвращаемое значение

Типы и значения

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

Элементы

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

Элементы

структура GtkCellRenderer

структура GtkCellRendererClass

Элементы

Подробное описание свойств

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

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

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

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

Свойство “editing”

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

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

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

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

Свойство `“editing”`

Свойство `“height”`

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

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

Свойство `“mode”`

Свойство `“sensitive”`

Свойство `“visible”`

Свойство `“width”`

Свойство `“xalign”`

Свойство `“xpad”`

Свойство `“yalign”`

Свойство `“ypad”`

Сигнал `“editing-canceled”`

Сигнал `“editing-started”`