/* gtkcellrenderer.c * Copyright (C) 2000 Red Hat, Inc. Jonathan Blandford * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library. If not, see . */ #include "config.h" #include "gtkcellrenderer.h" #include "gtkintl.h" #include "gtkmarshalers.h" #include "gtktypebuiltins.h" #include "gtkprivate.h" #include "gtktreeprivate.h" #include "a11y/gtkrenderercellaccessible.h" /** * SECTION:gtkcellrenderer * @Short_description: An object for rendering a single cell * @Title: GtkCellRenderer * @See_also: #GtkCellEditable * * The #GtkCellRenderer is a base class of a set of objects used for * rendering a cell to a #cairo_t. These objects are used primarily by * the #GtkTreeView widget, though they aren’t tied to them in any * specific way. It is worth noting that #GtkCellRenderer is not a * #GtkWidget and cannot be treated as such. * * The primary use of a #GtkCellRenderer is for drawing a certain graphical * elements on a #cairo_t. Typically, one cell renderer is used to * draw many cells on the screen. To this extent, it isn’t expected that a * CellRenderer keep any permanent state around. Instead, any state is set * just prior to use using #GObjects property system. Then, the * cell is measured using gtk_cell_renderer_get_size(). Finally, the cell * is rendered in the correct location using gtk_cell_renderer_render(). * * There are a number of rules that must be followed when writing a new * #GtkCellRenderer. First and foremost, it’s important that a certain set * of properties will always yield a cell renderer of the same size, * barring a #GtkStyle change. The #GtkCellRenderer also has a number of * generic properties that are expected to be honored by all children. * * Beyond merely rendering a cell, cell renderers can optionally * provide active user interface elements. A cell renderer can be * “activatable” like #GtkCellRendererToggle, * which toggles when it gets activated by a mouse click, or it can be * “editable” like #GtkCellRendererText, which * allows the user to edit the text using a #GtkEntry. * To make a cell renderer activatable or editable, you have to * implement the #GtkCellRendererClass.activate or * #GtkCellRendererClass.start_editing virtual functions, respectively. * * Many properties of #GtkCellRenderer and its subclasses have a * corresponding “set” property, e.g. “cell-background-set” corresponds * to “cell-background”. These “set” properties reflect whether a property * has been set or not. You should not set them independently. */ #define DEBUG_CELL_SIZE_REQUEST 0 static void gtk_cell_renderer_init (GtkCellRenderer *cell); static void gtk_cell_renderer_class_init (GtkCellRendererClass *class); static void gtk_cell_renderer_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec); static void gtk_cell_renderer_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec); static void set_cell_bg_color (GtkCellRenderer *cell, GdkRGBA *rgba); /* Fallback GtkCellRenderer implementation to use remaining ->get_size() implementations */ static GtkSizeRequestMode gtk_cell_renderer_real_get_request_mode(GtkCellRenderer *cell); static void gtk_cell_renderer_real_get_preferred_width (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size); static void gtk_cell_renderer_real_get_preferred_height (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size); static void gtk_cell_renderer_real_get_preferred_height_for_width(GtkCellRenderer *cell, GtkWidget *widget, gint width, gint *minimum_height, gint *natural_height); static void gtk_cell_renderer_real_get_preferred_width_for_height(GtkCellRenderer *cell, GtkWidget *widget, gint height, gint *minimum_width, gint *natural_width); static void gtk_cell_renderer_real_get_aligned_area (GtkCellRenderer *cell, GtkWidget *widget, GtkCellRendererState flags, const GdkRectangle *cell_area, GdkRectangle *aligned_area); struct _GtkCellRendererPrivate { gfloat xalign; gfloat yalign; gint width; gint height; guint16 xpad; guint16 ypad; guint mode : 2; guint visible : 1; guint is_expander : 1; guint is_expanded : 1; guint cell_background_set : 1; guint sensitive : 1; guint editing : 1; GdkRGBA cell_background; }; struct _GtkCellRendererClassPrivate { GType accessible_type; }; enum { PROP_0, PROP_MODE, PROP_VISIBLE, PROP_SENSITIVE, PROP_XALIGN, PROP_YALIGN, PROP_XPAD, PROP_YPAD, PROP_WIDTH, PROP_HEIGHT, PROP_IS_EXPANDER, PROP_IS_EXPANDED, PROP_CELL_BACKGROUND, PROP_CELL_BACKGROUND_GDK, PROP_CELL_BACKGROUND_RGBA, PROP_CELL_BACKGROUND_SET, PROP_EDITING }; /* Signal IDs */ enum { EDITING_CANCELED, EDITING_STARTED, LAST_SIGNAL }; static gint GtkCellRenderer_private_offset; static guint cell_renderer_signals[LAST_SIGNAL] = { 0 }; static inline gpointer gtk_cell_renderer_get_instance_private (GtkCellRenderer *self) { return (G_STRUCT_MEMBER_P (self, GtkCellRenderer_private_offset)); } static void gtk_cell_renderer_init (GtkCellRenderer *cell) { GtkCellRendererPrivate *priv; cell->priv = gtk_cell_renderer_get_instance_private (cell); priv = cell->priv; priv->mode = GTK_CELL_RENDERER_MODE_INERT; priv->visible = TRUE; priv->width = -1; priv->height = -1; priv->xalign = 0.5; priv->yalign = 0.5; priv->xpad = 0; priv->ypad = 0; priv->sensitive = TRUE; priv->is_expander = FALSE; priv->is_expanded = FALSE; priv->editing = FALSE; } static void gtk_cell_renderer_class_init (GtkCellRendererClass *class) { GObjectClass *object_class = G_OBJECT_CLASS (class); object_class->get_property = gtk_cell_renderer_get_property; object_class->set_property = gtk_cell_renderer_set_property; class->render = NULL; class->get_size = NULL; class->get_request_mode = gtk_cell_renderer_real_get_request_mode; class->get_preferred_width = gtk_cell_renderer_real_get_preferred_width; class->get_preferred_height = gtk_cell_renderer_real_get_preferred_height; class->get_preferred_width_for_height = gtk_cell_renderer_real_get_preferred_width_for_height; class->get_preferred_height_for_width = gtk_cell_renderer_real_get_preferred_height_for_width; class->get_aligned_area = gtk_cell_renderer_real_get_aligned_area; /** * GtkCellRenderer::editing-canceled: * @renderer: the object which received the signal * * This signal gets emitted when the user cancels the process of editing a * cell. For example, an editable cell renderer could be written to cancel * editing when the user presses Escape. * * See also: gtk_cell_renderer_stop_editing(). * * Since: 2.4 */ cell_renderer_signals[EDITING_CANCELED] = g_signal_new (I_("editing-canceled"), G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkCellRendererClass, editing_canceled), NULL, NULL, NULL, G_TYPE_NONE, 0); /** * GtkCellRenderer::editing-started: * @renderer: the object which received the signal * @editable: the #GtkCellEditable * @path: the path identifying the edited cell * * This signal gets emitted when a cell starts to be edited. * The intended use of this signal is to do special setup * on @editable, e.g. adding a #GtkEntryCompletion or setting * up additional columns in a #GtkComboBox. * * Note that GTK+ doesn't guarantee that cell renderers will * continue to use the same kind of widget for editing in future * releases, therefore you should check the type of @editable * before doing any specific setup, as in the following example: * |[ * 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); * } * } * ]| * * Since: 2.6 */ cell_renderer_signals[EDITING_STARTED] = g_signal_new (I_("editing-started"), G_OBJECT_CLASS_TYPE (object_class), G_SIGNAL_RUN_FIRST, G_STRUCT_OFFSET (GtkCellRendererClass, editing_started), NULL, NULL, _gtk_marshal_VOID__OBJECT_STRING, G_TYPE_NONE, 2, GTK_TYPE_CELL_EDITABLE, G_TYPE_STRING); g_object_class_install_property (object_class, PROP_MODE, g_param_spec_enum ("mode", P_("mode"), P_("Editable mode of the CellRenderer"), GTK_TYPE_CELL_RENDERER_MODE, GTK_CELL_RENDERER_MODE_INERT, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_VISIBLE, g_param_spec_boolean ("visible", P_("visible"), P_("Display the cell"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_SENSITIVE, g_param_spec_boolean ("sensitive", P_("Sensitive"), P_("Display the cell sensitive"), TRUE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_XALIGN, g_param_spec_float ("xalign", P_("xalign"), P_("The x-align"), 0.0, 1.0, 0.5, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_YALIGN, g_param_spec_float ("yalign", P_("yalign"), P_("The y-align"), 0.0, 1.0, 0.5, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_XPAD, g_param_spec_uint ("xpad", P_("xpad"), P_("The xpad"), 0, G_MAXUINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_YPAD, g_param_spec_uint ("ypad", P_("ypad"), P_("The ypad"), 0, G_MAXUINT, 0, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_WIDTH, g_param_spec_int ("width", P_("width"), P_("The fixed width"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_HEIGHT, g_param_spec_int ("height", P_("height"), P_("The fixed height"), -1, G_MAXINT, -1, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_IS_EXPANDER, g_param_spec_boolean ("is-expander", P_("Is Expander"), P_("Row has children"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_IS_EXPANDED, g_param_spec_boolean ("is-expanded", P_("Is Expanded"), P_("Row is an expander row, and is expanded"), FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)); g_object_class_install_property (object_class, PROP_CELL_BACKGROUND, g_param_spec_string ("cell-background", P_("Cell background color name"), P_("Cell background color as a string"), NULL, GTK_PARAM_WRITABLE)); /** * GtkCellRenderer:cell-background-gdk: * * Cell background as a #GdkColor * * Deprecated: 3.4: Use #GtkCellRenderer:cell-background-rgba instead. */ G_GNUC_BEGIN_IGNORE_DEPRECATIONS g_object_class_install_property (object_class, PROP_CELL_BACKGROUND_GDK, g_param_spec_boxed ("cell-background-gdk", P_("Cell background color"), P_("Cell background color as a GdkColor"), GDK_TYPE_COLOR, GTK_PARAM_READWRITE|G_PARAM_DEPRECATED)); G_GNUC_END_IGNORE_DEPRECATIONS /** * GtkCellRenderer:cell-background-rgba: * * Cell background as a #GdkRGBA * * Since: 3.0 */ g_object_class_install_property (object_class, PROP_CELL_BACKGROUND_RGBA, g_param_spec_boxed ("cell-background-rgba", P_("Cell background RGBA color"), P_("Cell background color as a GdkRGBA"), GDK_TYPE_RGBA, GTK_PARAM_READWRITE)); g_object_class_install_property (object_class, PROP_EDITING, g_param_spec_boolean ("editing", P_("Editing"), P_("Whether the cell renderer is currently in editing mode"), FALSE, GTK_PARAM_READABLE)); #define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (object_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, GTK_PARAM_READWRITE|G_PARAM_EXPLICIT_NOTIFY)) ADD_SET_PROP ("cell-background-set", PROP_CELL_BACKGROUND_SET, P_("Cell background set"), P_("Whether the cell background color is set")); if (GtkCellRenderer_private_offset != 0) g_type_class_adjust_private_offset (class, &GtkCellRenderer_private_offset); gtk_cell_renderer_class_set_accessible_type (class, GTK_TYPE_RENDERER_CELL_ACCESSIBLE); } static void gtk_cell_renderer_base_class_init (gpointer g_class) { GtkCellRendererClass *klass = g_class; klass->priv = G_TYPE_CLASS_GET_PRIVATE (g_class, GTK_TYPE_CELL_RENDERER, GtkCellRendererClassPrivate); } GType gtk_cell_renderer_get_type (void) { static GType cell_renderer_type = 0; if (G_UNLIKELY (cell_renderer_type == 0)) { const GTypeInfo cell_renderer_info = { sizeof (GtkCellRendererClass), gtk_cell_renderer_base_class_init, NULL, (GClassInitFunc) gtk_cell_renderer_class_init, NULL, /* class_finalize */ NULL, /* class_init */ sizeof (GtkWidget), 0, /* n_preallocs */ (GInstanceInitFunc) gtk_cell_renderer_init, NULL, /* value_table */ }; cell_renderer_type = g_type_register_static (G_TYPE_INITIALLY_UNOWNED, "GtkCellRenderer", &cell_renderer_info, G_TYPE_FLAG_ABSTRACT); GtkCellRenderer_private_offset = g_type_add_instance_private (cell_renderer_type, sizeof (GtkCellRendererPrivate)); g_type_add_class_private (cell_renderer_type, sizeof (GtkCellRendererClassPrivate)); } return cell_renderer_type; } static void gtk_cell_renderer_get_property (GObject *object, guint param_id, GValue *value, GParamSpec *pspec) { GtkCellRenderer *cell = GTK_CELL_RENDERER (object); GtkCellRendererPrivate *priv = cell->priv; switch (param_id) { case PROP_MODE: g_value_set_enum (value, priv->mode); break; case PROP_VISIBLE: g_value_set_boolean (value, priv->visible); break; case PROP_SENSITIVE: g_value_set_boolean (value, priv->sensitive); break; case PROP_EDITING: g_value_set_boolean (value, priv->editing); break; case PROP_XALIGN: g_value_set_float (value, priv->xalign); break; case PROP_YALIGN: g_value_set_float (value, priv->yalign); break; case PROP_XPAD: g_value_set_uint (value, priv->xpad); break; case PROP_YPAD: g_value_set_uint (value, priv->ypad); break; case PROP_WIDTH: g_value_set_int (value, priv->width); break; case PROP_HEIGHT: g_value_set_int (value, priv->height); break; case PROP_IS_EXPANDER: g_value_set_boolean (value, priv->is_expander); break; case PROP_IS_EXPANDED: g_value_set_boolean (value, priv->is_expanded); break; case PROP_CELL_BACKGROUND_GDK: { GdkColor color; color.red = (guint16) (priv->cell_background.red * 65535); color.green = (guint16) (priv->cell_background.green * 65535); color.blue = (guint16) (priv->cell_background.blue * 65535); g_value_set_boxed (value, &color); } break; case PROP_CELL_BACKGROUND_RGBA: g_value_set_boxed (value, &priv->cell_background); break; case PROP_CELL_BACKGROUND_SET: g_value_set_boolean (value, priv->cell_background_set); break; case PROP_CELL_BACKGROUND: default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } static void gtk_cell_renderer_set_property (GObject *object, guint param_id, const GValue *value, GParamSpec *pspec) { GtkCellRenderer *cell = GTK_CELL_RENDERER (object); GtkCellRendererPrivate *priv = cell->priv; switch (param_id) { case PROP_MODE: if (priv->mode != g_value_get_enum (value)) { priv->mode = g_value_get_enum (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_VISIBLE: if (priv->visible != g_value_get_boolean (value)) { priv->visible = g_value_get_boolean (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_SENSITIVE: if (priv->sensitive != g_value_get_boolean (value)) { priv->sensitive = g_value_get_boolean (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_XALIGN: if (priv->xalign != g_value_get_float (value)) { priv->xalign = g_value_get_float (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_YALIGN: if (priv->yalign != g_value_get_float (value)) { priv->yalign = g_value_get_float (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_XPAD: if (priv->xpad != g_value_get_uint (value)) { priv->xpad = g_value_get_uint (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_YPAD: if (priv->ypad != g_value_get_uint (value)) { priv->ypad = g_value_get_uint (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_WIDTH: if (priv->width != g_value_get_int (value)) { priv->width = g_value_get_int (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_HEIGHT: if (priv->height != g_value_get_int (value)) { priv->height = g_value_get_int (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_IS_EXPANDER: if (priv->is_expander != g_value_get_boolean (value)) { priv->is_expander = g_value_get_boolean (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_IS_EXPANDED: if (priv->is_expanded != g_value_get_boolean (value)) { priv->is_expanded = g_value_get_boolean (value); g_object_notify_by_pspec (object, pspec); } break; case PROP_CELL_BACKGROUND: { GdkRGBA rgba; if (!g_value_get_string (value)) set_cell_bg_color (cell, NULL); else if (gdk_rgba_parse (&rgba, g_value_get_string (value))) set_cell_bg_color (cell, &rgba); else g_warning ("Don't know color '%s'", g_value_get_string (value)); g_object_notify (object, "cell-background"); } break; case PROP_CELL_BACKGROUND_GDK: { GdkColor *color; color = g_value_get_boxed (value); if (color) { GdkRGBA rgba; rgba.red = color->red / 65535.; rgba.green = color->green / 65535.; rgba.blue = color->blue / 65535.; rgba.alpha = 1; set_cell_bg_color (cell, &rgba); } else { set_cell_bg_color (cell, NULL); } g_object_notify (object, "cell-background-gdk"); } break; case PROP_CELL_BACKGROUND_RGBA: set_cell_bg_color (cell, g_value_get_boxed (value)); break; case PROP_CELL_BACKGROUND_SET: if (priv->cell_background_set != g_value_get_boolean (value)) { priv->cell_background_set = g_value_get_boolean (value); g_object_notify (object, "cell-background-set"); } break; default: G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec); break; } } static void set_cell_bg_color (GtkCellRenderer *cell, GdkRGBA *rgba) { GtkCellRendererPrivate *priv = cell->priv; if (rgba) { if (!priv->cell_background_set) { priv->cell_background_set = TRUE; g_object_notify (G_OBJECT (cell), "cell-background-set"); } priv->cell_background = *rgba; } else { if (priv->cell_background_set) { priv->cell_background_set = FALSE; g_object_notify (G_OBJECT (cell), "cell-background-set"); } } g_object_notify (G_OBJECT (cell), "cell-background-rgba"); } /** * gtk_cell_renderer_get_size: * @cell: a #GtkCellRenderer * @widget: the widget the renderer is rendering to * @cell_area: (allow-none): The area a cell will be allocated, or %NULL * @x_offset: (out) (allow-none): location to return x offset of cell relative to @cell_area, or %NULL * @y_offset: (out) (allow-none): location to return y offset of cell relative to @cell_area, or %NULL * @width: (out) (allow-none): location to return width needed to render a cell, or %NULL * @height: (out) (allow-none): location to return height needed to render a cell, or %NULL * * Obtains the width and height needed to render the cell. Used by view * widgets to determine the appropriate size for the cell_area passed to * gtk_cell_renderer_render(). If @cell_area is not %NULL, fills in the * x and y offsets (if set) of the cell relative to this location. * * Please note that the values set in @width and @height, as well as those * in @x_offset and @y_offset are inclusive of the xpad and ypad properties. * * * Deprecated: 3.0: Use gtk_cell_renderer_get_preferred_size() instead. **/ void gtk_cell_renderer_get_size (GtkCellRenderer *cell, GtkWidget *widget, const GdkRectangle *cell_area, gint *x_offset, gint *y_offset, gint *width, gint *height) { GtkRequisition request; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); gtk_cell_renderer_get_preferred_size (cell, widget, &request, NULL); if (width) *width = request.width; if (height) *height = request.height; if (cell_area) _gtk_cell_renderer_calc_offset (cell, cell_area, gtk_widget_get_direction (widget), request.width, request.height, x_offset, y_offset); } /** * gtk_cell_renderer_render: * @cell: a #GtkCellRenderer * @cr: a cairo context to draw to * @widget: the widget owning @window * @background_area: entire cell area (including tree expanders and maybe * padding on the sides) * @cell_area: area normally rendered by a cell renderer * @flags: flags that affect rendering * * Invokes the virtual render function of the #GtkCellRenderer. The three * passed-in rectangles are areas in @cr. Most renderers will draw within * @cell_area; the xalign, yalign, xpad, and ypad fields of the #GtkCellRenderer * should be honored with respect to @cell_area. @background_area includes the * blank space around the cell, and also the area containing the tree expander; * so the @background_area rectangles for all cells tile to cover the entire * @window. **/ void gtk_cell_renderer_render (GtkCellRenderer *cell, cairo_t *cr, GtkWidget *widget, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags) { gboolean selected = FALSE; GtkCellRendererPrivate *priv = cell->priv; GtkStyleContext *context; GtkStateFlags state; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_CELL_RENDERER_GET_CLASS (cell)->render != NULL); g_return_if_fail (cr != NULL); selected = (flags & GTK_CELL_RENDERER_SELECTED) == GTK_CELL_RENDERER_SELECTED; cairo_save (cr); if (priv->cell_background_set && !selected) { gdk_cairo_rectangle (cr, background_area); gdk_cairo_set_source_rgba (cr, &priv->cell_background); cairo_fill (cr); } gdk_cairo_rectangle (cr, background_area); cairo_clip (cr); context = gtk_widget_get_style_context (widget); gtk_style_context_save (context); gtk_style_context_add_class (context, GTK_STYLE_CLASS_CELL); state = gtk_cell_renderer_get_state (cell, widget, flags); gtk_style_context_set_state (context, state); GTK_CELL_RENDERER_GET_CLASS (cell)->render (cell, cr, widget, background_area, cell_area, flags); gtk_style_context_restore (context); cairo_restore (cr); } /** * gtk_cell_renderer_activate: * @cell: a #GtkCellRenderer * @event: a #GdkEvent * @widget: widget that received the event * @path: widget-dependent string representation of the event location; * e.g. for #GtkTreeView, a string representation of #GtkTreePath * @background_area: background area as passed to gtk_cell_renderer_render() * @cell_area: cell area as passed to gtk_cell_renderer_render() * @flags: render flags * * Passes an activate event to the cell renderer for possible processing. * Some cell renderers may use events; for example, #GtkCellRendererToggle * toggles when it gets a mouse click. * * Returns: %TRUE if the event was consumed/handled **/ gboolean gtk_cell_renderer_activate (GtkCellRenderer *cell, GdkEvent *event, GtkWidget *widget, const gchar *path, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags) { GtkCellRendererPrivate *priv; g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE); priv = cell->priv; if (priv->mode != GTK_CELL_RENDERER_MODE_ACTIVATABLE) return FALSE; if (GTK_CELL_RENDERER_GET_CLASS (cell)->activate == NULL) return FALSE; return GTK_CELL_RENDERER_GET_CLASS (cell)->activate (cell, event, widget, path, (GdkRectangle *) background_area, (GdkRectangle *) cell_area, flags); } /** * gtk_cell_renderer_start_editing: * @cell: a #GtkCellRenderer * @event: (nullable): a #GdkEvent * @widget: widget that received the event * @path: widget-dependent string representation of the event location; * e.g. for #GtkTreeView, a string representation of #GtkTreePath * @background_area: background area as passed to gtk_cell_renderer_render() * @cell_area: cell area as passed to gtk_cell_renderer_render() * @flags: render flags * * Passes an activate event to the cell renderer for possible processing. * * Returns: (nullable) (transfer none): A new #GtkCellEditable, or %NULL **/ 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) { GtkCellRendererPrivate *priv; GtkCellEditable *editable; g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), NULL); priv = cell->priv; if (priv->mode != GTK_CELL_RENDERER_MODE_EDITABLE) return NULL; if (GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing == NULL) return NULL; editable = GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing (cell, event, widget, path, (GdkRectangle *) background_area, (GdkRectangle *) cell_area, flags); if (editable == NULL) return NULL; gtk_style_context_add_class (gtk_widget_get_style_context (GTK_WIDGET (editable)), GTK_STYLE_CLASS_CELL); g_signal_emit (cell, cell_renderer_signals[EDITING_STARTED], 0, editable, path); priv->editing = TRUE; return editable; } /** * gtk_cell_renderer_set_fixed_size: * @cell: A #GtkCellRenderer * @width: the width of the cell renderer, or -1 * @height: the height of the cell renderer, or -1 * * Sets the renderer size to be explicit, independent of the properties set. **/ void gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell, gint width, gint height) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (width >= -1 && height >= -1); priv = cell->priv; if ((width != priv->width) || (height != priv->height)) { g_object_freeze_notify (G_OBJECT (cell)); if (width != priv->width) { priv->width = width; g_object_notify (G_OBJECT (cell), "width"); } if (height != priv->height) { priv->height = height; g_object_notify (G_OBJECT (cell), "height"); } g_object_thaw_notify (G_OBJECT (cell)); } } /** * gtk_cell_renderer_get_fixed_size: * @cell: A #GtkCellRenderer * @width: (out) (allow-none): location to fill in with the fixed width of the cell, or %NULL * @height: (out) (allow-none): location to fill in with the fixed height of the cell, or %NULL * * Fills in @width and @height with the appropriate size of @cell. **/ void gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell, gint *width, gint *height) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (width) *width = priv->width; if (height) *height = priv->height; } /** * gtk_cell_renderer_set_alignment: * @cell: A #GtkCellRenderer * @xalign: the x alignment of the cell renderer * @yalign: the y alignment of the cell renderer * * Sets the renderer’s alignment within its available space. * * Since: 2.18 **/ void gtk_cell_renderer_set_alignment (GtkCellRenderer *cell, gfloat xalign, gfloat yalign) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (xalign >= 0.0 && xalign <= 1.0); g_return_if_fail (yalign >= 0.0 && yalign <= 1.0); priv = cell->priv; if ((xalign != priv->xalign) || (yalign != priv->yalign)) { g_object_freeze_notify (G_OBJECT (cell)); if (xalign != priv->xalign) { priv->xalign = xalign; g_object_notify (G_OBJECT (cell), "xalign"); } if (yalign != priv->yalign) { priv->yalign = yalign; g_object_notify (G_OBJECT (cell), "yalign"); } g_object_thaw_notify (G_OBJECT (cell)); } } /** * gtk_cell_renderer_get_alignment: * @cell: A #GtkCellRenderer * @xalign: (out) (allow-none): location to fill in with the x alignment of the cell, or %NULL * @yalign: (out) (allow-none): location to fill in with the y alignment of the cell, or %NULL * * Fills in @xalign and @yalign with the appropriate values of @cell. * * Since: 2.18 **/ void gtk_cell_renderer_get_alignment (GtkCellRenderer *cell, gfloat *xalign, gfloat *yalign) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (xalign) *xalign = priv->xalign; if (yalign) *yalign = priv->yalign; } /** * gtk_cell_renderer_set_padding: * @cell: A #GtkCellRenderer * @xpad: the x padding of the cell renderer * @ypad: the y padding of the cell renderer * * Sets the renderer’s padding. * * Since: 2.18 **/ void gtk_cell_renderer_set_padding (GtkCellRenderer *cell, gint xpad, gint ypad) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (xpad >= 0 && ypad >= 0); priv = cell->priv; if ((xpad != priv->xpad) || (ypad != priv->ypad)) { g_object_freeze_notify (G_OBJECT (cell)); if (xpad != priv->xpad) { priv->xpad = xpad; g_object_notify (G_OBJECT (cell), "xpad"); } if (ypad != priv->ypad) { priv->ypad = ypad; g_object_notify (G_OBJECT (cell), "ypad"); } g_object_thaw_notify (G_OBJECT (cell)); } } /** * gtk_cell_renderer_get_padding: * @cell: A #GtkCellRenderer * @xpad: (out) (allow-none): location to fill in with the x padding of the cell, or %NULL * @ypad: (out) (allow-none): location to fill in with the y padding of the cell, or %NULL * * Fills in @xpad and @ypad with the appropriate values of @cell. * * Since: 2.18 **/ void gtk_cell_renderer_get_padding (GtkCellRenderer *cell, gint *xpad, gint *ypad) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (xpad) *xpad = priv->xpad; if (ypad) *ypad = priv->ypad; } /** * gtk_cell_renderer_set_visible: * @cell: A #GtkCellRenderer * @visible: the visibility of the cell * * Sets the cell renderer’s visibility. * * Since: 2.18 **/ void gtk_cell_renderer_set_visible (GtkCellRenderer *cell, gboolean visible) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (priv->visible != visible) { priv->visible = visible ? TRUE : FALSE; g_object_notify (G_OBJECT (cell), "visible"); } } /** * gtk_cell_renderer_get_visible: * @cell: A #GtkCellRenderer * * Returns the cell renderer’s visibility. * * Returns: %TRUE if the cell renderer is visible * * Since: 2.18 */ gboolean gtk_cell_renderer_get_visible (GtkCellRenderer *cell) { g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE); return cell->priv->visible; } /** * gtk_cell_renderer_set_sensitive: * @cell: A #GtkCellRenderer * @sensitive: the sensitivity of the cell * * Sets the cell renderer’s sensitivity. * * Since: 2.18 **/ void gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell, gboolean sensitive) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (priv->sensitive != sensitive) { priv->sensitive = sensitive ? TRUE : FALSE; g_object_notify (G_OBJECT (cell), "sensitive"); } } /** * gtk_cell_renderer_get_sensitive: * @cell: A #GtkCellRenderer * * Returns the cell renderer’s sensitivity. * * Returns: %TRUE if the cell renderer is sensitive * * Since: 2.18 */ gboolean gtk_cell_renderer_get_sensitive (GtkCellRenderer *cell) { g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE); return cell->priv->sensitive; } /** * gtk_cell_renderer_is_activatable: * @cell: A #GtkCellRenderer * * Checks whether the cell renderer can do something when activated. * * Returns: %TRUE if the cell renderer can do anything when activated * * Since: 3.0 */ gboolean gtk_cell_renderer_is_activatable (GtkCellRenderer *cell) { GtkCellRendererPrivate *priv; g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE); priv = cell->priv; return (priv->visible && (priv->mode == GTK_CELL_RENDERER_MODE_EDITABLE || priv->mode == GTK_CELL_RENDERER_MODE_ACTIVATABLE)); } /** * gtk_cell_renderer_stop_editing: * @cell: A #GtkCellRenderer * @canceled: %TRUE if the editing has been canceled * * Informs the cell renderer that the editing is stopped. * If @canceled is %TRUE, the cell renderer will emit the * #GtkCellRenderer::editing-canceled signal. * * This function should be called by cell renderer implementations * in response to the #GtkCellEditable::editing-done signal of * #GtkCellEditable. * * Since: 2.6 **/ void gtk_cell_renderer_stop_editing (GtkCellRenderer *cell, gboolean canceled) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); priv = cell->priv; if (priv->editing) { priv->editing = FALSE; if (canceled) g_signal_emit (cell, cell_renderer_signals[EDITING_CANCELED], 0); } } static void gtk_cell_renderer_real_get_preferred_size (GtkCellRenderer *cell, GtkWidget *widget, GtkOrientation orientation, gint *minimum_size, gint *natural_size) { GtkRequisition min_req; /* Fallback on the old API to get the size. */ if (GTK_CELL_RENDERER_GET_CLASS (cell)->get_size) GTK_CELL_RENDERER_GET_CLASS (cell)->get_size (GTK_CELL_RENDERER (cell), widget, NULL, NULL, NULL, &min_req.width, &min_req.height); else { min_req.width = 0; min_req.height = 0; } if (orientation == GTK_ORIENTATION_HORIZONTAL) { if (minimum_size) *minimum_size = min_req.width; if (natural_size) *natural_size = min_req.width; } else { if (minimum_size) *minimum_size = min_req.height; if (natural_size) *natural_size = min_req.height; } } static GtkSizeRequestMode gtk_cell_renderer_real_get_request_mode (GtkCellRenderer *cell) { /* By default cell renderers are height-for-width. */ return GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH; } static void gtk_cell_renderer_real_get_preferred_width (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size) { gtk_cell_renderer_real_get_preferred_size (cell, widget, GTK_ORIENTATION_HORIZONTAL, minimum_size, natural_size); } static void gtk_cell_renderer_real_get_preferred_height (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size) { gtk_cell_renderer_real_get_preferred_size (cell, widget, GTK_ORIENTATION_VERTICAL, minimum_size, natural_size); } static void gtk_cell_renderer_real_get_preferred_height_for_width (GtkCellRenderer *cell, GtkWidget *widget, gint width, gint *minimum_height, gint *natural_height) { /* Fall back on the height reported from ->get_size() */ gtk_cell_renderer_get_preferred_height (cell, widget, minimum_height, natural_height); } static void gtk_cell_renderer_real_get_preferred_width_for_height (GtkCellRenderer *cell, GtkWidget *widget, gint height, gint *minimum_width, gint *natural_width) { /* Fall back on the width reported from ->get_size() */ gtk_cell_renderer_get_preferred_width (cell, widget, minimum_width, natural_width); } /* Default implementation assumes that a cell renderer will never use more * space than its natural size (this is fine for toggles and pixbufs etc * but needs to be overridden from wrapping/ellipsizing text renderers) */ static void gtk_cell_renderer_real_get_aligned_area (GtkCellRenderer *cell, GtkWidget *widget, GtkCellRendererState flags, const GdkRectangle *cell_area, GdkRectangle *aligned_area) { gint opposite_size, x_offset, y_offset; gint natural_size; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (cell_area != NULL); g_return_if_fail (aligned_area != NULL); *aligned_area = *cell_area; /* Trim up the aligned size */ if (gtk_cell_renderer_get_request_mode (cell) == GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH) { gtk_cell_renderer_get_preferred_width (cell, widget, NULL, &natural_size); aligned_area->width = MIN (aligned_area->width, natural_size); gtk_cell_renderer_get_preferred_height_for_width (cell, widget, aligned_area->width, NULL, &opposite_size); aligned_area->height = MIN (opposite_size, aligned_area->height); } else { gtk_cell_renderer_get_preferred_height (cell, widget, NULL, &natural_size); aligned_area->height = MIN (aligned_area->width, natural_size); gtk_cell_renderer_get_preferred_width_for_height (cell, widget, aligned_area->height, NULL, &opposite_size); aligned_area->width = MIN (opposite_size, aligned_area->width); } /* offset the cell position */ _gtk_cell_renderer_calc_offset (cell, cell_area, gtk_widget_get_direction (widget), aligned_area->width, aligned_area->height, &x_offset, &y_offset); aligned_area->x += x_offset; aligned_area->y += y_offset; } /* An internal convenience function for some containers to peek at the * cell alignment in a target allocation (used to draw focus and align * cells in the icon view). * * Note this is only a trivial “align * (allocation - request)” operation. */ void _gtk_cell_renderer_calc_offset (GtkCellRenderer *cell, const GdkRectangle *cell_area, GtkTextDirection direction, gint width, gint height, gint *x_offset, gint *y_offset) { GtkCellRendererPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (cell_area != NULL); g_return_if_fail (x_offset || y_offset); priv = cell->priv; if (x_offset) { *x_offset = (((direction == GTK_TEXT_DIR_RTL) ? (1.0 - priv->xalign) : priv->xalign) * (cell_area->width - width)); *x_offset = MAX (*x_offset, 0); } if (y_offset) { *y_offset = (priv->yalign * (cell_area->height - height)); *y_offset = MAX (*y_offset, 0); } } /** * gtk_cell_renderer_get_request_mode: * @cell: a #GtkCellRenderer instance * * Gets whether the cell renderer prefers a height-for-width layout * or a width-for-height layout. * * Returns: The #GtkSizeRequestMode preferred by this renderer. * * Since: 3.0 */ GtkSizeRequestMode gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell) { g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE); return GTK_CELL_RENDERER_GET_CLASS (cell)->get_request_mode (cell); } /** * gtk_cell_renderer_get_preferred_width: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL * @natural_size: (out) (allow-none): location to store the natural size, or %NULL * * Retreives a renderer’s natural size when rendered to @widget. * * Since: 3.0 */ void gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size) { GtkCellRendererClass *klass; gint width; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (NULL != minimum_size || NULL != natural_size); gtk_cell_renderer_get_fixed_size (GTK_CELL_RENDERER (cell), &width, NULL); if (width < 0) { klass = GTK_CELL_RENDERER_GET_CLASS (cell); klass->get_preferred_width (cell, widget, minimum_size, natural_size); } else { if (minimum_size) *minimum_size = width; if (natural_size) *natural_size = width; } #if DEBUG_CELL_SIZE_REQUEST g_message ("%s returning minimum width: %d and natural width: %d", G_OBJECT_TYPE_NAME (cell), minimum_size ? *minimum_size : 20000, natural_size ? *natural_size : 20000); #endif } /** * gtk_cell_renderer_get_preferred_height: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @minimum_size: (out) (allow-none): location to store the minimum size, or %NULL * @natural_size: (out) (allow-none): location to store the natural size, or %NULL * * Retreives a renderer’s natural size when rendered to @widget. * * Since: 3.0 */ void gtk_cell_renderer_get_preferred_height (GtkCellRenderer *cell, GtkWidget *widget, gint *minimum_size, gint *natural_size) { GtkCellRendererClass *klass; gint height; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (NULL != minimum_size || NULL != natural_size); gtk_cell_renderer_get_fixed_size (GTK_CELL_RENDERER (cell), NULL, &height); if (height < 0) { klass = GTK_CELL_RENDERER_GET_CLASS (cell); klass->get_preferred_height (cell, widget, minimum_size, natural_size); } else { if (minimum_size) *minimum_size = height; if (natural_size) *natural_size = height; } #if DEBUG_CELL_SIZE_REQUEST g_message ("%s returning minimum height: %d and natural height: %d", G_OBJECT_TYPE_NAME (cell), minimum_size ? *minimum_size : 20000, natural_size ? *natural_size : 20000); #endif } /** * gtk_cell_renderer_get_preferred_width_for_height: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @height: the size which is available for allocation * @minimum_width: (out) (allow-none): location for storing the minimum size, or %NULL * @natural_width: (out) (allow-none): location for storing the preferred size, or %NULL * * Retreives a cell renderers’s minimum and natural width if it were rendered to * @widget with the specified @height. * * Since: 3.0 */ void gtk_cell_renderer_get_preferred_width_for_height (GtkCellRenderer *cell, GtkWidget *widget, gint height, gint *minimum_width, gint *natural_width) { GtkCellRendererClass *klass; gint width; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (NULL != minimum_width || NULL != natural_width); gtk_cell_renderer_get_fixed_size (GTK_CELL_RENDERER (cell), &width, NULL); if (width < 0) { klass = GTK_CELL_RENDERER_GET_CLASS (cell); klass->get_preferred_width_for_height (cell, widget, height, minimum_width, natural_width); } else { if (minimum_width) *minimum_width = width; if (natural_width) *natural_width = width; } #if DEBUG_CELL_SIZE_REQUEST g_message ("%s width for height: %d is minimum %d and natural: %d", G_OBJECT_TYPE_NAME (cell), height, minimum_width ? *minimum_width : 20000, natural_width ? *natural_width : 20000); #endif } /** * gtk_cell_renderer_get_preferred_height_for_width: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @width: the size which is available for allocation * @minimum_height: (out) (allow-none): location for storing the minimum size, or %NULL * @natural_height: (out) (allow-none): location for storing the preferred size, or %NULL * * Retreives a cell renderers’s minimum and natural height if it were rendered to * @widget with the specified @width. * * Since: 3.0 */ void gtk_cell_renderer_get_preferred_height_for_width (GtkCellRenderer *cell, GtkWidget *widget, gint width, gint *minimum_height, gint *natural_height) { GtkCellRendererClass *klass; gint height; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (NULL != minimum_height || NULL != natural_height); gtk_cell_renderer_get_fixed_size (GTK_CELL_RENDERER (cell), NULL, &height); if (height < 0) { klass = GTK_CELL_RENDERER_GET_CLASS (cell); klass->get_preferred_height_for_width (cell, widget, width, minimum_height, natural_height); } else { if (minimum_height) *minimum_height = height; if (natural_height) *natural_height = height; } #if DEBUG_CELL_SIZE_REQUEST g_message ("%s height for width: %d is minimum %d and natural: %d", G_OBJECT_TYPE_NAME (cell), width, minimum_height ? *minimum_height : 20000, natural_height ? *natural_height : 20000); #endif } /** * gtk_cell_renderer_get_preferred_size: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @minimum_size: (out) (allow-none): location for storing the minimum size, or %NULL * @natural_size: (out) (allow-none): location for storing the natural size, or %NULL * * Retrieves the minimum and natural size of a cell taking * into account the widget’s preference for height-for-width management. * * Since: 3.0 */ void gtk_cell_renderer_get_preferred_size (GtkCellRenderer *cell, GtkWidget *widget, GtkRequisition *minimum_size, GtkRequisition *natural_size) { gint min_width, nat_width; gint min_height, nat_height; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); if (gtk_cell_renderer_get_request_mode (cell) == GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH) { gtk_cell_renderer_get_preferred_width (cell, widget, &min_width, &nat_width); if (minimum_size) { minimum_size->width = min_width; gtk_cell_renderer_get_preferred_height_for_width (cell, widget, min_width, &minimum_size->height, NULL); } if (natural_size) { natural_size->width = nat_width; gtk_cell_renderer_get_preferred_height_for_width (cell, widget, nat_width, NULL, &natural_size->height); } } else /* GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT */ { gtk_cell_renderer_get_preferred_height (cell, widget, &min_height, &nat_height); if (minimum_size) { minimum_size->height = min_height; gtk_cell_renderer_get_preferred_width_for_height (cell, widget, min_height, &minimum_size->width, NULL); } if (natural_size) { natural_size->height = nat_height; gtk_cell_renderer_get_preferred_width_for_height (cell, widget, nat_height, NULL, &natural_size->width); } } } /** * gtk_cell_renderer_get_aligned_area: * @cell: a #GtkCellRenderer instance * @widget: the #GtkWidget this cell will be rendering to * @flags: render flags * @cell_area: cell area which would be passed to gtk_cell_renderer_render() * @aligned_area: (out): the return location for the space inside @cell_area * that would acually be used to render. * * Gets the aligned area used by @cell inside @cell_area. Used for finding * the appropriate edit and focus rectangle. * * Since: 3.0 */ void gtk_cell_renderer_get_aligned_area (GtkCellRenderer *cell, GtkWidget *widget, GtkCellRendererState flags, const GdkRectangle *cell_area, GdkRectangle *aligned_area) { GtkCellRendererClass *klass; g_return_if_fail (GTK_IS_CELL_RENDERER (cell)); g_return_if_fail (GTK_IS_WIDGET (widget)); g_return_if_fail (cell_area != NULL); g_return_if_fail (aligned_area != NULL); klass = GTK_CELL_RENDERER_GET_CLASS (cell); klass->get_aligned_area (cell, widget, flags, cell_area, aligned_area); g_assert (aligned_area->x >= cell_area->x && aligned_area->x <= cell_area->x + cell_area->width); g_assert (aligned_area->y >= cell_area->y && aligned_area->y <= cell_area->y + cell_area->height); g_assert ((aligned_area->x - cell_area->x) + aligned_area->width <= cell_area->width); g_assert ((aligned_area->y - cell_area->y) + aligned_area->height <= cell_area->height); } /** * gtk_cell_renderer_get_state: * @cell: (nullable): a #GtkCellRenderer, or %NULL * @widget: (nullable): a #GtkWidget, or %NULL * @cell_state: cell renderer state * * Translates the cell renderer state to #GtkStateFlags, * based on the cell renderer and widget sensitivity, and * the given #GtkCellRendererState. * * Returns: the widget state flags applying to @cell * * Since: 3.0 **/ GtkStateFlags gtk_cell_renderer_get_state (GtkCellRenderer *cell, GtkWidget *widget, GtkCellRendererState cell_state) { GtkStateFlags state = 0; g_return_val_if_fail (!cell || GTK_IS_CELL_RENDERER (cell), 0); g_return_val_if_fail (!widget || GTK_IS_WIDGET (widget), 0); if (widget) state |= gtk_widget_get_state_flags (widget); state &= ~(GTK_STATE_FLAG_FOCUSED | GTK_STATE_FLAG_PRELIGHT | GTK_STATE_FLAG_SELECTED | GTK_STATE_FLAG_DROP_ACTIVE); if ((state & GTK_STATE_FLAG_INSENSITIVE) != 0 || (cell && !gtk_cell_renderer_get_sensitive (cell)) || (cell_state & GTK_CELL_RENDERER_INSENSITIVE) != 0) { state |= GTK_STATE_FLAG_INSENSITIVE; } else { if ((widget && gtk_widget_has_focus (widget)) && (cell_state & GTK_CELL_RENDERER_FOCUSED) != 0) state |= GTK_STATE_FLAG_FOCUSED; if ((cell_state & GTK_CELL_RENDERER_PRELIT) != 0) state |= GTK_STATE_FLAG_PRELIGHT; } if ((cell_state & GTK_CELL_RENDERER_SELECTED) != 0) state |= GTK_STATE_FLAG_SELECTED; return state; } /** * gtk_cell_renderer_class_set_accessible_type: * @renderer_class: class to set the accessible type for * @type: The object type that implements the accessible for @widget_class. * The type must be a subtype of #GtkRendererCellAccessible * * Sets the type to be used for creating accessibles for cells rendered by * cell renderers of @renderer_class. Note that multiple accessibles will * be created. * * This function should only be called from class init functions of cell * renderers. **/ void gtk_cell_renderer_class_set_accessible_type (GtkCellRendererClass *renderer_class, GType type) { GtkCellRendererClassPrivate *priv; g_return_if_fail (GTK_IS_CELL_RENDERER_CLASS (renderer_class)); g_return_if_fail (g_type_is_a (type, GTK_TYPE_RENDERER_CELL_ACCESSIBLE)); priv = renderer_class->priv; priv->accessible_type = type; } GType _gtk_cell_renderer_get_accessible_type (GtkCellRenderer *renderer) { g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), GTK_TYPE_RENDERER_CELL_ACCESSIBLE); return GTK_CELL_RENDERER_GET_CLASS (renderer)->priv->accessible_type; }