forked from AuroraMiddleware/gtk
a546ae32d7
Those property features don't seem to be in use anywhere. They are redundant since the docs cover the same information and more. They also created unnecessary translation work. Closes #4904
3554 lines
127 KiB
C
3554 lines
127 KiB
C
/* gtkcellarea.c
|
||
*
|
||
* Copyright (C) 2010 Openismus GmbH
|
||
*
|
||
* Authors:
|
||
* Tristan Van Berkom <tristanvb@openismus.com>
|
||
*
|
||
* 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 <http://www.gnu.org/licenses/>.
|
||
*/
|
||
|
||
/**
|
||
* GtkCellArea:
|
||
*
|
||
* An abstract class for laying out `GtkCellRenderer`s
|
||
*
|
||
* The `GtkCellArea` is an abstract class for [iface@Gtk.CellLayout]
|
||
* widgets (also referred to as "layouting widgets") to interface with
|
||
* an arbitrary number of [class@Gtk.CellRenderer]s and interact with the user
|
||
* for a given [iface@Gtk.TreeModel] row.
|
||
*
|
||
* The cell area handles events, focus navigation, drawing and
|
||
* size requests and allocations for a given row of data.
|
||
*
|
||
* Usually users dont have to interact with the `GtkCellArea` directly
|
||
* unless they are implementing a cell-layouting widget themselves.
|
||
*
|
||
* # Requesting area sizes
|
||
*
|
||
* As outlined in
|
||
* [GtkWidget’s geometry management section](class.Widget.html#height-for-width-geometry-management),
|
||
* GTK uses a height-for-width
|
||
* geometry management system to compute the sizes of widgets and user
|
||
* interfaces. `GtkCellArea` uses the same semantics to calculate the
|
||
* size of an area for an arbitrary number of `GtkTreeModel` rows.
|
||
*
|
||
* When requesting the size of a cell area one needs to calculate
|
||
* the size for a handful of rows, and this will be done differently by
|
||
* different layouting widgets. For instance a [class@Gtk.TreeViewColumn]
|
||
* always lines up the areas from top to bottom while a [class@Gtk.IconView]
|
||
* on the other hand might enforce that all areas received the same
|
||
* width and wrap the areas around, requesting height for more cell
|
||
* areas when allocated less width.
|
||
*
|
||
* It’s also important for areas to maintain some cell
|
||
* alignments with areas rendered for adjacent rows (cells can
|
||
* appear “columnized” inside an area even when the size of
|
||
* cells are different in each row). For this reason the `GtkCellArea`
|
||
* uses a [class@Gtk.CellAreaContext] object to store the alignments
|
||
* and sizes along the way (as well as the overall largest minimum
|
||
* and natural size for all the rows which have been calculated
|
||
* with the said context).
|
||
*
|
||
* The [class@Gtk.CellAreaContext] is an opaque object specific to the
|
||
* `GtkCellArea` which created it (see [method@Gtk.CellArea.create_context]).
|
||
*
|
||
* The owning cell-layouting widget can create as many contexts as
|
||
* it wishes to calculate sizes of rows which should receive the
|
||
* same size in at least one orientation (horizontally or vertically),
|
||
* However, it’s important that the same [class@Gtk.CellAreaContext] which
|
||
* was used to request the sizes for a given `GtkTreeModel` row be
|
||
* used when rendering or processing events for that row.
|
||
*
|
||
* In order to request the width of all the rows at the root level
|
||
* of a `GtkTreeModel` one would do the following:
|
||
*
|
||
* ```c
|
||
* GtkTreeIter iter;
|
||
* int minimum_width;
|
||
* int natural_width;
|
||
*
|
||
* valid = gtk_tree_model_get_iter_first (model, &iter);
|
||
* while (valid)
|
||
* {
|
||
* gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
|
||
* gtk_cell_area_get_preferred_width (area, context, widget, NULL, NULL);
|
||
*
|
||
* valid = gtk_tree_model_iter_next (model, &iter);
|
||
* }
|
||
*
|
||
* gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width);
|
||
* ```
|
||
*
|
||
* Note that in this example it’s not important to observe the
|
||
* returned minimum and natural width of the area for each row
|
||
* unless the cell-layouting object is actually interested in the
|
||
* widths of individual rows. The overall width is however stored
|
||
* in the accompanying `GtkCellAreaContext` object and can be consulted
|
||
* at any time.
|
||
*
|
||
* This can be useful since `GtkCellLayout` widgets usually have to
|
||
* support requesting and rendering rows in treemodels with an
|
||
* exceedingly large amount of rows. The `GtkCellLayout` widget in
|
||
* that case would calculate the required width of the rows in an
|
||
* idle or timeout source (see [func@GLib.timeout_add]) and when the widget
|
||
* is requested its actual width in [vfunc@Gtk.Widget.measure]
|
||
* it can simply consult the width accumulated so far in the
|
||
* `GtkCellAreaContext` object.
|
||
*
|
||
* A simple example where rows are rendered from top to bottom and
|
||
* take up the full width of the layouting widget would look like:
|
||
*
|
||
* ```c
|
||
* static void
|
||
* foo_get_preferred_width (GtkWidget *widget,
|
||
* int *minimum_size,
|
||
* int *natural_size)
|
||
* {
|
||
* Foo *self = FOO (widget);
|
||
* FooPrivate *priv = foo_get_instance_private (self);
|
||
*
|
||
* foo_ensure_at_least_one_handfull_of_rows_have_been_requested (self);
|
||
*
|
||
* gtk_cell_area_context_get_preferred_width (priv->context, minimum_size, natural_size);
|
||
* }
|
||
* ```
|
||
*
|
||
* In the above example the `Foo` widget has to make sure that some
|
||
* row sizes have been calculated (the amount of rows that `Foo` judged
|
||
* was appropriate to request space for in a single timeout iteration)
|
||
* before simply returning the amount of space required by the area via
|
||
* the `GtkCellAreaContext`.
|
||
*
|
||
* Requesting the height for width (or width for height) of an area is
|
||
* a similar task except in this case the `GtkCellAreaContext` does not
|
||
* store the data (actually, it does not know how much space the layouting
|
||
* widget plans to allocate it for every row. It’s up to the layouting
|
||
* widget to render each row of data with the appropriate height and
|
||
* width which was requested by the `GtkCellArea`).
|
||
*
|
||
* In order to request the height for width of all the rows at the
|
||
* root level of a `GtkTreeModel` one would do the following:
|
||
*
|
||
* ```c
|
||
* GtkTreeIter iter;
|
||
* int minimum_height;
|
||
* int natural_height;
|
||
* int full_minimum_height = 0;
|
||
* int full_natural_height = 0;
|
||
*
|
||
* valid = gtk_tree_model_get_iter_first (model, &iter);
|
||
* while (valid)
|
||
* {
|
||
* gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
|
||
* gtk_cell_area_get_preferred_height_for_width (area, context, widget,
|
||
* width, &minimum_height, &natural_height);
|
||
*
|
||
* if (width_is_for_allocation)
|
||
* cache_row_height (&iter, minimum_height, natural_height);
|
||
*
|
||
* full_minimum_height += minimum_height;
|
||
* full_natural_height += natural_height;
|
||
*
|
||
* valid = gtk_tree_model_iter_next (model, &iter);
|
||
* }
|
||
* ```
|
||
*
|
||
* Note that in the above example we would need to cache the heights
|
||
* returned for each row so that we would know what sizes to render the
|
||
* areas for each row. However we would only want to really cache the
|
||
* heights if the request is intended for the layouting widgets real
|
||
* allocation.
|
||
*
|
||
* In some cases the layouting widget is requested the height for an
|
||
* arbitrary for_width, this is a special case for layouting widgets
|
||
* who need to request size for tens of thousands of rows. For this
|
||
* case it’s only important that the layouting widget calculate
|
||
* one reasonably sized chunk of rows and return that height
|
||
* synchronously. The reasoning here is that any layouting widget is
|
||
* at least capable of synchronously calculating enough height to fill
|
||
* the screen height (or scrolled window height) in response to a single
|
||
* call to [vfunc@Gtk.Widget.measure]. Returning
|
||
* a perfect height for width that is larger than the screen area is
|
||
* inconsequential since after the layouting receives an allocation
|
||
* from a scrolled window it simply continues to drive the scrollbar
|
||
* values while more and more height is required for the row heights
|
||
* that are calculated in the background.
|
||
*
|
||
* # Rendering Areas
|
||
*
|
||
* Once area sizes have been acquired at least for the rows in the
|
||
* visible area of the layouting widget they can be rendered at
|
||
* [vfunc@Gtk.Widget.snapshot] time.
|
||
*
|
||
* A crude example of how to render all the rows at the root level
|
||
* runs as follows:
|
||
*
|
||
* ```c
|
||
* GtkAllocation allocation;
|
||
* GdkRectangle cell_area = { 0, };
|
||
* GtkTreeIter iter;
|
||
* int minimum_width;
|
||
* int natural_width;
|
||
*
|
||
* gtk_widget_get_allocation (widget, &allocation);
|
||
* cell_area.width = allocation.width;
|
||
*
|
||
* valid = gtk_tree_model_get_iter_first (model, &iter);
|
||
* while (valid)
|
||
* {
|
||
* cell_area.height = get_cached_height_for_row (&iter);
|
||
*
|
||
* gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE);
|
||
* gtk_cell_area_render (area, context, widget, cr,
|
||
* &cell_area, &cell_area, state_flags, FALSE);
|
||
*
|
||
* cell_area.y += cell_area.height;
|
||
*
|
||
* valid = gtk_tree_model_iter_next (model, &iter);
|
||
* }
|
||
* ```
|
||
*
|
||
* Note that the cached height in this example really depends on how
|
||
* the layouting widget works. The layouting widget might decide to
|
||
* give every row its minimum or natural height or, if the model content
|
||
* is expected to fit inside the layouting widget without scrolling, it
|
||
* would make sense to calculate the allocation for each row at
|
||
* the time the widget is allocated using [func@Gtk.distribute_natural_allocation].
|
||
*
|
||
* # Handling Events and Driving Keyboard Focus
|
||
*
|
||
* Passing events to the area is as simple as handling events on any
|
||
* normal widget and then passing them to the [method@Gtk.CellArea.event]
|
||
* API as they come in. Usually `GtkCellArea` is only interested in
|
||
* button events, however some customized derived areas can be implemented
|
||
* who are interested in handling other events. Handling an event can
|
||
* trigger the [`signal@Gtk.CellArea::focus-changed`] signal to fire; as well
|
||
* as [`signal@GtkCellArea::add-editable`] in the case that an editable cell
|
||
* was clicked and needs to start editing. You can call
|
||
* [method@Gtk.CellArea.stop_editing] at any time to cancel any cell editing
|
||
* that is currently in progress.
|
||
*
|
||
* The `GtkCellArea` drives keyboard focus from cell to cell in a way
|
||
* similar to `GtkWidget`. For layouting widgets that support giving
|
||
* focus to cells it’s important to remember to pass `GTK_CELL_RENDERER_FOCUSED`
|
||
* to the area functions for the row that has focus and to tell the
|
||
* area to paint the focus at render time.
|
||
*
|
||
* Layouting widgets that accept focus on cells should implement the
|
||
* [vfunc@Gtk.Widget.focus] virtual method. The layouting widget is always
|
||
* responsible for knowing where `GtkTreeModel` rows are rendered inside
|
||
* the widget, so at [vfunc@Gtk.Widget.focus] time the layouting widget
|
||
* should use the `GtkCellArea` methods to navigate focus inside the area
|
||
* and then observe the [enum@Gtk.DirectionType] to pass the focus to adjacent
|
||
* rows and areas.
|
||
*
|
||
* A basic example of how the [vfunc@Gtk.Widget.focus] virtual method
|
||
* should be implemented:
|
||
*
|
||
* ```
|
||
* static gboolean
|
||
* foo_focus (GtkWidget *widget,
|
||
* GtkDirectionType direction)
|
||
* {
|
||
* Foo *self = FOO (widget);
|
||
* FooPrivate *priv = foo_get_instance_private (self);
|
||
* int focus_row = priv->focus_row;
|
||
* gboolean have_focus = FALSE;
|
||
*
|
||
* if (!gtk_widget_has_focus (widget))
|
||
* gtk_widget_grab_focus (widget);
|
||
*
|
||
* valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, priv->focus_row);
|
||
* while (valid)
|
||
* {
|
||
* gtk_cell_area_apply_attributes (priv->area, priv->model, &iter, FALSE, FALSE);
|
||
*
|
||
* if (gtk_cell_area_focus (priv->area, direction))
|
||
* {
|
||
* priv->focus_row = focus_row;
|
||
* have_focus = TRUE;
|
||
* break;
|
||
* }
|
||
* else
|
||
* {
|
||
* if (direction == GTK_DIR_RIGHT ||
|
||
* direction == GTK_DIR_LEFT)
|
||
* break;
|
||
* else if (direction == GTK_DIR_UP ||
|
||
* direction == GTK_DIR_TAB_BACKWARD)
|
||
* {
|
||
* if (focus_row == 0)
|
||
* break;
|
||
* else
|
||
* {
|
||
* focus_row--;
|
||
* valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, focus_row);
|
||
* }
|
||
* }
|
||
* else
|
||
* {
|
||
* if (focus_row == last_row)
|
||
* break;
|
||
* else
|
||
* {
|
||
* focus_row++;
|
||
* valid = gtk_tree_model_iter_next (priv->model, &iter);
|
||
* }
|
||
* }
|
||
* }
|
||
* }
|
||
* return have_focus;
|
||
* }
|
||
* ```
|
||
*
|
||
* Note that the layouting widget is responsible for matching the
|
||
* `GtkDirectionType` values to the way it lays out its cells.
|
||
*
|
||
* # Cell Properties
|
||
*
|
||
* The `GtkCellArea` introduces cell properties for `GtkCellRenderer`s.
|
||
* This provides some general interfaces for defining the relationship
|
||
* cell areas have with their cells. For instance in a [class@Gtk.CellAreaBox]
|
||
* a cell might “expand” and receive extra space when the area is allocated
|
||
* more than its full natural request, or a cell might be configured to “align”
|
||
* with adjacent rows which were requested and rendered with the same
|
||
* `GtkCellAreaContext`.
|
||
*
|
||
* Use [method@Gtk.CellAreaClass.install_cell_property] to install cell
|
||
* properties for a cell area class and [method@Gtk.CellAreaClass.find_cell_property]
|
||
* or [method@Gtk.CellAreaClass.list_cell_properties] to get information about
|
||
* existing cell properties.
|
||
*
|
||
* To set the value of a cell property, use [method@Gtk.CellArea.cell_set_property],
|
||
* [method@Gtk.CellArea.cell_set] or [method@Gtk.CellArea.cell_set_valist]. To obtain
|
||
* the value of a cell property, use [method@Gtk.CellArea.cell_get_property]
|
||
* [method@Gtk.CellArea.cell_get] or [method@Gtk.CellArea.cell_get_valist].
|
||
*/
|
||
|
||
#include "config.h"
|
||
|
||
#include <stdarg.h>
|
||
#include <string.h>
|
||
#include <stdlib.h>
|
||
|
||
#include "gtkintl.h"
|
||
#include "gtkcelllayout.h"
|
||
#include "gtkcellarea.h"
|
||
#include "gtkcellareacontext.h"
|
||
#include "gtkmarshalers.h"
|
||
#include "gtkprivate.h"
|
||
#include "gtksnapshot.h"
|
||
#include "gtkstylecontext.h"
|
||
#include "gtknative.h"
|
||
|
||
#include <gobject/gvaluecollector.h>
|
||
|
||
|
||
/* GObjectClass */
|
||
static void gtk_cell_area_dispose (GObject *object);
|
||
static void gtk_cell_area_finalize (GObject *object);
|
||
static void gtk_cell_area_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec);
|
||
static void gtk_cell_area_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec);
|
||
|
||
/* GtkCellAreaClass */
|
||
static void gtk_cell_area_real_add (GtkCellArea *area,
|
||
GtkCellRenderer *renderer);
|
||
static void gtk_cell_area_real_remove (GtkCellArea *area,
|
||
GtkCellRenderer *renderer);
|
||
static void gtk_cell_area_real_foreach (GtkCellArea *area,
|
||
GtkCellCallback callback,
|
||
gpointer callback_data);
|
||
static void gtk_cell_area_real_foreach_alloc (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *background_area,
|
||
GtkCellAllocCallback callback,
|
||
gpointer callback_data);
|
||
static int gtk_cell_area_real_event (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GdkEvent *event,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags);
|
||
static void gtk_cell_area_real_snapshot (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GtkSnapshot *snapshot,
|
||
const GdkRectangle *background_area,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean paint_focus);
|
||
static void gtk_cell_area_real_apply_attributes (GtkCellArea *area,
|
||
GtkTreeModel *tree_model,
|
||
GtkTreeIter *iter,
|
||
gboolean is_expander,
|
||
gboolean is_expanded);
|
||
|
||
static GtkCellAreaContext *gtk_cell_area_real_create_context (GtkCellArea *area);
|
||
static GtkCellAreaContext *gtk_cell_area_real_copy_context (GtkCellArea *area,
|
||
GtkCellAreaContext *context);
|
||
static GtkSizeRequestMode gtk_cell_area_real_get_request_mode (GtkCellArea *area);
|
||
static void gtk_cell_area_real_get_preferred_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_width,
|
||
int *natural_width);
|
||
static void gtk_cell_area_real_get_preferred_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_height,
|
||
int *natural_height);
|
||
static void gtk_cell_area_real_get_preferred_height_for_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int width,
|
||
int *minimum_height,
|
||
int *natural_height);
|
||
static void gtk_cell_area_real_get_preferred_width_for_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int height,
|
||
int *minimum_width,
|
||
int *natural_width);
|
||
static gboolean gtk_cell_area_real_is_activatable (GtkCellArea *area);
|
||
static gboolean gtk_cell_area_real_activate (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean edit_only);
|
||
static gboolean gtk_cell_area_real_focus (GtkCellArea *area,
|
||
GtkDirectionType direction);
|
||
|
||
/* GtkCellLayoutIface */
|
||
static void gtk_cell_area_cell_layout_init (GtkCellLayoutIface *iface);
|
||
static void gtk_cell_area_pack_default (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer,
|
||
gboolean expand);
|
||
static void gtk_cell_area_clear (GtkCellLayout *cell_layout);
|
||
static void gtk_cell_area_add_attribute (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer,
|
||
const char *attribute,
|
||
int column);
|
||
static void gtk_cell_area_set_cell_data_func (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *cell,
|
||
GtkCellLayoutDataFunc func,
|
||
gpointer func_data,
|
||
GDestroyNotify destroy);
|
||
static void gtk_cell_area_clear_attributes (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer);
|
||
static void gtk_cell_area_reorder (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *cell,
|
||
int position);
|
||
static GList *gtk_cell_area_get_cells (GtkCellLayout *cell_layout);
|
||
static GtkCellArea *gtk_cell_area_get_area (GtkCellLayout *cell_layout);
|
||
|
||
/* GtkBuildableIface */
|
||
static void gtk_cell_area_buildable_init (GtkBuildableIface *iface);
|
||
static void gtk_cell_area_buildable_custom_tag_end (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const char *tagname,
|
||
gpointer data);
|
||
|
||
/* Used in foreach loop to check if a child renderer is present */
|
||
typedef struct {
|
||
GtkCellRenderer *renderer;
|
||
gboolean has_renderer;
|
||
} HasRendererCheck;
|
||
|
||
/* Used in foreach loop to get a cell's allocation */
|
||
typedef struct {
|
||
GtkCellRenderer *renderer;
|
||
GdkRectangle allocation;
|
||
} RendererAllocationData;
|
||
|
||
/* Used in foreach loop to render cells */
|
||
typedef struct {
|
||
GtkCellArea *area;
|
||
GtkWidget *widget;
|
||
GtkSnapshot *snapshot;
|
||
GdkRectangle focus_rect;
|
||
GtkCellRendererState render_flags;
|
||
guint paint_focus : 1;
|
||
guint focus_all : 1;
|
||
guint first_focus : 1;
|
||
} CellRenderData;
|
||
|
||
/* Used in foreach loop to get a cell by position */
|
||
typedef struct {
|
||
int x;
|
||
int y;
|
||
GtkCellRenderer *renderer;
|
||
GdkRectangle cell_area;
|
||
} CellByPositionData;
|
||
|
||
/* Attribute/Cell metadata */
|
||
typedef struct {
|
||
const char *attribute;
|
||
int column;
|
||
} CellAttribute;
|
||
|
||
typedef struct {
|
||
GSList *attributes;
|
||
|
||
GtkCellLayoutDataFunc func;
|
||
gpointer data;
|
||
GDestroyNotify destroy;
|
||
GtkCellLayout *proxy;
|
||
} CellInfo;
|
||
|
||
static CellInfo *cell_info_new (GtkCellLayoutDataFunc func,
|
||
gpointer data,
|
||
GDestroyNotify destroy);
|
||
static void cell_info_free (CellInfo *info);
|
||
static CellAttribute *cell_attribute_new (GtkCellRenderer *renderer,
|
||
const char *attribute,
|
||
int column);
|
||
static void cell_attribute_free (CellAttribute *attribute);
|
||
static int cell_attribute_find (CellAttribute *cell_attribute,
|
||
const char *attribute);
|
||
|
||
/* Internal functions/signal emissions */
|
||
static void gtk_cell_area_add_editable (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellEditable *editable,
|
||
const GdkRectangle *cell_area);
|
||
static void gtk_cell_area_remove_editable (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellEditable *editable);
|
||
static void gtk_cell_area_set_edit_widget (GtkCellArea *area,
|
||
GtkCellEditable *editable);
|
||
static void gtk_cell_area_set_edited_cell (GtkCellArea *area,
|
||
GtkCellRenderer *renderer);
|
||
|
||
|
||
/* Struct to pass data along while looping over
|
||
* cell renderers to apply attributes
|
||
*/
|
||
typedef struct {
|
||
GtkCellArea *area;
|
||
GtkTreeModel *model;
|
||
GtkTreeIter *iter;
|
||
gboolean is_expander;
|
||
gboolean is_expanded;
|
||
} AttributeData;
|
||
|
||
typedef struct _GtkCellAreaPrivate GtkCellAreaPrivate;
|
||
|
||
struct _GtkCellAreaPrivate
|
||
{
|
||
/* The GtkCellArea bookkeeps any connected
|
||
* attributes in this hash table.
|
||
*/
|
||
GHashTable *cell_info;
|
||
|
||
/* Current path is saved as a side-effect
|
||
* of gtk_cell_area_apply_attributes()
|
||
*/
|
||
char *current_path;
|
||
|
||
/* Current cell being edited and editable widget used */
|
||
GtkCellEditable *edit_widget;
|
||
GtkCellRenderer *edited_cell;
|
||
|
||
/* Signal connections to the editable widget */
|
||
gulong remove_widget_id;
|
||
|
||
/* Currently focused cell */
|
||
GtkCellRenderer *focus_cell;
|
||
|
||
/* Tracking which cells are focus siblings of focusable cells */
|
||
GHashTable *focus_siblings;
|
||
};
|
||
|
||
enum {
|
||
PROP_0,
|
||
PROP_FOCUS_CELL,
|
||
PROP_EDITED_CELL,
|
||
PROP_EDIT_WIDGET
|
||
};
|
||
|
||
enum {
|
||
SIGNAL_APPLY_ATTRIBUTES,
|
||
SIGNAL_ADD_EDITABLE,
|
||
SIGNAL_REMOVE_EDITABLE,
|
||
SIGNAL_FOCUS_CHANGED,
|
||
LAST_SIGNAL
|
||
};
|
||
|
||
/* Keep the paramspec pool internal, no need to deliver notifications
|
||
* on cells. at least no perceived need for now
|
||
*/
|
||
static GParamSpecPool *cell_property_pool = NULL;
|
||
static guint cell_area_signals[LAST_SIGNAL] = { 0 };
|
||
|
||
#define PARAM_SPEC_PARAM_ID(pspec) ((pspec)->param_id)
|
||
#define PARAM_SPEC_SET_PARAM_ID(pspec, id) ((pspec)->param_id = (id))
|
||
|
||
G_DEFINE_ABSTRACT_TYPE_WITH_CODE (GtkCellArea, gtk_cell_area, G_TYPE_INITIALLY_UNOWNED,
|
||
G_ADD_PRIVATE (GtkCellArea)
|
||
G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
|
||
gtk_cell_area_cell_layout_init)
|
||
G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
|
||
gtk_cell_area_buildable_init))
|
||
|
||
static void
|
||
gtk_cell_area_init (GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
priv->cell_info = g_hash_table_new_full (g_direct_hash,
|
||
g_direct_equal,
|
||
NULL,
|
||
(GDestroyNotify)cell_info_free);
|
||
|
||
priv->focus_siblings = g_hash_table_new_full (g_direct_hash,
|
||
g_direct_equal,
|
||
NULL,
|
||
(GDestroyNotify)g_list_free);
|
||
|
||
priv->focus_cell = NULL;
|
||
priv->edited_cell = NULL;
|
||
priv->edit_widget = NULL;
|
||
|
||
priv->remove_widget_id = 0;
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_class_init (GtkCellAreaClass *class)
|
||
{
|
||
GObjectClass *object_class = G_OBJECT_CLASS (class);
|
||
|
||
/* GObjectClass */
|
||
object_class->dispose = gtk_cell_area_dispose;
|
||
object_class->finalize = gtk_cell_area_finalize;
|
||
object_class->get_property = gtk_cell_area_get_property;
|
||
object_class->set_property = gtk_cell_area_set_property;
|
||
|
||
/* general */
|
||
class->add = gtk_cell_area_real_add;
|
||
class->remove = gtk_cell_area_real_remove;
|
||
class->foreach = gtk_cell_area_real_foreach;
|
||
class->foreach_alloc = gtk_cell_area_real_foreach_alloc;
|
||
class->event = gtk_cell_area_real_event;
|
||
class->snapshot = gtk_cell_area_real_snapshot;
|
||
class->apply_attributes = gtk_cell_area_real_apply_attributes;
|
||
|
||
/* geometry */
|
||
class->create_context = gtk_cell_area_real_create_context;
|
||
class->copy_context = gtk_cell_area_real_copy_context;
|
||
class->get_request_mode = gtk_cell_area_real_get_request_mode;
|
||
class->get_preferred_width = gtk_cell_area_real_get_preferred_width;
|
||
class->get_preferred_height = gtk_cell_area_real_get_preferred_height;
|
||
class->get_preferred_height_for_width = gtk_cell_area_real_get_preferred_height_for_width;
|
||
class->get_preferred_width_for_height = gtk_cell_area_real_get_preferred_width_for_height;
|
||
|
||
/* focus */
|
||
class->is_activatable = gtk_cell_area_real_is_activatable;
|
||
class->activate = gtk_cell_area_real_activate;
|
||
class->focus = gtk_cell_area_real_focus;
|
||
|
||
/* Signals */
|
||
/**
|
||
* GtkCellArea::apply-attributes:
|
||
* @area: the `GtkCellArea` to apply the attributes to
|
||
* @model: the `GtkTreeModel` to apply the attributes from
|
||
* @iter: the `GtkTreeIter` indicating which row to apply the attributes of
|
||
* @is_expander: whether the view shows children for this row
|
||
* @is_expanded: whether the view is currently showing the children of this row
|
||
*
|
||
* This signal is emitted whenever applying attributes to @area from @model
|
||
*/
|
||
cell_area_signals[SIGNAL_APPLY_ATTRIBUTES] =
|
||
g_signal_new (I_("apply-attributes"),
|
||
G_OBJECT_CLASS_TYPE (object_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
G_STRUCT_OFFSET (GtkCellAreaClass, apply_attributes),
|
||
NULL, NULL,
|
||
_gtk_marshal_VOID__OBJECT_BOXED_BOOLEAN_BOOLEAN,
|
||
G_TYPE_NONE, 4,
|
||
GTK_TYPE_TREE_MODEL,
|
||
GTK_TYPE_TREE_ITER,
|
||
G_TYPE_BOOLEAN,
|
||
G_TYPE_BOOLEAN);
|
||
g_signal_set_va_marshaller (cell_area_signals[SIGNAL_APPLY_ATTRIBUTES], G_TYPE_FROM_CLASS (class),
|
||
_gtk_marshal_VOID__OBJECT_BOXED_BOOLEAN_BOOLEANv);
|
||
|
||
/**
|
||
* GtkCellArea::add-editable:
|
||
* @area: the `GtkCellArea` where editing started
|
||
* @renderer: the `GtkCellRenderer` that started the edited
|
||
* @editable: the `GtkCellEditable` widget to add
|
||
* @cell_area: the `GtkWidget` relative `GdkRectangle` coordinates
|
||
* where @editable should be added
|
||
* @path: the `GtkTreePath` string this edit was initiated for
|
||
*
|
||
* Indicates that editing has started on @renderer and that @editable
|
||
* should be added to the owning cell-layouting widget at @cell_area.
|
||
*/
|
||
cell_area_signals[SIGNAL_ADD_EDITABLE] =
|
||
g_signal_new (I_("add-editable"),
|
||
G_OBJECT_CLASS_TYPE (object_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
0, /* No class closure here */
|
||
NULL, NULL,
|
||
_gtk_marshal_VOID__OBJECT_OBJECT_BOXED_STRING,
|
||
G_TYPE_NONE, 4,
|
||
GTK_TYPE_CELL_RENDERER,
|
||
GTK_TYPE_CELL_EDITABLE,
|
||
GDK_TYPE_RECTANGLE,
|
||
G_TYPE_STRING);
|
||
|
||
|
||
/**
|
||
* GtkCellArea::remove-editable:
|
||
* @area: the `GtkCellArea` where editing finished
|
||
* @renderer: the `GtkCellRenderer` that finished editeding
|
||
* @editable: the `GtkCellEditable` widget to remove
|
||
*
|
||
* Indicates that editing finished on @renderer and that @editable
|
||
* should be removed from the owning cell-layouting widget.
|
||
*/
|
||
cell_area_signals[SIGNAL_REMOVE_EDITABLE] =
|
||
g_signal_new (I_("remove-editable"),
|
||
G_OBJECT_CLASS_TYPE (object_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
0, /* No class closure here */
|
||
NULL, NULL,
|
||
_gtk_marshal_VOID__OBJECT_OBJECT,
|
||
G_TYPE_NONE, 2,
|
||
GTK_TYPE_CELL_RENDERER,
|
||
GTK_TYPE_CELL_EDITABLE);
|
||
|
||
/**
|
||
* GtkCellArea::focus-changed:
|
||
* @area: the `GtkCellArea` where focus changed
|
||
* @renderer: the `GtkCellRenderer` that has focus
|
||
* @path: the current `GtkTreePath` string set for @area
|
||
*
|
||
* Indicates that focus changed on this @area. This signal
|
||
* is emitted either as a result of focus handling or event
|
||
* handling.
|
||
*
|
||
* It's possible that the signal is emitted even if the
|
||
* currently focused renderer did not change, this is
|
||
* because focus may change to the same renderer in the
|
||
* same cell area for a different row of data.
|
||
*/
|
||
cell_area_signals[SIGNAL_FOCUS_CHANGED] =
|
||
g_signal_new (I_("focus-changed"),
|
||
G_OBJECT_CLASS_TYPE (object_class),
|
||
G_SIGNAL_RUN_FIRST,
|
||
0, /* No class closure here */
|
||
NULL, NULL,
|
||
_gtk_marshal_VOID__OBJECT_STRING,
|
||
G_TYPE_NONE, 2,
|
||
GTK_TYPE_CELL_RENDERER,
|
||
G_TYPE_STRING);
|
||
|
||
/* Properties */
|
||
/**
|
||
* GtkCellArea:focus-cell:
|
||
*
|
||
* The cell in the area that currently has focus
|
||
*/
|
||
g_object_class_install_property (object_class,
|
||
PROP_FOCUS_CELL,
|
||
g_param_spec_object ("focus-cell", NULL, NULL,
|
||
GTK_TYPE_CELL_RENDERER,
|
||
GTK_PARAM_READWRITE));
|
||
|
||
/**
|
||
* GtkCellArea:edited-cell:
|
||
*
|
||
* The cell in the area that is currently edited
|
||
*
|
||
* This property is read-only and only changes as
|
||
* a result of a call gtk_cell_area_activate_cell().
|
||
*/
|
||
g_object_class_install_property (object_class,
|
||
PROP_EDITED_CELL,
|
||
g_param_spec_object ("edited-cell", NULL, NULL,
|
||
GTK_TYPE_CELL_RENDERER,
|
||
GTK_PARAM_READABLE));
|
||
|
||
/**
|
||
* GtkCellArea:edit-widget:
|
||
*
|
||
* The widget currently editing the edited cell
|
||
*
|
||
* This property is read-only and only changes as
|
||
* a result of a call gtk_cell_area_activate_cell().
|
||
*/
|
||
g_object_class_install_property (object_class,
|
||
PROP_EDIT_WIDGET,
|
||
g_param_spec_object ("edit-widget", NULL, NULL,
|
||
GTK_TYPE_CELL_EDITABLE,
|
||
GTK_PARAM_READABLE));
|
||
|
||
/* Pool for Cell Properties */
|
||
if (!cell_property_pool)
|
||
cell_property_pool = g_param_spec_pool_new (FALSE);
|
||
}
|
||
|
||
/*************************************************************
|
||
* CellInfo Basics *
|
||
*************************************************************/
|
||
static CellInfo *
|
||
cell_info_new (GtkCellLayoutDataFunc func,
|
||
gpointer data,
|
||
GDestroyNotify destroy)
|
||
{
|
||
CellInfo *info = g_slice_new0 (CellInfo);
|
||
|
||
info->func = func;
|
||
info->data = data;
|
||
info->destroy = destroy;
|
||
|
||
return info;
|
||
}
|
||
|
||
static void
|
||
cell_info_free (CellInfo *info)
|
||
{
|
||
if (info->destroy)
|
||
info->destroy (info->data);
|
||
|
||
g_slist_free_full (info->attributes, (GDestroyNotify)cell_attribute_free);
|
||
|
||
g_slice_free (CellInfo, info);
|
||
}
|
||
|
||
static CellAttribute *
|
||
cell_attribute_new (GtkCellRenderer *renderer,
|
||
const char *attribute,
|
||
int column)
|
||
{
|
||
GParamSpec *pspec;
|
||
|
||
/* Check if the attribute really exists and point to
|
||
* the property string installed on the cell renderer
|
||
* class (dont dup the string)
|
||
*/
|
||
pspec = g_object_class_find_property (G_OBJECT_GET_CLASS (renderer), attribute);
|
||
|
||
if (pspec)
|
||
{
|
||
CellAttribute *cell_attribute = g_slice_new (CellAttribute);
|
||
|
||
cell_attribute->attribute = pspec->name;
|
||
cell_attribute->column = column;
|
||
|
||
return cell_attribute;
|
||
}
|
||
|
||
return NULL;
|
||
}
|
||
|
||
static void
|
||
cell_attribute_free (CellAttribute *attribute)
|
||
{
|
||
g_slice_free (CellAttribute, attribute);
|
||
}
|
||
|
||
/* GCompareFunc for g_slist_find_custom() */
|
||
static int
|
||
cell_attribute_find (CellAttribute *cell_attribute,
|
||
const char *attribute)
|
||
{
|
||
return g_strcmp0 (cell_attribute->attribute, attribute);
|
||
}
|
||
|
||
/*************************************************************
|
||
* GObjectClass *
|
||
*************************************************************/
|
||
static void
|
||
gtk_cell_area_finalize (GObject *object)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (object);
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
/* All cell renderers should already be removed at this point,
|
||
* just kill our (empty) hash tables here.
|
||
*/
|
||
g_hash_table_destroy (priv->cell_info);
|
||
g_hash_table_destroy (priv->focus_siblings);
|
||
|
||
g_free (priv->current_path);
|
||
|
||
G_OBJECT_CLASS (gtk_cell_area_parent_class)->finalize (object);
|
||
}
|
||
|
||
|
||
static void
|
||
gtk_cell_area_dispose (GObject *object)
|
||
{
|
||
/* This removes every cell renderer that may be added to the GtkCellArea,
|
||
* subclasses should be breaking references to the GtkCellRenderers
|
||
* at this point.
|
||
*/
|
||
gtk_cell_layout_clear (GTK_CELL_LAYOUT (object));
|
||
|
||
/* Remove any ref to a focused/edited cell */
|
||
gtk_cell_area_set_focus_cell (GTK_CELL_AREA (object), NULL);
|
||
gtk_cell_area_set_edited_cell (GTK_CELL_AREA (object), NULL);
|
||
gtk_cell_area_set_edit_widget (GTK_CELL_AREA (object), NULL);
|
||
|
||
G_OBJECT_CLASS (gtk_cell_area_parent_class)->dispose (object);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_set_property (GObject *object,
|
||
guint prop_id,
|
||
const GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (object);
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_FOCUS_CELL:
|
||
gtk_cell_area_set_focus_cell (area, (GtkCellRenderer *)g_value_get_object (value));
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_get_property (GObject *object,
|
||
guint prop_id,
|
||
GValue *value,
|
||
GParamSpec *pspec)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (object);
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
switch (prop_id)
|
||
{
|
||
case PROP_FOCUS_CELL:
|
||
g_value_set_object (value, priv->focus_cell);
|
||
break;
|
||
case PROP_EDITED_CELL:
|
||
g_value_set_object (value, priv->edited_cell);
|
||
break;
|
||
case PROP_EDIT_WIDGET:
|
||
g_value_set_object (value, priv->edit_widget);
|
||
break;
|
||
default:
|
||
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
|
||
break;
|
||
}
|
||
}
|
||
|
||
/*************************************************************
|
||
* GtkCellAreaClass *
|
||
*************************************************************/
|
||
static void
|
||
gtk_cell_area_real_add (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
g_warning ("GtkCellAreaClass::add not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_remove (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
g_warning ("GtkCellAreaClass::remove not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_foreach (GtkCellArea *area,
|
||
GtkCellCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
g_warning ("GtkCellAreaClass::foreach not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_foreach_alloc (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *background_area,
|
||
GtkCellAllocCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
g_warning ("GtkCellAreaClass::foreach_alloc not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static int
|
||
gtk_cell_area_real_event (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GdkEvent *event,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
gboolean retval = FALSE;
|
||
GdkEventType event_type = gdk_event_get_event_type (event);
|
||
|
||
if (event_type == GDK_KEY_PRESS && (flags & GTK_CELL_RENDERER_FOCUSED) != 0)
|
||
{
|
||
/* Cancel any edits in progress */
|
||
if (priv->edited_cell &&
|
||
gdk_key_event_get_keyval (event) == GDK_KEY_Escape)
|
||
{
|
||
gtk_cell_area_stop_editing (area, TRUE);
|
||
retval = TRUE;
|
||
}
|
||
}
|
||
else if (event_type == GDK_BUTTON_PRESS)
|
||
{
|
||
guint button;
|
||
|
||
button = gdk_button_event_get_button (event);
|
||
if (button == GDK_BUTTON_PRIMARY)
|
||
{
|
||
GtkCellRenderer *renderer = NULL;
|
||
GtkCellRenderer *focus_renderer;
|
||
GdkRectangle alloc_area;
|
||
double event_x, event_y;
|
||
double nx, ny;
|
||
double x, y;
|
||
GtkNative *native;
|
||
|
||
/* We may need some semantics to tell us the offset of the event
|
||
* window we are handling events for (i.e. GtkTreeView has a bin_window) */
|
||
gdk_event_get_position (event, &event_x, &event_y);
|
||
|
||
native = gtk_widget_get_native (widget);
|
||
gtk_native_get_surface_transform (native, &nx, &ny);
|
||
gtk_widget_translate_coordinates (GTK_WIDGET (native), widget, event_x - nx, event_y - ny, &x, &y);
|
||
event_x = x;
|
||
event_y = y;
|
||
|
||
/* Dont try to search for an event coordinate that is not in the area, that will
|
||
* trigger a runtime warning.
|
||
*/
|
||
if (event_x >= cell_area->x && event_x <= cell_area->x + cell_area->width &&
|
||
event_y >= cell_area->y && event_y <= cell_area->y + cell_area->height)
|
||
renderer =
|
||
gtk_cell_area_get_cell_at_position (area, context, widget,
|
||
cell_area, event_x, event_y,
|
||
&alloc_area);
|
||
|
||
if (renderer)
|
||
{
|
||
focus_renderer = gtk_cell_area_get_focus_from_sibling (area, renderer);
|
||
if (!focus_renderer)
|
||
focus_renderer = renderer;
|
||
|
||
/* If we're already editing, cancel it and set focus */
|
||
if (gtk_cell_area_get_edited_cell (area))
|
||
{
|
||
/* XXX Was it really canceled in this case ? */
|
||
gtk_cell_area_stop_editing (area, TRUE);
|
||
gtk_cell_area_set_focus_cell (area, focus_renderer);
|
||
retval = TRUE;
|
||
}
|
||
else
|
||
{
|
||
/* If we are activating via a focus sibling,
|
||
* we need to fetch the right cell area for the real event renderer */
|
||
if (focus_renderer != renderer)
|
||
gtk_cell_area_get_cell_allocation (area, context, widget, focus_renderer,
|
||
cell_area, &alloc_area);
|
||
|
||
gtk_cell_area_set_focus_cell (area, focus_renderer);
|
||
retval = gtk_cell_area_activate_cell (area, widget, focus_renderer,
|
||
event, &alloc_area, flags);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
return retval;
|
||
}
|
||
|
||
static gboolean
|
||
snapshot_cell (GtkCellRenderer *renderer,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *cell_background,
|
||
CellRenderData *data)
|
||
{
|
||
GtkCellRenderer *focus_cell;
|
||
GtkCellRendererState flags;
|
||
GdkRectangle inner_area;
|
||
|
||
focus_cell = gtk_cell_area_get_focus_cell (data->area);
|
||
flags = data->render_flags;
|
||
|
||
gtk_cell_area_inner_cell_area (data->area, data->widget, cell_area, &inner_area);
|
||
|
||
if ((flags & GTK_CELL_RENDERER_FOCUSED) &&
|
||
(data->focus_all ||
|
||
(focus_cell &&
|
||
(renderer == focus_cell ||
|
||
gtk_cell_area_is_focus_sibling (data->area, focus_cell, renderer)))))
|
||
{
|
||
GdkRectangle cell_focus;
|
||
|
||
gtk_cell_renderer_get_aligned_area (renderer, data->widget, flags, &inner_area, &cell_focus);
|
||
|
||
if (data->first_focus)
|
||
{
|
||
data->first_focus = FALSE;
|
||
data->focus_rect = cell_focus;
|
||
}
|
||
else
|
||
{
|
||
gdk_rectangle_union (&data->focus_rect, &cell_focus, &data->focus_rect);
|
||
}
|
||
}
|
||
|
||
gtk_cell_renderer_snapshot (renderer, data->snapshot, data->widget,
|
||
cell_background, &inner_area, flags);
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_snapshot (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GtkSnapshot *snapshot,
|
||
const GdkRectangle *background_area,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean paint_focus)
|
||
{
|
||
CellRenderData render_data =
|
||
{
|
||
area,
|
||
widget,
|
||
snapshot,
|
||
{ 0, },
|
||
flags,
|
||
paint_focus,
|
||
FALSE, TRUE
|
||
};
|
||
|
||
/* Make sure we dont paint a focus rectangle while there
|
||
* is an editable widget in play
|
||
*/
|
||
if (gtk_cell_area_get_edited_cell (area))
|
||
render_data.paint_focus = FALSE;
|
||
|
||
if (!gtk_widget_has_visible_focus (widget))
|
||
render_data.paint_focus = FALSE;
|
||
|
||
/* If no cell can activate but the caller wants focus painted,
|
||
* then we paint focus around all cells */
|
||
if ((flags & GTK_CELL_RENDERER_FOCUSED) != 0 && paint_focus &&
|
||
!gtk_cell_area_is_activatable (area))
|
||
render_data.focus_all = TRUE;
|
||
|
||
gtk_cell_area_foreach_alloc (area, context, widget, cell_area, background_area,
|
||
(GtkCellAllocCallback) snapshot_cell, &render_data);
|
||
|
||
if (render_data.paint_focus &&
|
||
render_data.focus_rect.width != 0 &&
|
||
render_data.focus_rect.height != 0)
|
||
{
|
||
GtkStyleContext *style_context;
|
||
GtkStateFlags renderer_state = 0;
|
||
|
||
style_context = gtk_widget_get_style_context (widget);
|
||
gtk_style_context_save (style_context);
|
||
|
||
renderer_state = gtk_cell_renderer_get_state (NULL, widget, flags);
|
||
gtk_style_context_set_state (style_context, renderer_state);
|
||
|
||
gtk_snapshot_render_focus (snapshot, style_context,
|
||
render_data.focus_rect.x, render_data.focus_rect.y,
|
||
render_data.focus_rect.width, render_data.focus_rect.height);
|
||
|
||
gtk_style_context_restore (style_context);
|
||
}
|
||
}
|
||
|
||
static void
|
||
apply_cell_attributes (GtkCellRenderer *renderer,
|
||
CellInfo *info,
|
||
AttributeData *data)
|
||
{
|
||
CellAttribute *attribute;
|
||
GSList *list;
|
||
GValue value = G_VALUE_INIT;
|
||
gboolean is_expander;
|
||
gboolean is_expanded;
|
||
|
||
g_object_freeze_notify (G_OBJECT (renderer));
|
||
|
||
/* Whether a row expands or is presently expanded can only be
|
||
* provided by the view (as these states can vary across views
|
||
* accessing the same model).
|
||
*/
|
||
is_expander = gtk_cell_renderer_get_is_expander (renderer);
|
||
if (is_expander != data->is_expander)
|
||
gtk_cell_renderer_set_is_expander (renderer, data->is_expander);
|
||
|
||
is_expanded = gtk_cell_renderer_get_is_expanded (renderer);
|
||
if (is_expanded != data->is_expanded)
|
||
gtk_cell_renderer_set_is_expanded (renderer, data->is_expanded);
|
||
|
||
/* Apply the attributes directly to the renderer */
|
||
for (list = info->attributes; list; list = list->next)
|
||
{
|
||
attribute = list->data;
|
||
|
||
gtk_tree_model_get_value (data->model, data->iter, attribute->column, &value);
|
||
g_object_set_property (G_OBJECT (renderer), attribute->attribute, &value);
|
||
g_value_unset (&value);
|
||
}
|
||
|
||
/* Call any GtkCellLayoutDataFunc that may have been set by the user
|
||
*/
|
||
if (info->func)
|
||
info->func (info->proxy ? info->proxy : GTK_CELL_LAYOUT (data->area), renderer,
|
||
data->model, data->iter, info->data);
|
||
|
||
g_object_thaw_notify (G_OBJECT (renderer));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_apply_attributes (GtkCellArea *area,
|
||
GtkTreeModel *tree_model,
|
||
GtkTreeIter *iter,
|
||
gboolean is_expander,
|
||
gboolean is_expanded)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
AttributeData data;
|
||
GtkTreePath *path;
|
||
|
||
/* Feed in data needed to apply to every renderer */
|
||
data.area = area;
|
||
data.model = tree_model;
|
||
data.iter = iter;
|
||
data.is_expander = is_expander;
|
||
data.is_expanded = is_expanded;
|
||
|
||
/* Go over any cells that have attributes or custom GtkCellLayoutDataFuncs and
|
||
* apply the data from the treemodel */
|
||
g_hash_table_foreach (priv->cell_info, (GHFunc)apply_cell_attributes, &data);
|
||
|
||
/* Update the currently applied path */
|
||
g_free (priv->current_path);
|
||
path = gtk_tree_model_get_path (tree_model, iter);
|
||
priv->current_path = gtk_tree_path_to_string (path);
|
||
gtk_tree_path_free (path);
|
||
}
|
||
|
||
static GtkCellAreaContext *
|
||
gtk_cell_area_real_create_context (GtkCellArea *area)
|
||
{
|
||
g_warning ("GtkCellAreaClass::create_context not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
|
||
return NULL;
|
||
}
|
||
|
||
static GtkCellAreaContext *
|
||
gtk_cell_area_real_copy_context (GtkCellArea *area,
|
||
GtkCellAreaContext *context)
|
||
{
|
||
g_warning ("GtkCellAreaClass::copy_context not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
|
||
return NULL;
|
||
}
|
||
|
||
static GtkSizeRequestMode
|
||
gtk_cell_area_real_get_request_mode (GtkCellArea *area)
|
||
{
|
||
/* By default cell areas are height-for-width. */
|
||
return GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH;
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_get_preferred_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_width,
|
||
int *natural_width)
|
||
{
|
||
g_warning ("GtkCellAreaClass::get_preferred_width not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_get_preferred_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_height,
|
||
int *natural_height)
|
||
{
|
||
g_warning ("GtkCellAreaClass::get_preferred_height not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_get_preferred_height_for_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int width,
|
||
int *minimum_height,
|
||
int *natural_height)
|
||
{
|
||
/* If the area doesn't do height-for-width, fallback on base preferred height */
|
||
GTK_CELL_AREA_GET_CLASS (area)->get_preferred_height (area, context, widget, minimum_height, natural_height);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_real_get_preferred_width_for_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int height,
|
||
int *minimum_width,
|
||
int *natural_width)
|
||
{
|
||
/* If the area doesn't do width-for-height, fallback on base preferred width */
|
||
GTK_CELL_AREA_GET_CLASS (area)->get_preferred_width (area, context, widget, minimum_width, natural_width);
|
||
}
|
||
|
||
static gboolean
|
||
get_is_activatable (GtkCellRenderer *renderer,
|
||
gboolean *activatable)
|
||
{
|
||
|
||
if (gtk_cell_renderer_is_activatable (renderer))
|
||
*activatable = TRUE;
|
||
|
||
return *activatable;
|
||
}
|
||
|
||
static gboolean
|
||
gtk_cell_area_real_is_activatable (GtkCellArea *area)
|
||
{
|
||
gboolean activatable = FALSE;
|
||
|
||
/* Checks if any renderer can focus for the currently applied
|
||
* attributes.
|
||
*
|
||
* Subclasses can override this in the case that they are also
|
||
* rendering widgets as well as renderers.
|
||
*/
|
||
gtk_cell_area_foreach (area, (GtkCellCallback)get_is_activatable, &activatable);
|
||
|
||
return activatable;
|
||
}
|
||
|
||
static gboolean
|
||
gtk_cell_area_real_activate (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean edit_only)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GdkRectangle renderer_area;
|
||
GtkCellRenderer *activate_cell = NULL;
|
||
GtkCellRendererMode mode;
|
||
|
||
if (priv->focus_cell)
|
||
{
|
||
g_object_get (priv->focus_cell, "mode", &mode, NULL);
|
||
|
||
if (gtk_cell_renderer_get_visible (priv->focus_cell) &&
|
||
(edit_only ? mode == GTK_CELL_RENDERER_MODE_EDITABLE :
|
||
mode != GTK_CELL_RENDERER_MODE_INERT))
|
||
activate_cell = priv->focus_cell;
|
||
}
|
||
else
|
||
{
|
||
GList *cells, *l;
|
||
|
||
/* GtkTreeView sometimes wants to activate a cell when no
|
||
* cells are in focus.
|
||
*/
|
||
cells = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (area));
|
||
for (l = cells; l && !activate_cell; l = l->next)
|
||
{
|
||
GtkCellRenderer *renderer = l->data;
|
||
|
||
g_object_get (renderer, "mode", &mode, NULL);
|
||
|
||
if (gtk_cell_renderer_get_visible (renderer) &&
|
||
(edit_only ? mode == GTK_CELL_RENDERER_MODE_EDITABLE :
|
||
mode != GTK_CELL_RENDERER_MODE_INERT))
|
||
activate_cell = renderer;
|
||
}
|
||
g_list_free (cells);
|
||
}
|
||
|
||
if (activate_cell)
|
||
{
|
||
/* Get the allocation of the focused cell.
|
||
*/
|
||
gtk_cell_area_get_cell_allocation (area, context, widget, activate_cell,
|
||
cell_area, &renderer_area);
|
||
|
||
/* Activate or Edit the cell
|
||
*
|
||
* Currently just not sending an event, renderers afaics dont use
|
||
* the event argument anyway, worst case is we can synthesize one.
|
||
*/
|
||
if (gtk_cell_area_activate_cell (area, widget, activate_cell, NULL,
|
||
&renderer_area, flags))
|
||
return TRUE;
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static gboolean
|
||
gtk_cell_area_real_focus (GtkCellArea *area,
|
||
GtkDirectionType direction)
|
||
{
|
||
g_warning ("GtkCellAreaClass::focus not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
return FALSE;
|
||
}
|
||
|
||
/*************************************************************
|
||
* GtkCellLayoutIface *
|
||
*************************************************************/
|
||
static void
|
||
gtk_cell_area_cell_layout_init (GtkCellLayoutIface *iface)
|
||
{
|
||
iface->pack_start = gtk_cell_area_pack_default;
|
||
iface->pack_end = gtk_cell_area_pack_default;
|
||
iface->clear = gtk_cell_area_clear;
|
||
iface->add_attribute = gtk_cell_area_add_attribute;
|
||
iface->set_cell_data_func = gtk_cell_area_set_cell_data_func;
|
||
iface->clear_attributes = gtk_cell_area_clear_attributes;
|
||
iface->reorder = gtk_cell_area_reorder;
|
||
iface->get_cells = gtk_cell_area_get_cells;
|
||
iface->get_area = gtk_cell_area_get_area;
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_pack_default (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer,
|
||
gboolean expand)
|
||
{
|
||
gtk_cell_area_add (GTK_CELL_AREA (cell_layout), renderer);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_clear (GtkCellLayout *cell_layout)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (cell_layout);
|
||
GList *l, *cells =
|
||
gtk_cell_layout_get_cells (cell_layout);
|
||
|
||
for (l = cells; l; l = l->next)
|
||
{
|
||
GtkCellRenderer *renderer = l->data;
|
||
gtk_cell_area_remove (area, renderer);
|
||
}
|
||
|
||
g_list_free (cells);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_add_attribute (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer,
|
||
const char *attribute,
|
||
int column)
|
||
{
|
||
gtk_cell_area_attribute_connect (GTK_CELL_AREA (cell_layout),
|
||
renderer, attribute, column);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_set_cell_data_func (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellLayoutDataFunc func,
|
||
gpointer func_data,
|
||
GDestroyNotify destroy)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (cell_layout);
|
||
|
||
_gtk_cell_area_set_cell_data_func_with_proxy (area, renderer, (GFunc)func, func_data, destroy, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_clear_attributes (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellArea *area = GTK_CELL_AREA (cell_layout);
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
CellInfo *info;
|
||
|
||
info = g_hash_table_lookup (priv->cell_info, renderer);
|
||
|
||
if (info)
|
||
{
|
||
g_slist_free_full (info->attributes, (GDestroyNotify)cell_attribute_free);
|
||
info->attributes = NULL;
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_reorder (GtkCellLayout *cell_layout,
|
||
GtkCellRenderer *cell,
|
||
int position)
|
||
{
|
||
g_warning ("GtkCellLayout::reorder not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (cell_layout)));
|
||
}
|
||
|
||
static gboolean
|
||
accum_cells (GtkCellRenderer *renderer,
|
||
GList **accum)
|
||
{
|
||
*accum = g_list_prepend (*accum, renderer);
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
static GList *
|
||
gtk_cell_area_get_cells (GtkCellLayout *cell_layout)
|
||
{
|
||
GList *cells = NULL;
|
||
|
||
gtk_cell_area_foreach (GTK_CELL_AREA (cell_layout),
|
||
(GtkCellCallback)accum_cells,
|
||
&cells);
|
||
|
||
return g_list_reverse (cells);
|
||
}
|
||
|
||
static GtkCellArea *
|
||
gtk_cell_area_get_area (GtkCellLayout *cell_layout)
|
||
{
|
||
return GTK_CELL_AREA (cell_layout);
|
||
}
|
||
|
||
/*************************************************************
|
||
* GtkBuildableIface *
|
||
*************************************************************/
|
||
static void
|
||
gtk_cell_area_buildable_init (GtkBuildableIface *iface)
|
||
{
|
||
iface->add_child = _gtk_cell_layout_buildable_add_child;
|
||
iface->custom_tag_start = _gtk_cell_layout_buildable_custom_tag_start;
|
||
iface->custom_tag_end = gtk_cell_area_buildable_custom_tag_end;
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_buildable_custom_tag_end (GtkBuildable *buildable,
|
||
GtkBuilder *builder,
|
||
GObject *child,
|
||
const char *tagname,
|
||
gpointer data)
|
||
{
|
||
/* Just ignore the boolean return from here */
|
||
_gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname, data);
|
||
}
|
||
|
||
/*************************************************************
|
||
* API *
|
||
*************************************************************/
|
||
|
||
/**
|
||
* gtk_cell_area_add:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to add to @area
|
||
*
|
||
* Adds @renderer to @area with the default child cell properties.
|
||
*/
|
||
void
|
||
gtk_cell_area_add (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->add (area, renderer);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_remove:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to remove from @area
|
||
*
|
||
* Removes @renderer from @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_remove (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GList *renderers, *l;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
/* Remove any custom attributes and custom cell data func here first */
|
||
g_hash_table_remove (priv->cell_info, renderer);
|
||
|
||
/* Remove focus siblings of this renderer */
|
||
g_hash_table_remove (priv->focus_siblings, renderer);
|
||
|
||
/* Remove this renderer from any focus renderer's sibling list */
|
||
renderers = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (area));
|
||
|
||
for (l = renderers; l; l = l->next)
|
||
{
|
||
GtkCellRenderer *focus_renderer = l->data;
|
||
|
||
if (gtk_cell_area_is_focus_sibling (area, focus_renderer, renderer))
|
||
{
|
||
gtk_cell_area_remove_focus_sibling (area, focus_renderer, renderer);
|
||
break;
|
||
}
|
||
}
|
||
|
||
g_list_free (renderers);
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->remove (area, renderer);
|
||
}
|
||
|
||
static gboolean
|
||
get_has_renderer (GtkCellRenderer *renderer,
|
||
HasRendererCheck *check)
|
||
{
|
||
if (renderer == check->renderer)
|
||
check->has_renderer = TRUE;
|
||
|
||
return check->has_renderer;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_has_renderer:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to check
|
||
*
|
||
* Checks if @area contains @renderer.
|
||
*
|
||
* Returns: %TRUE if @renderer is in the @area.
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_has_renderer (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
HasRendererCheck check = { renderer, FALSE };
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), FALSE);
|
||
|
||
gtk_cell_area_foreach (area, (GtkCellCallback)get_has_renderer, &check);
|
||
|
||
return check.has_renderer;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_foreach:
|
||
* @area: a `GtkCellArea`
|
||
* @callback: (scope call): the `GtkCellCallback` to call
|
||
* @callback_data: user provided data pointer
|
||
*
|
||
* Calls @callback for every `GtkCellRenderer` in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_foreach (GtkCellArea *area,
|
||
GtkCellCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (callback != NULL);
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->foreach (area, callback, callback_data);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_foreach_alloc:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context for this row of data.
|
||
* @widget: the `GtkWidget` that @area is rendering to
|
||
* @cell_area: the @widget relative coordinates and size for @area
|
||
* @background_area: the @widget relative coordinates of the background area
|
||
* @callback: (scope call): the `GtkCellAllocCallback` to call
|
||
* @callback_data: user provided data pointer
|
||
*
|
||
* Calls @callback for every `GtkCellRenderer` in @area with the
|
||
* allocated rectangle inside @cell_area.
|
||
*/
|
||
void
|
||
gtk_cell_area_foreach_alloc (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *background_area,
|
||
GtkCellAllocCallback callback,
|
||
gpointer callback_data)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_AREA_CONTEXT (context));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
g_return_if_fail (cell_area != NULL);
|
||
g_return_if_fail (callback != NULL);
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->foreach_alloc (area, context, widget,
|
||
cell_area, background_area,
|
||
callback, callback_data);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_event:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context for this row of data.
|
||
* @widget: the `GtkWidget` that @area is rendering to
|
||
* @event: the `GdkEvent` to handle
|
||
* @cell_area: the @widget relative coordinates for @area
|
||
* @flags: the `GtkCellRenderer`State for @area in this row.
|
||
*
|
||
* Delegates event handling to a `GtkCellArea`.
|
||
*
|
||
* Returns: %TRUE if the event was handled by @area.
|
||
*/
|
||
int
|
||
gtk_cell_area_event (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GdkEvent *event,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags)
|
||
{
|
||
GtkCellAreaClass *class;
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), 0);
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA_CONTEXT (context), 0);
|
||
g_return_val_if_fail (GTK_IS_WIDGET (widget), 0);
|
||
g_return_val_if_fail (event != NULL, 0);
|
||
g_return_val_if_fail (cell_area != NULL, 0);
|
||
|
||
class = GTK_CELL_AREA_GET_CLASS (area);
|
||
|
||
if (class->event)
|
||
return class->event (area, context, widget, event, cell_area, flags);
|
||
|
||
g_warning ("GtkCellAreaClass::event not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
return 0;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_snapshot:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context for this row of data.
|
||
* @widget: the `GtkWidget` that @area is rendering to
|
||
* @snapshot: the `GtkSnapshot` to draw to
|
||
* @background_area: the @widget relative coordinates for @area’s background
|
||
* @cell_area: the @widget relative coordinates for @area
|
||
* @flags: the `GtkCellRenderer`State for @area in this row.
|
||
* @paint_focus: whether @area should paint focus on focused cells for focused rows or not.
|
||
*
|
||
* Snapshots @area’s cells according to @area’s layout onto at
|
||
* the given coordinates.
|
||
*/
|
||
void
|
||
gtk_cell_area_snapshot (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GtkSnapshot *snapshot,
|
||
const GdkRectangle *background_area,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean paint_focus)
|
||
{
|
||
GtkCellAreaClass *class;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_AREA_CONTEXT (context));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
g_return_if_fail (snapshot != NULL);
|
||
g_return_if_fail (background_area != NULL);
|
||
g_return_if_fail (cell_area != NULL);
|
||
|
||
class = GTK_CELL_AREA_GET_CLASS (area);
|
||
|
||
if (class->snapshot)
|
||
class->snapshot (area, context, widget, snapshot, background_area, cell_area, flags, paint_focus);
|
||
else
|
||
g_warning ("GtkCellAreaClass::snapshot not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
static gboolean
|
||
get_cell_allocation (GtkCellRenderer *renderer,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *cell_background,
|
||
RendererAllocationData *data)
|
||
{
|
||
if (data->renderer == renderer)
|
||
data->allocation = *cell_area;
|
||
|
||
return (data->renderer == renderer);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_cell_allocation:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context used to hold sizes for @area.
|
||
* @widget: the `GtkWidget` that @area is rendering on
|
||
* @renderer: the `GtkCellRenderer` to get the allocation for
|
||
* @cell_area: the whole allocated area for @area in @widget
|
||
* for this row
|
||
* @allocation: (out): where to store the allocation for @renderer
|
||
*
|
||
* Derives the allocation of @renderer inside @area if @area
|
||
* were to be renderered in @cell_area.
|
||
*/
|
||
void
|
||
gtk_cell_area_get_cell_allocation (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
GtkCellRenderer *renderer,
|
||
const GdkRectangle *cell_area,
|
||
GdkRectangle *allocation)
|
||
{
|
||
RendererAllocationData data = { renderer, { 0, } };
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_AREA_CONTEXT (context));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (cell_area != NULL);
|
||
g_return_if_fail (allocation != NULL);
|
||
|
||
gtk_cell_area_foreach_alloc (area, context, widget, cell_area, cell_area,
|
||
(GtkCellAllocCallback)get_cell_allocation, &data);
|
||
|
||
*allocation = data.allocation;
|
||
}
|
||
|
||
static gboolean
|
||
get_cell_by_position (GtkCellRenderer *renderer,
|
||
const GdkRectangle *cell_area,
|
||
const GdkRectangle *cell_background,
|
||
CellByPositionData *data)
|
||
{
|
||
if (data->x >= cell_area->x && data->x < cell_area->x + cell_area->width &&
|
||
data->y >= cell_area->y && data->y < cell_area->y + cell_area->height)
|
||
{
|
||
data->renderer = renderer;
|
||
data->cell_area = *cell_area;
|
||
}
|
||
|
||
return (data->renderer != NULL);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_cell_at_position:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context used to hold sizes for @area.
|
||
* @widget: the `GtkWidget` that @area is rendering on
|
||
* @cell_area: the whole allocated area for @area in @widget
|
||
* for this row
|
||
* @x: the x position
|
||
* @y: the y position
|
||
* @alloc_area: (out) (optional): where to store the inner allocated area of the
|
||
* returned cell renderer
|
||
*
|
||
* Gets the `GtkCellRenderer` at @x and @y coordinates inside @area and optionally
|
||
* returns the full cell allocation for it inside @cell_area.
|
||
*
|
||
* Returns: (transfer none): the `GtkCellRenderer` at @x and @y.
|
||
*/
|
||
GtkCellRenderer *
|
||
gtk_cell_area_get_cell_at_position (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
int x,
|
||
int y,
|
||
GdkRectangle *alloc_area)
|
||
{
|
||
CellByPositionData data = { x, y, NULL, { 0, } };
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA_CONTEXT (context), NULL);
|
||
g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
|
||
g_return_val_if_fail (cell_area != NULL, NULL);
|
||
g_return_val_if_fail (x >= cell_area->x && x <= cell_area->x + cell_area->width, NULL);
|
||
g_return_val_if_fail (y >= cell_area->y && y <= cell_area->y + cell_area->height, NULL);
|
||
|
||
gtk_cell_area_foreach_alloc (area, context, widget, cell_area, cell_area,
|
||
(GtkCellAllocCallback)get_cell_by_position, &data);
|
||
|
||
if (alloc_area)
|
||
*alloc_area = data.cell_area;
|
||
|
||
return data.renderer;
|
||
}
|
||
|
||
/*************************************************************
|
||
* API: Geometry *
|
||
*************************************************************/
|
||
/**
|
||
* gtk_cell_area_create_context:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Creates a `GtkCellArea`Context to be used with @area for
|
||
* all purposes. `GtkCellArea`Context stores geometry information
|
||
* for rows for which it was operated on, it is important to use
|
||
* the same context for the same row of data at all times (i.e.
|
||
* one should render and handle events with the same `GtkCellArea`Context
|
||
* which was used to request the size of those rows of data).
|
||
*
|
||
* Returns: (transfer full): a newly created `GtkCellArea`Context which can be used with @area.
|
||
*/
|
||
GtkCellAreaContext *
|
||
gtk_cell_area_create_context (GtkCellArea *area)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->create_context (area);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_copy_context:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context to copy
|
||
*
|
||
* This is sometimes needed for cases where rows need to share
|
||
* alignments in one orientation but may be separately grouped
|
||
* in the opposing orientation.
|
||
*
|
||
* For instance, `GtkIconView` creates all icons (rows) to have
|
||
* the same width and the cells theirin to have the same
|
||
* horizontal alignments. However each row of icons may have
|
||
* a separate collective height. `GtkIconView` uses this to
|
||
* request the heights of each row based on a context which
|
||
* was already used to request all the row widths that are
|
||
* to be displayed.
|
||
*
|
||
* Returns: (transfer full): a newly created `GtkCellArea`Context copy of @context.
|
||
*/
|
||
GtkCellAreaContext *
|
||
gtk_cell_area_copy_context (GtkCellArea *area,
|
||
GtkCellAreaContext *context)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA_CONTEXT (context), NULL);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->copy_context (area, context);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_request_mode:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Gets whether the area prefers a height-for-width layout
|
||
* or a width-for-height layout.
|
||
*
|
||
* Returns: The `GtkSizeRequestMode` preferred by @area.
|
||
*/
|
||
GtkSizeRequestMode
|
||
gtk_cell_area_get_request_mode (GtkCellArea *area)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area),
|
||
GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->get_request_mode (area);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_preferred_width:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context to perform this request with
|
||
* @widget: the `GtkWidget` where @area will be rendering
|
||
* @minimum_width: (out) (optional): location to store the minimum width
|
||
* @natural_width: (out) (optional): location to store the natural width
|
||
*
|
||
* Retrieves a cell area’s initial minimum and natural width.
|
||
*
|
||
* @area will store some geometrical information in @context along the way;
|
||
* when requesting sizes over an arbitrary number of rows, it’s not important
|
||
* to check the @minimum_width and @natural_width of this call but rather to
|
||
* consult gtk_cell_area_context_get_preferred_width() after a series of
|
||
* requests.
|
||
*/
|
||
void
|
||
gtk_cell_area_get_preferred_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_width,
|
||
int *natural_width)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->get_preferred_width (area, context, widget,
|
||
minimum_width, natural_width);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_preferred_height_for_width:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context which has already been requested for widths.
|
||
* @widget: the `GtkWidget` where @area will be rendering
|
||
* @width: the width for which to check the height of this area
|
||
* @minimum_height: (out) (optional): location to store the minimum height
|
||
* @natural_height: (out) (optional): location to store the natural height
|
||
*
|
||
* Retrieves a cell area’s minimum and natural height if it would be given
|
||
* the specified @width.
|
||
*
|
||
* @area stores some geometrical information in @context along the way
|
||
* while calling gtk_cell_area_get_preferred_width(). It’s important to
|
||
* perform a series of gtk_cell_area_get_preferred_width() requests with
|
||
* @context first and then call gtk_cell_area_get_preferred_height_for_width()
|
||
* on each cell area individually to get the height for width of each
|
||
* fully requested row.
|
||
*
|
||
* If at some point, the width of a single row changes, it should be
|
||
* requested with gtk_cell_area_get_preferred_width() again and then
|
||
* the full width of the requested rows checked again with
|
||
* gtk_cell_area_context_get_preferred_width().
|
||
*/
|
||
void
|
||
gtk_cell_area_get_preferred_height_for_width (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int width,
|
||
int *minimum_height,
|
||
int *natural_height)
|
||
{
|
||
GtkCellAreaClass *class;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
class = GTK_CELL_AREA_GET_CLASS (area);
|
||
class->get_preferred_height_for_width (area, context, widget, width, minimum_height, natural_height);
|
||
}
|
||
|
||
|
||
/**
|
||
* gtk_cell_area_get_preferred_height:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context to perform this request with
|
||
* @widget: the `GtkWidget` where @area will be rendering
|
||
* @minimum_height: (out) (optional): location to store the minimum height
|
||
* @natural_height: (out) (optional): location to store the natural height
|
||
*
|
||
* Retrieves a cell area’s initial minimum and natural height.
|
||
*
|
||
* @area will store some geometrical information in @context along the way;
|
||
* when requesting sizes over an arbitrary number of rows, it’s not important
|
||
* to check the @minimum_height and @natural_height of this call but rather to
|
||
* consult gtk_cell_area_context_get_preferred_height() after a series of
|
||
* requests.
|
||
*/
|
||
void
|
||
gtk_cell_area_get_preferred_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int *minimum_height,
|
||
int *natural_height)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
GTK_CELL_AREA_GET_CLASS (area)->get_preferred_height (area, context, widget,
|
||
minimum_height, natural_height);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_preferred_width_for_height:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context which has already been requested for widths.
|
||
* @widget: the `GtkWidget` where @area will be rendering
|
||
* @height: the height for which to check the width of this area
|
||
* @minimum_width: (out) (optional): location to store the minimum width
|
||
* @natural_width: (out) (optional): location to store the natural width
|
||
*
|
||
* Retrieves a cell area’s minimum and natural width if it would be given
|
||
* the specified @height.
|
||
*
|
||
* @area stores some geometrical information in @context along the way
|
||
* while calling gtk_cell_area_get_preferred_height(). It’s important to
|
||
* perform a series of gtk_cell_area_get_preferred_height() requests with
|
||
* @context first and then call gtk_cell_area_get_preferred_width_for_height()
|
||
* on each cell area individually to get the height for width of each
|
||
* fully requested row.
|
||
*
|
||
* If at some point, the height of a single row changes, it should be
|
||
* requested with gtk_cell_area_get_preferred_height() again and then
|
||
* the full height of the requested rows checked again with
|
||
* gtk_cell_area_context_get_preferred_height().
|
||
*/
|
||
void
|
||
gtk_cell_area_get_preferred_width_for_height (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
int height,
|
||
int *minimum_width,
|
||
int *natural_width)
|
||
{
|
||
GtkCellAreaClass *class;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
|
||
class = GTK_CELL_AREA_GET_CLASS (area);
|
||
class->get_preferred_width_for_height (area, context, widget, height, minimum_width, natural_width);
|
||
}
|
||
|
||
/*************************************************************
|
||
* API: Attributes *
|
||
*************************************************************/
|
||
|
||
/**
|
||
* gtk_cell_area_attribute_connect:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to connect an attribute for
|
||
* @attribute: the attribute name
|
||
* @column: the `GtkTreeModel` column to fetch attribute values from
|
||
*
|
||
* Connects an @attribute to apply values from @column for the
|
||
* `GtkTreeModel` in use.
|
||
*/
|
||
void
|
||
gtk_cell_area_attribute_connect (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *attribute,
|
||
int column)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
CellInfo *info;
|
||
CellAttribute *cell_attribute;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (attribute != NULL);
|
||
g_return_if_fail (gtk_cell_area_has_renderer (area, renderer));
|
||
|
||
info = g_hash_table_lookup (priv->cell_info, renderer);
|
||
|
||
if (!info)
|
||
{
|
||
info = cell_info_new (NULL, NULL, NULL);
|
||
|
||
g_hash_table_insert (priv->cell_info, renderer, info);
|
||
}
|
||
else
|
||
{
|
||
GSList *node;
|
||
|
||
/* Check we are not adding the same attribute twice */
|
||
if ((node = g_slist_find_custom (info->attributes, attribute,
|
||
(GCompareFunc)cell_attribute_find)) != NULL)
|
||
{
|
||
cell_attribute = node->data;
|
||
|
||
g_warning ("Cannot connect attribute '%s' for cell renderer class '%s' "
|
||
"since '%s' is already attributed to column %d",
|
||
attribute,
|
||
G_OBJECT_TYPE_NAME (renderer),
|
||
attribute, cell_attribute->column);
|
||
return;
|
||
}
|
||
}
|
||
|
||
cell_attribute = cell_attribute_new (renderer, attribute, column);
|
||
|
||
if (!cell_attribute)
|
||
{
|
||
g_warning ("Cannot connect attribute '%s' for cell renderer class '%s' "
|
||
"since attribute does not exist",
|
||
attribute,
|
||
G_OBJECT_TYPE_NAME (renderer));
|
||
return;
|
||
}
|
||
|
||
info->attributes = g_slist_prepend (info->attributes, cell_attribute);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_attribute_disconnect:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to disconnect an attribute for
|
||
* @attribute: the attribute name
|
||
*
|
||
* Disconnects @attribute for the @renderer in @area so that
|
||
* attribute will no longer be updated with values from the
|
||
* model.
|
||
*/
|
||
void
|
||
gtk_cell_area_attribute_disconnect (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *attribute)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
CellInfo *info;
|
||
CellAttribute *cell_attribute;
|
||
GSList *node;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (attribute != NULL);
|
||
g_return_if_fail (gtk_cell_area_has_renderer (area, renderer));
|
||
|
||
info = g_hash_table_lookup (priv->cell_info, renderer);
|
||
|
||
if (info)
|
||
{
|
||
node = g_slist_find_custom (info->attributes, attribute,
|
||
(GCompareFunc)cell_attribute_find);
|
||
if (node)
|
||
{
|
||
cell_attribute = node->data;
|
||
|
||
cell_attribute_free (cell_attribute);
|
||
|
||
info->attributes = g_slist_delete_link (info->attributes, node);
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_attribute_get_column:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer`
|
||
* @attribute: an attribute on the renderer
|
||
*
|
||
* Returns the model column that an attribute has been mapped to,
|
||
* or -1 if the attribute is not mapped.
|
||
*
|
||
* Returns: the model column, or -1
|
||
*/
|
||
int
|
||
gtk_cell_area_attribute_get_column (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *attribute)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
CellInfo *info;
|
||
CellAttribute *cell_attribute;
|
||
GSList *node;
|
||
|
||
info = g_hash_table_lookup (priv->cell_info, renderer);
|
||
|
||
if (info)
|
||
{
|
||
node = g_slist_find_custom (info->attributes, attribute,
|
||
(GCompareFunc)cell_attribute_find);
|
||
if (node)
|
||
{
|
||
cell_attribute = node->data;
|
||
return cell_attribute->column;
|
||
}
|
||
}
|
||
|
||
return -1;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_apply_attributes:
|
||
* @area: a `GtkCellArea`
|
||
* @tree_model: the `GtkTreeModel` to pull values from
|
||
* @iter: the `GtkTreeIter` in @tree_model to apply values for
|
||
* @is_expander: whether @iter has children
|
||
* @is_expanded: whether @iter is expanded in the view and
|
||
* children are visible
|
||
*
|
||
* Applies any connected attributes to the renderers in
|
||
* @area by pulling the values from @tree_model.
|
||
*/
|
||
void
|
||
gtk_cell_area_apply_attributes (GtkCellArea *area,
|
||
GtkTreeModel *tree_model,
|
||
GtkTreeIter *iter,
|
||
gboolean is_expander,
|
||
gboolean is_expanded)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_TREE_MODEL (tree_model));
|
||
g_return_if_fail (iter != NULL);
|
||
|
||
g_signal_emit (area, cell_area_signals[SIGNAL_APPLY_ATTRIBUTES], 0,
|
||
tree_model, iter, is_expander, is_expanded);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_current_path_string:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Gets the current `GtkTreePath` string for the currently
|
||
* applied `GtkTreeIter`, this is implicitly updated when
|
||
* gtk_cell_area_apply_attributes() is called and can be
|
||
* used to interact with renderers from `GtkCellArea`
|
||
* subclasses.
|
||
*
|
||
* Returns: The current `GtkTreePath` string for the current
|
||
* attributes applied to @area. This string belongs to the area and
|
||
* should not be freed.
|
||
*/
|
||
const char *
|
||
gtk_cell_area_get_current_path_string (GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
|
||
return priv->current_path;
|
||
}
|
||
|
||
|
||
/*************************************************************
|
||
* API: Cell Properties *
|
||
*************************************************************/
|
||
/**
|
||
* gtk_cell_area_class_install_cell_property:
|
||
* @aclass: a `GtkCellAreaClass`
|
||
* @property_id: the id for the property
|
||
* @pspec: the `GParamSpec` for the property
|
||
*
|
||
* Installs a cell property on a cell area class.
|
||
*/
|
||
void
|
||
gtk_cell_area_class_install_cell_property (GtkCellAreaClass *aclass,
|
||
guint property_id,
|
||
GParamSpec *pspec)
|
||
{
|
||
g_return_if_fail (GTK_IS_CELL_AREA_CLASS (aclass));
|
||
g_return_if_fail (G_IS_PARAM_SPEC (pspec));
|
||
if (pspec->flags & G_PARAM_WRITABLE)
|
||
g_return_if_fail (aclass->set_cell_property != NULL);
|
||
if (pspec->flags & G_PARAM_READABLE)
|
||
g_return_if_fail (aclass->get_cell_property != NULL);
|
||
g_return_if_fail (property_id > 0);
|
||
g_return_if_fail (PARAM_SPEC_PARAM_ID (pspec) == 0); /* paranoid */
|
||
g_return_if_fail ((pspec->flags & (G_PARAM_CONSTRUCT | G_PARAM_CONSTRUCT_ONLY)) == 0);
|
||
|
||
if (g_param_spec_pool_lookup (cell_property_pool, pspec->name, G_OBJECT_CLASS_TYPE (aclass), TRUE))
|
||
{
|
||
g_warning (G_STRLOC ": class '%s' already contains a cell property named '%s'",
|
||
G_OBJECT_CLASS_NAME (aclass), pspec->name);
|
||
return;
|
||
}
|
||
g_param_spec_ref (pspec);
|
||
g_param_spec_sink (pspec);
|
||
PARAM_SPEC_SET_PARAM_ID (pspec, property_id);
|
||
g_param_spec_pool_insert (cell_property_pool, pspec, G_OBJECT_CLASS_TYPE (aclass));
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_class_find_cell_property:
|
||
* @aclass: a `GtkCellAreaClass`
|
||
* @property_name: the name of the child property to find
|
||
*
|
||
* Finds a cell property of a cell area class by name.
|
||
*
|
||
* Returns: (transfer none): the `GParamSpec` of the child property
|
||
*/
|
||
GParamSpec*
|
||
gtk_cell_area_class_find_cell_property (GtkCellAreaClass *aclass,
|
||
const char *property_name)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA_CLASS (aclass), NULL);
|
||
g_return_val_if_fail (property_name != NULL, NULL);
|
||
|
||
return g_param_spec_pool_lookup (cell_property_pool,
|
||
property_name,
|
||
G_OBJECT_CLASS_TYPE (aclass),
|
||
TRUE);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_class_list_cell_properties:
|
||
* @aclass: a `GtkCellAreaClass`
|
||
* @n_properties: (out): location to return the number of cell properties found
|
||
*
|
||
* Returns all cell properties of a cell area class.
|
||
*
|
||
* Returns: (array length=n_properties) (transfer container): a newly
|
||
* allocated %NULL-terminated array of `GParamSpec`*. The array
|
||
* must be freed with g_free().
|
||
*/
|
||
GParamSpec**
|
||
gtk_cell_area_class_list_cell_properties (GtkCellAreaClass *aclass,
|
||
guint *n_properties)
|
||
{
|
||
GParamSpec **pspecs;
|
||
guint n;
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA_CLASS (aclass), NULL);
|
||
|
||
pspecs = g_param_spec_pool_list (cell_property_pool,
|
||
G_OBJECT_CLASS_TYPE (aclass),
|
||
&n);
|
||
if (n_properties)
|
||
*n_properties = n;
|
||
|
||
return pspecs;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_add_with_properties:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` to be placed inside @area
|
||
* @first_prop_name: the name of the first cell property to set
|
||
* @...: a %NULL-terminated list of property names and values, starting
|
||
* with @first_prop_name
|
||
*
|
||
* Adds @renderer to @area, setting cell properties at the same time.
|
||
* See gtk_cell_area_add() and gtk_cell_area_cell_set() for more details.
|
||
*/
|
||
void
|
||
gtk_cell_area_add_with_properties (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *first_prop_name,
|
||
...)
|
||
{
|
||
GtkCellAreaClass *class;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
class = GTK_CELL_AREA_GET_CLASS (area);
|
||
|
||
if (class->add)
|
||
{
|
||
va_list var_args;
|
||
|
||
class->add (area, renderer);
|
||
|
||
va_start (var_args, first_prop_name);
|
||
gtk_cell_area_cell_set_valist (area, renderer, first_prop_name, var_args);
|
||
va_end (var_args);
|
||
}
|
||
else
|
||
g_warning ("GtkCellAreaClass::add not implemented for '%s'",
|
||
g_type_name (G_TYPE_FROM_INSTANCE (area)));
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_set:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` which is a cell inside @area
|
||
* @first_prop_name: the name of the first cell property to set
|
||
* @...: a %NULL-terminated list of property names and values, starting
|
||
* with @first_prop_name
|
||
*
|
||
* Sets one or more cell properties for @cell in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_set (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *first_prop_name,
|
||
...)
|
||
{
|
||
va_list var_args;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
va_start (var_args, first_prop_name);
|
||
gtk_cell_area_cell_set_valist (area, renderer, first_prop_name, var_args);
|
||
va_end (var_args);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_get:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` which is inside @area
|
||
* @first_prop_name: the name of the first cell property to get
|
||
* @...: return location for the first cell property, followed
|
||
* optionally by more name/return location pairs, followed by %NULL
|
||
*
|
||
* Gets the values of one or more cell properties for @renderer in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_get (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *first_prop_name,
|
||
...)
|
||
{
|
||
va_list var_args;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
va_start (var_args, first_prop_name);
|
||
gtk_cell_area_cell_get_valist (area, renderer, first_prop_name, var_args);
|
||
va_end (var_args);
|
||
}
|
||
|
||
static inline void
|
||
area_get_cell_property (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GParamSpec *pspec,
|
||
GValue *value)
|
||
{
|
||
GtkCellAreaClass *class = g_type_class_peek (pspec->owner_type);
|
||
|
||
class->get_cell_property (area, renderer, PARAM_SPEC_PARAM_ID (pspec), value, pspec);
|
||
}
|
||
|
||
static inline void
|
||
area_set_cell_property (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GParamSpec *pspec,
|
||
const GValue *value)
|
||
{
|
||
GValue tmp_value = G_VALUE_INIT;
|
||
GtkCellAreaClass *class = g_type_class_peek (pspec->owner_type);
|
||
|
||
/* provide a copy to work from, convert (if necessary) and validate */
|
||
g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
|
||
if (!g_value_transform (value, &tmp_value))
|
||
g_warning ("unable to set cell property '%s' of type '%s' from value of type '%s'",
|
||
pspec->name,
|
||
g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
|
||
G_VALUE_TYPE_NAME (value));
|
||
else if (g_param_value_validate (pspec, &tmp_value) && !(pspec->flags & G_PARAM_LAX_VALIDATION))
|
||
{
|
||
char *contents = g_strdup_value_contents (value);
|
||
|
||
g_warning ("value \"%s\" of type '%s' is invalid for property '%s' of type '%s'",
|
||
contents,
|
||
G_VALUE_TYPE_NAME (value),
|
||
pspec->name,
|
||
g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)));
|
||
g_free (contents);
|
||
}
|
||
else
|
||
{
|
||
class->set_cell_property (area, renderer, PARAM_SPEC_PARAM_ID (pspec), &tmp_value, pspec);
|
||
}
|
||
g_value_unset (&tmp_value);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_set_valist:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` which inside @area
|
||
* @first_property_name: the name of the first cell property to set
|
||
* @var_args: a %NULL-terminated list of property names and values, starting
|
||
* with @first_prop_name
|
||
*
|
||
* Sets one or more cell properties for @renderer in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_set_valist (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *first_property_name,
|
||
va_list var_args)
|
||
{
|
||
const char *name;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
name = first_property_name;
|
||
while (name)
|
||
{
|
||
GValue value = G_VALUE_INIT;
|
||
char *error = NULL;
|
||
GParamSpec *pspec =
|
||
g_param_spec_pool_lookup (cell_property_pool, name,
|
||
G_OBJECT_TYPE (area), TRUE);
|
||
if (!pspec)
|
||
{
|
||
g_warning ("%s: cell area class '%s' has no cell property named '%s'",
|
||
G_STRLOC, G_OBJECT_TYPE_NAME (area), name);
|
||
break;
|
||
}
|
||
if (!(pspec->flags & G_PARAM_WRITABLE))
|
||
{
|
||
g_warning ("%s: cell property '%s' of cell area class '%s' is not writable",
|
||
G_STRLOC, pspec->name, G_OBJECT_TYPE_NAME (area));
|
||
break;
|
||
}
|
||
|
||
G_VALUE_COLLECT_INIT (&value, G_PARAM_SPEC_VALUE_TYPE (pspec),
|
||
var_args, 0, &error);
|
||
if (error)
|
||
{
|
||
g_warning ("%s: %s", G_STRLOC, error);
|
||
g_free (error);
|
||
|
||
/* we purposely leak the value here, it might not be
|
||
* in a sane state if an error condition occurred
|
||
*/
|
||
break;
|
||
}
|
||
area_set_cell_property (area, renderer, pspec, &value);
|
||
g_value_unset (&value);
|
||
name = va_arg (var_args, char *);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_get_valist:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` inside @area
|
||
* @first_property_name: the name of the first property to get
|
||
* @var_args: return location for the first property, followed
|
||
* optionally by more name/return location pairs, followed by %NULL
|
||
*
|
||
* Gets the values of one or more cell properties for @renderer in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_get_valist (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *first_property_name,
|
||
va_list var_args)
|
||
{
|
||
const char *name;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
name = first_property_name;
|
||
while (name)
|
||
{
|
||
GValue value = G_VALUE_INIT;
|
||
GParamSpec *pspec;
|
||
char *error;
|
||
|
||
pspec = g_param_spec_pool_lookup (cell_property_pool, name,
|
||
G_OBJECT_TYPE (area), TRUE);
|
||
if (!pspec)
|
||
{
|
||
g_warning ("%s: cell area class '%s' has no cell property named '%s'",
|
||
G_STRLOC, G_OBJECT_TYPE_NAME (area), name);
|
||
break;
|
||
}
|
||
if (!(pspec->flags & G_PARAM_READABLE))
|
||
{
|
||
g_warning ("%s: cell property '%s' of cell area class '%s' is not readable",
|
||
G_STRLOC, pspec->name, G_OBJECT_TYPE_NAME (area));
|
||
break;
|
||
}
|
||
|
||
g_value_init (&value, G_PARAM_SPEC_VALUE_TYPE (pspec));
|
||
area_get_cell_property (area, renderer, pspec, &value);
|
||
G_VALUE_LCOPY (&value, var_args, 0, &error);
|
||
if (error)
|
||
{
|
||
g_warning ("%s: %s", G_STRLOC, error);
|
||
g_free (error);
|
||
g_value_unset (&value);
|
||
break;
|
||
}
|
||
g_value_unset (&value);
|
||
name = va_arg (var_args, char *);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_set_property:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` inside @area
|
||
* @property_name: the name of the cell property to set
|
||
* @value: the value to set the cell property to
|
||
*
|
||
* Sets a cell property for @renderer in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_set_property (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *property_name,
|
||
const GValue *value)
|
||
{
|
||
GParamSpec *pspec;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (property_name != NULL);
|
||
g_return_if_fail (G_IS_VALUE (value));
|
||
|
||
pspec = g_param_spec_pool_lookup (cell_property_pool, property_name,
|
||
G_OBJECT_TYPE (area), TRUE);
|
||
if (!pspec)
|
||
g_warning ("%s: cell area class '%s' has no cell property named '%s'",
|
||
G_STRLOC, G_OBJECT_TYPE_NAME (area), property_name);
|
||
else if (!(pspec->flags & G_PARAM_WRITABLE))
|
||
g_warning ("%s: cell property '%s' of cell area class '%s' is not writable",
|
||
G_STRLOC, pspec->name, G_OBJECT_TYPE_NAME (area));
|
||
else
|
||
{
|
||
area_set_cell_property (area, renderer, pspec, value);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_cell_get_property:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: a `GtkCellRenderer` inside @area
|
||
* @property_name: the name of the property to get
|
||
* @value: a location to return the value
|
||
*
|
||
* Gets the value of a cell property for @renderer in @area.
|
||
*/
|
||
void
|
||
gtk_cell_area_cell_get_property (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
const char *property_name,
|
||
GValue *value)
|
||
{
|
||
GParamSpec *pspec;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (property_name != NULL);
|
||
g_return_if_fail (G_IS_VALUE (value));
|
||
|
||
pspec = g_param_spec_pool_lookup (cell_property_pool, property_name,
|
||
G_OBJECT_TYPE (area), TRUE);
|
||
if (!pspec)
|
||
g_warning ("%s: cell area class '%s' has no cell property named '%s'",
|
||
G_STRLOC, G_OBJECT_TYPE_NAME (area), property_name);
|
||
else if (!(pspec->flags & G_PARAM_READABLE))
|
||
g_warning ("%s: cell property '%s' of cell area class '%s' is not readable",
|
||
G_STRLOC, pspec->name, G_OBJECT_TYPE_NAME (area));
|
||
else
|
||
{
|
||
GValue *prop_value, tmp_value = G_VALUE_INIT;
|
||
|
||
/* auto-conversion of the callers value type
|
||
*/
|
||
if (G_VALUE_TYPE (value) == G_PARAM_SPEC_VALUE_TYPE (pspec))
|
||
{
|
||
g_value_reset (value);
|
||
prop_value = value;
|
||
}
|
||
else if (!g_value_type_transformable (G_PARAM_SPEC_VALUE_TYPE (pspec), G_VALUE_TYPE (value)))
|
||
{
|
||
g_warning ("can't retrieve cell property '%s' of type '%s' as value of type '%s'",
|
||
pspec->name,
|
||
g_type_name (G_PARAM_SPEC_VALUE_TYPE (pspec)),
|
||
G_VALUE_TYPE_NAME (value));
|
||
return;
|
||
}
|
||
else
|
||
{
|
||
g_value_init (&tmp_value, G_PARAM_SPEC_VALUE_TYPE (pspec));
|
||
prop_value = &tmp_value;
|
||
}
|
||
|
||
area_get_cell_property (area, renderer, pspec, prop_value);
|
||
|
||
if (prop_value != value)
|
||
{
|
||
g_value_transform (prop_value, value);
|
||
g_value_unset (&tmp_value);
|
||
}
|
||
}
|
||
}
|
||
|
||
/*************************************************************
|
||
* API: Focus *
|
||
*************************************************************/
|
||
|
||
/**
|
||
* gtk_cell_area_is_activatable:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Returns whether the area can do anything when activated,
|
||
* after applying new attributes to @area.
|
||
*
|
||
* Returns: whether @area can do anything when activated.
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_is_activatable (GtkCellArea *area)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->is_activatable (area);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_focus:
|
||
* @area: a `GtkCellArea`
|
||
* @direction: the `GtkDirectionType`
|
||
*
|
||
* This should be called by the @area’s owning layout widget
|
||
* when focus is to be passed to @area, or moved within @area
|
||
* for a given @direction and row data.
|
||
*
|
||
* Implementing `GtkCellArea` classes should implement this
|
||
* method to receive and navigate focus in its own way particular
|
||
* to how it lays out cells.
|
||
*
|
||
* Returns: %TRUE if focus remains inside @area as a result of this call.
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_focus (GtkCellArea *area,
|
||
GtkDirectionType direction)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->focus (area, direction);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_activate:
|
||
* @area: a `GtkCellArea`
|
||
* @context: the `GtkCellArea`Context in context with the current row data
|
||
* @widget: the `GtkWidget` that @area is rendering on
|
||
* @cell_area: the size and location of @area relative to @widget’s allocation
|
||
* @flags: the `GtkCellRenderer`State flags for @area for this row of data.
|
||
* @edit_only: if %TRUE then only cell renderers that are %GTK_CELL_RENDERER_MODE_EDITABLE
|
||
* will be activated.
|
||
*
|
||
* Activates @area, usually by activating the currently focused
|
||
* cell, however some subclasses which embed widgets in the area
|
||
* can also activate a widget if it currently has the focus.
|
||
*
|
||
* Returns: Whether @area was successfully activated.
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_activate (GtkCellArea *area,
|
||
GtkCellAreaContext *context,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags,
|
||
gboolean edit_only)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
|
||
return GTK_CELL_AREA_GET_CLASS (area)->activate (area, context, widget, cell_area, flags, edit_only);
|
||
}
|
||
|
||
|
||
/**
|
||
* gtk_cell_area_set_focus_cell:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: (nullable): the `GtkCellRenderer` to give focus to
|
||
*
|
||
* Explicitly sets the currently focused cell to @renderer.
|
||
*
|
||
* This is generally called by implementations of
|
||
* `GtkCellAreaClass.focus()` or `GtkCellAreaClass.event()`,
|
||
* however it can also be used to implement functions such
|
||
* as gtk_tree_view_set_cursor_on_cell().
|
||
*/
|
||
void
|
||
gtk_cell_area_set_focus_cell (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (renderer == NULL || GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
if (priv->focus_cell != renderer)
|
||
{
|
||
if (priv->focus_cell)
|
||
g_object_unref (priv->focus_cell);
|
||
|
||
priv->focus_cell = renderer;
|
||
|
||
if (priv->focus_cell)
|
||
g_object_ref (priv->focus_cell);
|
||
|
||
g_object_notify (G_OBJECT (area), "focus-cell");
|
||
}
|
||
|
||
/* Signal that the current focus renderer for this path changed
|
||
* (it may be that the focus cell did not change, but the row
|
||
* may have changed so we need to signal it) */
|
||
g_signal_emit (area, cell_area_signals[SIGNAL_FOCUS_CHANGED], 0,
|
||
priv->focus_cell, priv->current_path);
|
||
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_focus_cell:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Retrieves the currently focused cell for @area
|
||
*
|
||
* Returns: (transfer none) (nullable): the currently focused cell in @area.
|
||
*/
|
||
GtkCellRenderer *
|
||
gtk_cell_area_get_focus_cell (GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
|
||
return priv->focus_cell;
|
||
}
|
||
|
||
|
||
/*************************************************************
|
||
* API: Focus Siblings *
|
||
*************************************************************/
|
||
|
||
/**
|
||
* gtk_cell_area_add_focus_sibling:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` expected to have focus
|
||
* @sibling: the `GtkCellRenderer` to add to @renderer’s focus area
|
||
*
|
||
* Adds @sibling to @renderer’s focusable area, focus will be drawn
|
||
* around @renderer and all of its siblings if @renderer can
|
||
* focus for a given row.
|
||
*
|
||
* Events handled by focus siblings can also activate the given
|
||
* focusable @renderer.
|
||
*/
|
||
void
|
||
gtk_cell_area_add_focus_sibling (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellRenderer *sibling)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GList *siblings;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (sibling));
|
||
g_return_if_fail (renderer != sibling);
|
||
g_return_if_fail (gtk_cell_area_has_renderer (area, renderer));
|
||
g_return_if_fail (gtk_cell_area_has_renderer (area, sibling));
|
||
g_return_if_fail (!gtk_cell_area_is_focus_sibling (area, renderer, sibling));
|
||
|
||
/* XXX We should also check that sibling is not in any other renderer's sibling
|
||
* list already, a renderer can be sibling of only one focusable renderer
|
||
* at a time.
|
||
*/
|
||
|
||
siblings = g_hash_table_lookup (priv->focus_siblings, renderer);
|
||
|
||
if (siblings)
|
||
{
|
||
G_GNUC_UNUSED GList *unused = g_list_append (siblings, sibling);
|
||
}
|
||
else
|
||
{
|
||
siblings = g_list_append (siblings, sibling);
|
||
g_hash_table_insert (priv->focus_siblings, renderer, siblings);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_remove_focus_sibling:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` expected to have focus
|
||
* @sibling: the `GtkCellRenderer` to remove from @renderer’s focus area
|
||
*
|
||
* Removes @sibling from @renderer’s focus sibling list
|
||
* (see gtk_cell_area_add_focus_sibling()).
|
||
*/
|
||
void
|
||
gtk_cell_area_remove_focus_sibling (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellRenderer *sibling)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GList *siblings;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (sibling));
|
||
g_return_if_fail (gtk_cell_area_is_focus_sibling (area, renderer, sibling));
|
||
|
||
siblings = g_hash_table_lookup (priv->focus_siblings, renderer);
|
||
|
||
siblings = g_list_copy (siblings);
|
||
siblings = g_list_remove (siblings, sibling);
|
||
|
||
if (!siblings)
|
||
g_hash_table_remove (priv->focus_siblings, renderer);
|
||
else
|
||
g_hash_table_insert (priv->focus_siblings, renderer, siblings);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_is_focus_sibling:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` expected to have focus
|
||
* @sibling: the `GtkCellRenderer` to check against @renderer’s sibling list
|
||
*
|
||
* Returns whether @sibling is one of @renderer’s focus siblings
|
||
* (see gtk_cell_area_add_focus_sibling()).
|
||
*
|
||
* Returns: %TRUE if @sibling is a focus sibling of @renderer
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_is_focus_sibling (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellRenderer *sibling)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GList *siblings, *l;
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), FALSE);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (sibling), FALSE);
|
||
|
||
siblings = g_hash_table_lookup (priv->focus_siblings, renderer);
|
||
|
||
for (l = siblings; l; l = l->next)
|
||
{
|
||
GtkCellRenderer *a_sibling = l->data;
|
||
|
||
if (a_sibling == sibling)
|
||
return TRUE;
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_focus_siblings:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` expected to have focus
|
||
*
|
||
* Gets the focus sibling cell renderers for @renderer.
|
||
*
|
||
* Returns: (element-type GtkCellRenderer) (transfer none): A `GList` of `GtkCellRenderer`s.
|
||
* The returned list is internal and should not be freed.
|
||
*/
|
||
const GList *
|
||
gtk_cell_area_get_focus_siblings (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), NULL);
|
||
|
||
return g_hash_table_lookup (priv->focus_siblings, renderer);
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_focus_from_sibling:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer`
|
||
*
|
||
* Gets the `GtkCellRenderer` which is expected to be focusable
|
||
* for which @renderer is, or may be a sibling.
|
||
*
|
||
* This is handy for `GtkCellArea` subclasses when handling events,
|
||
* after determining the renderer at the event location it can
|
||
* then chose to activate the focus cell for which the event
|
||
* cell may have been a sibling.
|
||
*
|
||
* Returns: (nullable) (transfer none): the `GtkCellRenderer`
|
||
* for which @renderer is a sibling
|
||
*/
|
||
GtkCellRenderer *
|
||
gtk_cell_area_get_focus_from_sibling (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellRenderer *ret_renderer = NULL;
|
||
GList *renderers, *l;
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), NULL);
|
||
|
||
renderers = gtk_cell_layout_get_cells (GTK_CELL_LAYOUT (area));
|
||
|
||
for (l = renderers; l; l = l->next)
|
||
{
|
||
GtkCellRenderer *a_renderer = l->data;
|
||
const GList *list;
|
||
|
||
for (list = gtk_cell_area_get_focus_siblings (area, a_renderer);
|
||
list; list = list->next)
|
||
{
|
||
GtkCellRenderer *sibling_renderer = list->data;
|
||
|
||
if (sibling_renderer == renderer)
|
||
{
|
||
ret_renderer = a_renderer;
|
||
break;
|
||
}
|
||
}
|
||
}
|
||
g_list_free (renderers);
|
||
|
||
return ret_renderer;
|
||
}
|
||
|
||
/*************************************************************
|
||
* API: Cell Activation/Editing *
|
||
*************************************************************/
|
||
static void
|
||
gtk_cell_area_add_editable (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellEditable *editable,
|
||
const GdkRectangle *cell_area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_signal_emit (area, cell_area_signals[SIGNAL_ADD_EDITABLE], 0,
|
||
renderer, editable, cell_area, priv->current_path);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_remove_editable (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkCellEditable *editable)
|
||
{
|
||
g_signal_emit (area, cell_area_signals[SIGNAL_REMOVE_EDITABLE], 0, renderer, editable);
|
||
}
|
||
|
||
static void
|
||
cell_area_remove_widget_cb (GtkCellEditable *editable,
|
||
GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_assert (priv->edit_widget == editable);
|
||
g_assert (priv->edited_cell != NULL);
|
||
|
||
gtk_cell_area_remove_editable (area, priv->edited_cell, priv->edit_widget);
|
||
|
||
/* Now that we're done with editing the widget and it can be removed,
|
||
* remove our references to the widget and disconnect handlers */
|
||
gtk_cell_area_set_edited_cell (area, NULL);
|
||
gtk_cell_area_set_edit_widget (area, NULL);
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_set_edited_cell (GtkCellArea *area,
|
||
GtkCellRenderer *renderer)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (renderer == NULL || GTK_IS_CELL_RENDERER (renderer));
|
||
|
||
if (priv->edited_cell != renderer)
|
||
{
|
||
if (priv->edited_cell)
|
||
g_object_unref (priv->edited_cell);
|
||
|
||
priv->edited_cell = renderer;
|
||
|
||
if (priv->edited_cell)
|
||
g_object_ref (priv->edited_cell);
|
||
|
||
g_object_notify (G_OBJECT (area), "edited-cell");
|
||
}
|
||
}
|
||
|
||
static void
|
||
gtk_cell_area_set_edit_widget (GtkCellArea *area,
|
||
GtkCellEditable *editable)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (editable == NULL || GTK_IS_CELL_EDITABLE (editable));
|
||
|
||
if (priv->edit_widget != editable)
|
||
{
|
||
if (priv->edit_widget)
|
||
{
|
||
g_signal_handler_disconnect (priv->edit_widget, priv->remove_widget_id);
|
||
|
||
g_object_unref (priv->edit_widget);
|
||
}
|
||
|
||
priv->edit_widget = editable;
|
||
|
||
if (priv->edit_widget)
|
||
{
|
||
priv->remove_widget_id =
|
||
g_signal_connect (priv->edit_widget, "remove-widget",
|
||
G_CALLBACK (cell_area_remove_widget_cb), area);
|
||
|
||
g_object_ref (priv->edit_widget);
|
||
}
|
||
|
||
g_object_notify (G_OBJECT (area), "edit-widget");
|
||
}
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_edited_cell:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Gets the `GtkCellRenderer` in @area that is currently
|
||
* being edited.
|
||
*
|
||
* Returns: (transfer none) (nullable): The currently edited `GtkCellRenderer`
|
||
*/
|
||
GtkCellRenderer *
|
||
gtk_cell_area_get_edited_cell (GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
|
||
return priv->edited_cell;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_get_edit_widget:
|
||
* @area: a `GtkCellArea`
|
||
*
|
||
* Gets the `GtkCellEditable` widget currently used
|
||
* to edit the currently edited cell.
|
||
*
|
||
* Returns: (transfer none) (nullable): The currently active `GtkCellEditable` widget
|
||
*/
|
||
GtkCellEditable *
|
||
gtk_cell_area_get_edit_widget (GtkCellArea *area)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), NULL);
|
||
|
||
return priv->edit_widget;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_activate_cell:
|
||
* @area: a `GtkCellArea`
|
||
* @widget: the `GtkWidget` that @area is rendering onto
|
||
* @renderer: the `GtkCellRenderer` in @area to activate
|
||
* @event: the `GdkEvent` for which cell activation should occur
|
||
* @cell_area: the `GdkRectangle` in @widget relative coordinates
|
||
* of @renderer for the current row.
|
||
* @flags: the `GtkCellRenderer`State for @renderer
|
||
*
|
||
* This is used by `GtkCellArea` subclasses when handling events
|
||
* to activate cells, the base `GtkCellArea` class activates cells
|
||
* for keyboard events for free in its own GtkCellArea->activate()
|
||
* implementation.
|
||
*
|
||
* Returns: whether cell activation was successful
|
||
*/
|
||
gboolean
|
||
gtk_cell_area_activate_cell (GtkCellArea *area,
|
||
GtkWidget *widget,
|
||
GtkCellRenderer *renderer,
|
||
GdkEvent *event,
|
||
const GdkRectangle *cell_area,
|
||
GtkCellRendererState flags)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
GtkCellRendererMode mode;
|
||
|
||
g_return_val_if_fail (GTK_IS_CELL_AREA (area), FALSE);
|
||
g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
|
||
g_return_val_if_fail (GTK_IS_CELL_RENDERER (renderer), FALSE);
|
||
g_return_val_if_fail (cell_area != NULL, FALSE);
|
||
|
||
if (!gtk_cell_renderer_get_sensitive (renderer))
|
||
return FALSE;
|
||
|
||
g_object_get (renderer, "mode", &mode, NULL);
|
||
|
||
if (mode == GTK_CELL_RENDERER_MODE_ACTIVATABLE)
|
||
{
|
||
if (gtk_cell_renderer_activate (renderer,
|
||
event, widget,
|
||
priv->current_path,
|
||
cell_area,
|
||
cell_area,
|
||
flags))
|
||
return TRUE;
|
||
}
|
||
else if (mode == GTK_CELL_RENDERER_MODE_EDITABLE)
|
||
{
|
||
GtkCellEditable *editable_widget;
|
||
GdkRectangle inner_area;
|
||
|
||
gtk_cell_area_inner_cell_area (area, widget, cell_area, &inner_area);
|
||
|
||
editable_widget =
|
||
gtk_cell_renderer_start_editing (renderer,
|
||
event, widget,
|
||
priv->current_path,
|
||
&inner_area,
|
||
&inner_area,
|
||
flags);
|
||
|
||
if (editable_widget != NULL)
|
||
{
|
||
g_return_val_if_fail (GTK_IS_CELL_EDITABLE (editable_widget), FALSE);
|
||
|
||
gtk_cell_area_set_edited_cell (area, renderer);
|
||
gtk_cell_area_set_edit_widget (area, editable_widget);
|
||
|
||
/* Signal that editing started so that callers can get
|
||
* a handle on the editable_widget */
|
||
gtk_cell_area_add_editable (area, priv->focus_cell, editable_widget, cell_area);
|
||
|
||
/* If the signal was successfully handled start the editing */
|
||
if (gtk_widget_get_parent (GTK_WIDGET (editable_widget)))
|
||
{
|
||
gtk_cell_editable_start_editing (editable_widget, event);
|
||
gtk_widget_grab_focus (GTK_WIDGET (editable_widget));
|
||
}
|
||
else
|
||
{
|
||
/* Otherwise clear the editing state and fire a warning */
|
||
gtk_cell_area_set_edited_cell (area, NULL);
|
||
gtk_cell_area_set_edit_widget (area, NULL);
|
||
|
||
g_warning ("GtkCellArea::add-editable fired in the dark, no cell editing was started.");
|
||
}
|
||
|
||
return TRUE;
|
||
}
|
||
}
|
||
|
||
return FALSE;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_stop_editing:
|
||
* @area: a `GtkCellArea`
|
||
* @canceled: whether editing was canceled.
|
||
*
|
||
* Explicitly stops the editing of the currently edited cell.
|
||
*
|
||
* If @canceled is %TRUE, the currently edited cell renderer
|
||
* will emit the ::editing-canceled signal, otherwise the
|
||
* the ::editing-done signal will be emitted on the current
|
||
* edit widget.
|
||
*
|
||
* See gtk_cell_area_get_edited_cell() and gtk_cell_area_get_edit_widget().
|
||
*/
|
||
void
|
||
gtk_cell_area_stop_editing (GtkCellArea *area,
|
||
gboolean canceled)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
|
||
if (priv->edited_cell)
|
||
{
|
||
GtkCellEditable *edit_widget = g_object_ref (priv->edit_widget);
|
||
GtkCellRenderer *edit_cell = g_object_ref (priv->edited_cell);
|
||
|
||
/* Stop editing of the cell renderer */
|
||
gtk_cell_renderer_stop_editing (priv->edited_cell, canceled);
|
||
|
||
/* When editing is explicitly halted either
|
||
* the "editing-canceled" signal is emitted on the cell
|
||
* renderer or the "editing-done" signal on the GtkCellEditable widget
|
||
*/
|
||
if (!canceled)
|
||
gtk_cell_editable_editing_done (edit_widget);
|
||
|
||
/* Remove any references to the editable widget */
|
||
gtk_cell_area_set_edited_cell (area, NULL);
|
||
gtk_cell_area_set_edit_widget (area, NULL);
|
||
|
||
/* Send the remove-widget signal explicitly (this is done after setting
|
||
* the edit cell/widget NULL to avoid feedback)
|
||
*/
|
||
gtk_cell_area_remove_editable (area, edit_cell, edit_widget);
|
||
g_object_unref (edit_cell);
|
||
g_object_unref (edit_widget);
|
||
}
|
||
}
|
||
|
||
/*************************************************************
|
||
* API: Convenience for area implementations *
|
||
*************************************************************/
|
||
|
||
/**
|
||
* gtk_cell_area_inner_cell_area:
|
||
* @area: a `GtkCellArea`
|
||
* @widget: the `GtkWidget` that @area is rendering onto
|
||
* @cell_area: the @widget relative coordinates where one of @area’s cells
|
||
* is to be placed
|
||
* @inner_area: (out): the return location for the inner cell area
|
||
*
|
||
* This is a convenience function for `GtkCellArea` implementations
|
||
* to get the inner area where a given `GtkCellRenderer` will be
|
||
* rendered. It removes any padding previously added by gtk_cell_area_request_renderer().
|
||
*/
|
||
void
|
||
gtk_cell_area_inner_cell_area (GtkCellArea *area,
|
||
GtkWidget *widget,
|
||
const GdkRectangle *cell_area,
|
||
GdkRectangle *inner_area)
|
||
{
|
||
GtkBorder border;
|
||
GtkStyleContext *context;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
g_return_if_fail (cell_area != NULL);
|
||
g_return_if_fail (inner_area != NULL);
|
||
|
||
context = gtk_widget_get_style_context (widget);
|
||
gtk_style_context_get_padding (context, &border);
|
||
|
||
*inner_area = *cell_area;
|
||
|
||
if (border.left + border.right > cell_area->width)
|
||
{
|
||
border.left = cell_area->width / 2;
|
||
border.right = (cell_area->width + 1) / 2;
|
||
}
|
||
inner_area->x += border.left;
|
||
inner_area->width -= border.left + border.right;
|
||
if (border.top + border.bottom > cell_area->height)
|
||
{
|
||
border.top = cell_area->height / 2;
|
||
border.bottom = (cell_area->height + 1) / 2;
|
||
}
|
||
inner_area->y += border.top;
|
||
inner_area->height -= border.top + border.bottom;
|
||
}
|
||
|
||
/**
|
||
* gtk_cell_area_request_renderer:
|
||
* @area: a `GtkCellArea`
|
||
* @renderer: the `GtkCellRenderer` to request size for
|
||
* @orientation: the `GtkOrientation` in which to request size
|
||
* @widget: the `GtkWidget` that @area is rendering onto
|
||
* @for_size: the allocation contextual size to request for, or -1 if
|
||
* the base request for the orientation is to be returned.
|
||
* @minimum_size: (out) (optional): location to store the minimum size
|
||
* @natural_size: (out) (optional): location to store the natural size
|
||
*
|
||
* This is a convenience function for `GtkCellArea` implementations
|
||
* to request size for cell renderers. It’s important to use this
|
||
* function to request size and then use gtk_cell_area_inner_cell_area()
|
||
* at render and event time since this function will add padding
|
||
* around the cell for focus painting.
|
||
*/
|
||
void
|
||
gtk_cell_area_request_renderer (GtkCellArea *area,
|
||
GtkCellRenderer *renderer,
|
||
GtkOrientation orientation,
|
||
GtkWidget *widget,
|
||
int for_size,
|
||
int *minimum_size,
|
||
int *natural_size)
|
||
{
|
||
GtkBorder border;
|
||
GtkStyleContext *context;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
|
||
g_return_if_fail (GTK_IS_WIDGET (widget));
|
||
g_return_if_fail (minimum_size != NULL);
|
||
g_return_if_fail (natural_size != NULL);
|
||
|
||
context = gtk_widget_get_style_context (widget);
|
||
gtk_style_context_get_padding (context, &border);
|
||
|
||
if (orientation == GTK_ORIENTATION_HORIZONTAL)
|
||
{
|
||
if (for_size < 0)
|
||
gtk_cell_renderer_get_preferred_width (renderer, widget, minimum_size, natural_size);
|
||
else
|
||
{
|
||
for_size = MAX (0, for_size - border.left - border.right);
|
||
|
||
gtk_cell_renderer_get_preferred_width_for_height (renderer, widget, for_size,
|
||
minimum_size, natural_size);
|
||
}
|
||
|
||
*minimum_size += border.left + border.right;
|
||
*natural_size += border.left + border.right;
|
||
}
|
||
else /* GTK_ORIENTATION_VERTICAL */
|
||
{
|
||
if (for_size < 0)
|
||
gtk_cell_renderer_get_preferred_height (renderer, widget, minimum_size, natural_size);
|
||
else
|
||
{
|
||
for_size = MAX (0, for_size - border.top - border.bottom);
|
||
|
||
gtk_cell_renderer_get_preferred_height_for_width (renderer, widget, for_size,
|
||
minimum_size, natural_size);
|
||
}
|
||
|
||
*minimum_size += border.top + border.bottom;
|
||
*natural_size += border.top + border.bottom;
|
||
}
|
||
}
|
||
|
||
void
|
||
_gtk_cell_area_set_cell_data_func_with_proxy (GtkCellArea *area,
|
||
GtkCellRenderer *cell,
|
||
GFunc func,
|
||
gpointer func_data,
|
||
GDestroyNotify destroy,
|
||
gpointer proxy)
|
||
{
|
||
GtkCellAreaPrivate *priv = gtk_cell_area_get_instance_private (area);
|
||
CellInfo *info;
|
||
|
||
g_return_if_fail (GTK_IS_CELL_AREA (area));
|
||
g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
|
||
|
||
info = g_hash_table_lookup (priv->cell_info, cell);
|
||
|
||
/* Note we do not take a reference to the proxy, the proxy is a GtkCellLayout
|
||
* that is forwarding its implementation to a delegate GtkCellArea therefore
|
||
* its life-cycle is longer than the area's life cycle.
|
||
*/
|
||
if (info)
|
||
{
|
||
if (info->destroy && info->data)
|
||
info->destroy (info->data);
|
||
|
||
if (func)
|
||
{
|
||
info->func = (GtkCellLayoutDataFunc)func;
|
||
info->data = func_data;
|
||
info->destroy = destroy;
|
||
info->proxy = proxy;
|
||
}
|
||
else
|
||
{
|
||
info->func = NULL;
|
||
info->data = NULL;
|
||
info->destroy = NULL;
|
||
info->proxy = NULL;
|
||
}
|
||
}
|
||
else
|
||
{
|
||
info = cell_info_new ((GtkCellLayoutDataFunc)func, func_data, destroy);
|
||
info->proxy = proxy;
|
||
|
||
g_hash_table_insert (priv->cell_info, cell, info);
|
||
}
|
||
}
|