AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
ff39c76bfd
gtk2/gtk/gtkcellarea.h

458 lines
23 KiB
C
Raw Normal View History

Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
/* gtkcellarea.h
Added GtkCellArea to the build Starting to form a good api, implemented most of GtkCellLayout iface on the base class routing the apis through the new class vfuncs.
2010-10-22 07:41:52 +00:00
*
* Copyright (C) 2010 Openismus GmbH
*
* Authors:
* Tristan Van Berkom <tristanvb@openismus.com>
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
*
* 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, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA 02111-1307, USA.
*/
#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION)
#error "Only <gtk/gtk.h> can be included directly."
#endif
#ifndef __GTK_CELL_AREA_H__
#define __GTK_CELL_AREA_H__
#include <gtk/gtkcellrenderer.h>
#include <gtk/gtkwidget.h>
Implemented remaining portions of GtkCellLayout iface Now GtkCellArea provides a generic way of applying attributes from a GtkTreeModel/GtkTreeIter, GtkCellArea bookkeeps a hashtable of GtkCellLayoutDataFunc's and completely abstracts the applying of data to cells... GtkCellArea implementations need only to bookkeep the added renderers and attributes (probably we can abstract the attribute bookkeeping in the base class as well). Things starting to take a good and practical shape.
2010-10-24 06:44:48 +00:00
#include <gtk/gtktreemodel.h>
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_CELL_AREA (gtk_cell_area_get_type ())
#define GTK_CELL_AREA(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CELL_AREA, GtkCellArea))
#define GTK_CELL_AREA_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CELL_AREA, GtkCellAreaClass))
#define GTK_IS_CELL_AREA(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CELL_AREA))
#define GTK_IS_CELL_AREA_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CELL_AREA))
#define GTK_CELL_AREA_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CELL_AREA, GtkCellAreaClass))
typedef struct _GtkCellArea GtkCellArea;
typedef struct _GtkCellAreaClass GtkCellAreaClass;
Implemented remaining portions of GtkCellLayout iface Now GtkCellArea provides a generic way of applying attributes from a GtkTreeModel/GtkTreeIter, GtkCellArea bookkeeps a hashtable of GtkCellLayoutDataFunc's and completely abstracts the applying of data to cells... GtkCellArea implementations need only to bookkeep the added renderers and attributes (probably we can abstract the attribute bookkeeping in the base class as well). Things starting to take a good and practical shape.
2010-10-24 06:44:48 +00:00
typedef struct _GtkCellAreaPrivate GtkCellAreaPrivate;
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
typedef struct _GtkCellAreaContext GtkCellAreaContext;
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Changed GTK_CELL_AREA_WARN_INVALID_CHILD_PROPERTY_ID for GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID
2010-12-04 11:52:03 +00:00
/**
* GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID:
* @object: the #GObject on which set_cell_property() or get_get_property()
* was called
* @property_id: the numeric id of the property
* @pspec: the #GParamSpec of the property
*
* This macro should be used to emit a standard warning about unexpected
* properties in set_cell_property() and get_cell_property() implementations.
*/
#define GTK_CELL_AREA_WARN_INVALID_CELL_PROPERTY_ID(object, property_id, pspec) \
G_OBJECT_WARN_INVALID_PSPEC ((object), "cell property id", (property_id), (pspec))
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
/**
* GtkCellCallback:
Added GtkCellArea to the build Starting to form a good api, implemented most of GtkCellLayout iface on the base class routing the apis through the new class vfuncs.
2010-10-22 07:41:52 +00:00
* @renderer: the cell renderer to operate on
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
* @data: user-supplied data
*
* The type of the callback functions used for iterating over
Changed gtk_cell_area_forall to gtk_cell_area_foreach since thats more widely used semantics. Also gave a boolean return value to the callback to allow breaking out of the loop.
2010-12-06 03:41:38 +00:00
* the cell renderers of a #GtkCellArea, see gtk_cell_area_foreach().
*
* Return value: %TRUE to stop iterating over cells.
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
*/
Changed gtk_cell_area_forall to gtk_cell_area_foreach since thats more widely used semantics. Also gave a boolean return value to the callback to allow breaking out of the loop.
2010-12-06 03:41:38 +00:00
typedef gboolean (*GtkCellCallback) (GtkCellRenderer *renderer,
gpointer data);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
/**
* GtkCellAllocCallback:
* @renderer: the cell renderer to operate on
Fixed gtk-doc statement in GtkCellArea header
2010-12-06 07:29:13 +00:00
* @cell_area: the area allocated to @renderer inside the rectangle provided to gtk_cell_area_foreach_alloc().
Added 'background_area' calculation to GtkCellAreaClass->foreach_alloc vfunc This allows us to reduce code allocation code paths in subclasses, as a result GtkCellArea implements the ->render() vfunc and the subclass only decides the cell area and background area distributions in a single code path.
2010-12-08 12:18:05 +00:00
* @cell_background: the background area for @renderer inside the background
* area provided to gtk_cell_area_foreach_alloc().
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
* @data: user-supplied data
*
* The type of the callback functions used for iterating over
* the cell renderers and their allocated areas inside a #GtkCellArea,
* see gtk_cell_area_foreach_alloc().
*
* Return value: %TRUE to stop iterating over cells.
*/
typedef gboolean (*GtkCellAllocCallback) (GtkCellRenderer *renderer,
const GdkRectangle *cell_area,
Added 'background_area' calculation to GtkCellAreaClass->foreach_alloc vfunc This allows us to reduce code allocation code paths in subclasses, as a result GtkCellArea implements the ->render() vfunc and the subclass only decides the cell area and background area distributions in a single code path.
2010-12-08 12:18:05 +00:00
const GdkRectangle *cell_background,
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
gpointer data);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
struct _GtkCellArea
{
Marking GtkCellArea structure portions as /*< private >*/
2010-12-03 08:12:59 +00:00
/*< private >*/
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
GInitiallyUnowned parent_instance;
Implemented remaining portions of GtkCellLayout iface Now GtkCellArea provides a generic way of applying attributes from a GtkTreeModel/GtkTreeIter, GtkCellArea bookkeeps a hashtable of GtkCellLayoutDataFunc's and completely abstracts the applying of data to cells... GtkCellArea implementations need only to bookkeep the added renderers and attributes (probably we can abstract the attribute bookkeeping in the base class as well). Things starting to take a good and practical shape.
2010-10-24 06:44:48 +00:00
GtkCellAreaPrivate *priv;
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
};
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
/**
* GtkCellAreaClass:
* @add: adds a #GtkCellRenderer to the area.
* @remove: removes a #GtkCellRenderer from the area.
Changed gtk_cell_area_forall to gtk_cell_area_foreach since thats more widely used semantics. Also gave a boolean return value to the callback to allow breaking out of the loop.
2010-12-06 03:41:38 +00:00
* @foreach: Calls the #GtkCellCallback function on every #GtkCellRenderer in the area
* with the provided user data until the callback returns %TRUE.
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
* @foreach_alloc: Calls the #GtkCellAllocCallback function on every #GtkCellRenderer in the area
* with the allocated area for the cell and the provided user data until the callback returns %TRUE.
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
* @event: Handle an event in the area, this is generally used to activate a cell
* at the event location for button events but can also be used to generically pass
* events to #GtkWidgets drawn onto the area.
* @render: Actually render the area's cells to the specified rectangle, @background_area
* should be correctly distributed to the cells coresponding background areas.
* @apply_attributes: Apply the cell attributes to the cells. This is implemented as a signal and
* generally #GtkCellArea subclasses dont need to implement this since it's handled by the base
* class but can be overridden to apply some custom attributes.
* @create_context: Creates and returns a class specific #GtkCellAreaContext to store cell
* alignment and allocation details for a said #GtkCellArea class.
* @get_request_mode: This allows an area to tell its layouting widget whether it prefers to
* be allocated in %GTK_SIZE_REQUEST_HEIGHT_FOR_WIDTH or %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT mode.
* @get_preferred_width: Calculates the minimum and natural width of the area's cells
* with the current attributes applied while considering the particular layouting details
* of the said #GtkCellArea. While requests are performed over a series of rows, alignments
* and overall minimum and natural sizes should be stored in the corresponding #GtkCellAreaContext.
* @get_preferred_height_for_width: Calculates the minimum and natural height for the area
* if the passed @context would be allocated the given width. When implementing this virtual
* method it is safe to assume that @context has already stored the aligned cell widths
* for every #GtkTreeModel row that @context will be allocated for since this information
* was stored at #GtkCellAreaClass.get_preferred_width() time. This virtual method should
* also store any necessary alignments of cell heights for the case that the context is
* allocated a height.
* @get_preferred_height: Calculates the minimum and natural height of the area's cells
* with the current attributes applied. Essentially this is the same as
* #GtkCellAreaClass.get_preferred_width() only for areas that are being requested as
* %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT.
* @get_preferred_width_for_height: Calculates the minimum and natural width for the area
* if the passed @context would be allocated the given height. The same as
* #GtkCellAreaClass.get_preferred_height_for_width() only for handling requests in the
* %GTK_SIZE_REQUEST_WIDTH_FOR_HEIGHT mode.
* @set_cell_property: This should be implemented to handle changes in child cell properties
* for a given #GtkCellRenderer that were previously installed on the #GtkCellAreaClass with
* gtk_cell_area_class_install_cell_property().
* @get_cell_property: This should be implemented to report the values of child cell properties
* for a given child #GtkCellRenderer.
* @focus: This virtual method should be implemented to navigate focus from cell to cell
* inside the #GtkCellArea. The #GtkCellArea should move focus from cell to cell inside
* the area and return %FALSE if focus logically leaves the area with the following exceptions:
* When the area contains no activatable cells, the entire area recieves focus. Focus should not
* be given to cells that are actually "focus siblings" of other sibling cells
* (see gtk_cell_area_get_focus_from_sibling()). Focus is set by calling gtk_cell_area_set_focus_cell().
* @is_activatable: Returns whether the #GtkCellArea can respond to #GtkCellAreaClass.activate(),
* usually this does not need to be implemented since the base class takes care of this however
* it can be enhanced if the #GtkCellArea subclass can handle activation in other ways than
* activating its #GtkCellRenderers.
* @activate: This is called when the layouting widget rendering the #GtkCellArea activates
* the focus cell (see gtk_cell_area_get_focus_cell()).
*/
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
struct _GtkCellAreaClass
{
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
/*< private >*/
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
GInitiallyUnownedClass parent_class;
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
/*< public >*/
Added GtkCellArea to the build Starting to form a good api, implemented most of GtkCellLayout iface on the base class routing the apis through the new class vfuncs.
2010-10-22 07:41:52 +00:00
/* Basic methods */
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
void (* add) (GtkCellArea *area,
GtkCellRenderer *renderer);
void (* remove) (GtkCellArea *area,
GtkCellRenderer *renderer);
Changed gtk_cell_area_forall to gtk_cell_area_foreach since thats more widely used semantics. Also gave a boolean return value to the callback to allow breaking out of the loop.
2010-12-06 03:41:38 +00:00
void (* foreach) (GtkCellArea *area,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkCellCallback callback,
gpointer callback_data);
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
void (* foreach_alloc) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Made progress on focus handling. - Added vfunc to get the allocation of a cell inside an area - Superclass GtkCellArea handles activation of focused cells by handling key events (as well as editing of editable cells) - Added signal "editing-started" to GtkCellArea to signal that editing has started (generally signaled from inside event handling) - Added properties "focus-cell" and "edited-cell"
2010-11-05 13:16:32 +00:00
GtkWidget *widget,
const GdkRectangle *cell_area,
Added 'background_area' calculation to GtkCellAreaClass->foreach_alloc vfunc This allows us to reduce code allocation code paths in subclasses, as a result GtkCellArea implements the ->render() vfunc and the subclass only decides the cell area and background area distributions in a single code path.
2010-12-08 12:18:05 +00:00
const GdkRectangle *background_area,
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
GtkCellAllocCallback callback,
gpointer callback_data);
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
gint (* event) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
GdkEvent *event,
Added GtkCellRendererState flags to GtkCellArea->event/render() methods
2010-11-01 03:39:00 +00:00
const GdkRectangle *cell_area,
GtkCellRendererState flags);
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
void (* render) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
Adding GtkCellAreaIter arg to GtkCellArea->render/->event
2010-10-30 14:48:52 +00:00
cairo_t *cr,
GtkCellArea now paints focus on cells Added concept of "Focus Siblings" to GtkCellArea so that some static text/icon may be included in the focus/click area of an activatable or editable cell, implemented focus drawing as well, updated testcellarea to reflect the changes.
2010-11-11 07:13:06 +00:00
const GdkRectangle *background_area,
Added GtkCellRendererState flags to GtkCellArea->event/render() methods
2010-11-01 03:39:00 +00:00
const GdkRectangle *cell_area,
GtkCellArea now paints focus on cells Added concept of "Focus Siblings" to GtkCellArea so that some static text/icon may be included in the focus/click area of an activatable or editable cell, implemented focus drawing as well, updated testcellarea to reflect the changes.
2010-11-11 07:13:06 +00:00
GtkCellRendererState flags,
gboolean paint_focus);
Added GtkCellAreaClass->apply_attributes() Made gtk_cell_area_apply_attributes use a vfunc & signal so that subclasses might do specialized things picking up attributes from the model possibly for embedding widgets, and as specially for GtkTreeMenu to connect to the signal and synchronize the menu sensitivity states in a more convenient way than going through the GtkCellLayoutDataFunc.
2010-11-23 14:37:58 +00:00
void (* apply_attributes) (GtkCellArea *area,
GtkTreeModel *tree_model,
GtkTreeIter *iter,
gboolean is_expander,
gboolean is_expanded);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Added GtkCellArea to the build Starting to form a good api, implemented most of GtkCellLayout iface on the base class routing the apis through the new class vfuncs.
2010-10-22 07:41:52 +00:00
/* Geometry */
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *(* create_context) (GtkCellArea *area);
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkSizeRequestMode (* get_request_mode) (GtkCellArea *area);
void (* get_preferred_width) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
More documentation in gtkcellarea.c
2010-11-15 02:23:55 +00:00
gint *minimum_width,
gint *natural_width);
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
void (* get_preferred_height_for_width) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
gint width,
gint *minimum_height,
gint *natural_height);
void (* get_preferred_height) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
More documentation in gtkcellarea.c
2010-11-15 02:23:55 +00:00
gint *minimum_height,
gint *natural_height);
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
void (* get_preferred_width_for_height) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Adding initial code skeleton for GtkCellAreaBox.
2010-10-23 08:01:58 +00:00
GtkWidget *widget,
gint height,
gint *minimum_width,
gint *natural_width);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Implemented "cell properties" on the GtkCellArea Added cell "packing" properties for generic configuration of child cells inside an area.
2010-10-31 08:13:15 +00:00
/* Cell Properties */
void (* set_cell_property) (GtkCellArea *area,
GtkCellRenderer *renderer,
guint property_id,
const GValue *value,
GParamSpec *pspec);
void (* get_cell_property) (GtkCellArea *area,
GtkCellRenderer *renderer,
guint property_id,
GValue *value,
GParamSpec *pspec);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Added cell focus apis to GtkCellArea.
2010-11-01 07:01:25 +00:00
/* Focus */
Committing new (and simplified) focus handling approach for GtkCellArea. Also adding missing file cellareascaffold.h
2010-11-10 10:17:06 +00:00
gboolean (* focus) (GtkCellArea *area,
Added cell focus apis to GtkCellArea.
2010-11-01 07:01:25 +00:00
GtkDirectionType direction);
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
gboolean (* is_activatable) (GtkCellArea *area);
Committing new (and simplified) focus handling approach for GtkCellArea. Also adding missing file cellareascaffold.h
2010-11-10 10:17:06 +00:00
gboolean (* activate) (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Committing new (and simplified) focus handling approach for GtkCellArea. Also adding missing file cellareascaffold.h
2010-11-10 10:17:06 +00:00
GtkWidget *widget,
const GdkRectangle *cell_area,
Added "edit_only" argument to gtk_cell_area_activate() This argument allows the caller to specify that only an editable cell should start editing but an activatable cell should not toggle it's state, this is important for public apis like gtk_tree_view_set_cursor_on_cell() which are only intended to programatically bring attention to the editing of a specific row or cell but not actually change any data. GtkTreeView & CellAreaScaffold updated for the last minute api change.
2010-12-12 08:15:46 +00:00
GtkCellRendererState flags,
gboolean edit_only);
Committing new (and simplified) focus handling approach for GtkCellArea. Also adding missing file cellareascaffold.h
2010-11-10 10:17:06 +00:00
Adding more documentation to GtkCellArea, documented GtkCellAreaClass structure.
2010-12-02 15:29:22 +00:00
/*< private >*/
Added cell focus apis to GtkCellArea.
2010-11-01 07:01:25 +00:00
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
/* Padding for future expansion */
void (*_gtk_reserved1) (void);
void (*_gtk_reserved2) (void);
void (*_gtk_reserved3) (void);
void (*_gtk_reserved4) (void);
void (*_gtk_reserved5) (void);
void (*_gtk_reserved6) (void);
void (*_gtk_reserved7) (void);
void (*_gtk_reserved8) (void);
};
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GType gtk_cell_area_get_type (void) G_GNUC_CONST;
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
/* Basic methods */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_add (GtkCellArea *area,
GtkCellRenderer *renderer);
void gtk_cell_area_remove (GtkCellArea *area,
GtkCellRenderer *renderer);
gboolean gtk_cell_area_has_renderer (GtkCellArea *area,
GtkCellRenderer *renderer);
Changed gtk_cell_area_forall to gtk_cell_area_foreach since thats more widely used semantics. Also gave a boolean return value to the callback to allow breaking out of the loop.
2010-12-06 03:41:38 +00:00
void gtk_cell_area_foreach (GtkCellArea *area,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkCellCallback callback,
gpointer callback_data);
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
void gtk_cell_area_foreach_alloc (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
const GdkRectangle *cell_area,
Added 'background_area' calculation to GtkCellAreaClass->foreach_alloc vfunc This allows us to reduce code allocation code paths in subclasses, as a result GtkCellArea implements the ->render() vfunc and the subclass only decides the cell area and background area distributions in a single code path.
2010-12-08 12:18:05 +00:00
const GdkRectangle *background_area,
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
GtkCellAllocCallback callback,
gpointer callback_data);
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
gint gtk_cell_area_event (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
GdkEvent *event,
const GdkRectangle *cell_area,
GtkCellRendererState flags);
void gtk_cell_area_render (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
cairo_t *cr,
const GdkRectangle *background_area,
const GdkRectangle *cell_area,
GtkCellRendererState flags,
gboolean paint_focus);
void gtk_cell_area_set_style_detail (GtkCellArea *area,
const gchar *detail);
G_CONST_RETURN gchar *gtk_cell_area_get_style_detail (GtkCellArea *area);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Added gtk_cell_area_foreach_alloc() to further simplify GtkCellArea subclasses gtk_cell_area_foreach_alloc() itterates over an allocated list of cells and calls a callback with the cell's allocation until the callback returns TRUE. - Removed vfunc get_cell_allocation() and implemented gtk_cell_area_get_cell_allocation() using foreach_alloc() - Added gtk_cell_area_get_cell_at_position() using foreach_alloc() - Removed GtkCellAreaBox ->event() implementation and implemented mouse "click" cell activation in GtkCellArea class directly using gtk_cell_area_get_cell_at_position().
2010-12-06 05:11:28 +00:00
void gtk_cell_area_get_cell_allocation (GtkCellArea *area,
GtkCellAreaContext *context,
GtkWidget *widget,
GtkCellRenderer *renderer,
const GdkRectangle *cell_area,
GdkRectangle *allocation);
GtkCellRenderer *gtk_cell_area_get_cell_at_position (GtkCellArea *area,
GtkCellAreaContext *context,
GtkWidget *widget,
const GdkRectangle *cell_area,
gint x,
gint y,
GdkRectangle *alloc_area);
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
/* Geometry */
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *gtk_cell_area_create_context (GtkCellArea *area);
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkSizeRequestMode gtk_cell_area_get_request_mode (GtkCellArea *area);
void gtk_cell_area_get_preferred_width (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
gint *minimum_size,
gint *natural_size);
void gtk_cell_area_get_preferred_height_for_width (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
gint width,
gint *minimum_height,
gint *natural_height);
void gtk_cell_area_get_preferred_height (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
gint *minimum_size,
gint *natural_size);
void gtk_cell_area_get_preferred_width_for_height (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
gint height,
gint *minimum_width,
gint *natural_width);
G_CONST_RETURN gchar *gtk_cell_area_get_current_path_string (GtkCellArea *area);
Made progress on focus handling. - Added vfunc to get the allocation of a cell inside an area - Superclass GtkCellArea handles activation of focused cells by handling key events (as well as editing of editable cells) - Added signal "editing-started" to GtkCellArea to signal that editing has started (generally signaled from inside event handling) - Added properties "focus-cell" and "edited-cell"
2010-11-05 13:16:32 +00:00
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
Implemented "cell properties" on the GtkCellArea Added cell "packing" properties for generic configuration of child cells inside an area.
2010-10-31 08:13:15 +00:00
/* Attributes */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_apply_attributes (GtkCellArea *area,
GtkTreeModel *tree_model,
GtkTreeIter *iter,
gboolean is_expander,
gboolean is_expanded);
void gtk_cell_area_attribute_connect (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *attribute,
gint column);
void gtk_cell_area_attribute_disconnect (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *attribute);
Implemented remaining portions of GtkCellLayout iface Now GtkCellArea provides a generic way of applying attributes from a GtkTreeModel/GtkTreeIter, GtkCellArea bookkeeps a hashtable of GtkCellLayoutDataFunc's and completely abstracts the applying of data to cells... GtkCellArea implementations need only to bookkeep the added renderers and attributes (probably we can abstract the attribute bookkeeping in the base class as well). Things starting to take a good and practical shape.
2010-10-24 06:44:48 +00:00
Implemented "cell properties" on the GtkCellArea Added cell "packing" properties for generic configuration of child cells inside an area.
2010-10-31 08:13:15 +00:00
/* Cell Properties */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_class_install_cell_property (GtkCellAreaClass *aclass,
guint property_id,
GParamSpec *pspec);
GParamSpec* gtk_cell_area_class_find_cell_property (GtkCellAreaClass *aclass,
const gchar *property_name);
GParamSpec** gtk_cell_area_class_list_cell_properties (GtkCellAreaClass *aclass,
guint *n_properties);
void gtk_cell_area_add_with_properties (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *first_prop_name,
...) G_GNUC_NULL_TERMINATED;
void gtk_cell_area_cell_set (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *first_prop_name,
...) G_GNUC_NULL_TERMINATED;
void gtk_cell_area_cell_get (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *first_prop_name,
...) G_GNUC_NULL_TERMINATED;
void gtk_cell_area_cell_set_valist (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *first_property_name,
va_list var_args);
void gtk_cell_area_cell_get_valist (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *first_property_name,
va_list var_args);
void gtk_cell_area_cell_set_property (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *property_name,
const GValue *value);
void gtk_cell_area_cell_get_property (GtkCellArea *area,
GtkCellRenderer *renderer,
const gchar *property_name,
GValue *value);
Implemented "cell properties" on the GtkCellArea Added cell "packing" properties for generic configuration of child cells inside an area.
2010-10-31 08:13:15 +00:00
Added cell focus apis to GtkCellArea.
2010-11-01 07:01:25 +00:00
/* Focus */
Changed cell area/renderer "can_focus" semantics to "is_activatable" across the board. This is because focus in treeviews can be given to cells that cannot do anything with activation (for better keynav), so we dissociate the concept of cell activation and focusing.
2010-11-29 07:29:09 +00:00
gboolean gtk_cell_area_is_activatable (GtkCellArea *area);
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
gboolean gtk_cell_area_activate (GtkCellArea *area,
Mass rename GtkCellAreaIter --> GtkCellAreaContext
2010-11-13 07:23:01 +00:00
GtkCellAreaContext *context,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkWidget *widget,
const GdkRectangle *cell_area,
Added "edit_only" argument to gtk_cell_area_activate() This argument allows the caller to specify that only an editable cell should start editing but an activatable cell should not toggle it's state, this is important for public apis like gtk_tree_view_set_cursor_on_cell() which are only intended to programatically bring attention to the editing of a specific row or cell but not actually change any data. GtkTreeView & CellAreaScaffold updated for the last minute api change.
2010-12-12 08:15:46 +00:00
GtkCellRendererState flags,
gboolean edit_only);
Changed cell area/renderer "can_focus" semantics to "is_activatable" across the board. This is because focus in treeviews can be given to cells that cannot do anything with activation (for better keynav), so we dissociate the concept of cell activation and focusing.
2010-11-29 07:29:09 +00:00
gboolean gtk_cell_area_focus (GtkCellArea *area,
GtkDirectionType direction);
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_set_focus_cell (GtkCellArea *area,
GtkCellRenderer *renderer);
GtkCellRenderer *gtk_cell_area_get_focus_cell (GtkCellArea *area);
Committing half-way done focus work.
2010-11-05 04:05:20 +00:00
GtkCellArea now paints focus on cells Added concept of "Focus Siblings" to GtkCellArea so that some static text/icon may be included in the focus/click area of an activatable or editable cell, implemented focus drawing as well, updated testcellarea to reflect the changes.
2010-11-11 07:13:06 +00:00
/* Focus siblings */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_add_focus_sibling (GtkCellArea *area,
GtkCellRenderer *renderer,
GtkCellRenderer *sibling);
void gtk_cell_area_remove_focus_sibling (GtkCellArea *area,
GtkCellRenderer *renderer,
GtkCellRenderer *sibling);
gboolean gtk_cell_area_is_focus_sibling (GtkCellArea *area,
GtkCellRenderer *renderer,
GtkCellRenderer *sibling);
G_CONST_RETURN GList *gtk_cell_area_get_focus_siblings (GtkCellArea *area,
GtkCellRenderer *renderer);
GtkCellRenderer *gtk_cell_area_get_focus_from_sibling (GtkCellArea *area,
GtkCellRenderer *renderer);
GtkCellArea now paints focus on cells Added concept of "Focus Siblings" to GtkCellArea so that some static text/icon may be included in the focus/click area of an activatable or editable cell, implemented focus drawing as well, updated testcellarea to reflect the changes.
2010-11-11 07:13:06 +00:00
Added gtk_cell_area_activate_cell() and some cell editing management Now: - The current edit cell and editable widget in use can be fetched with properties and accessors - gtk_cell_area_activate_cell() handles bookkeeping of the currently edited cell, starting the editing of a cell, activating a cell etc - Exported signals are available on GtkCellArea: "editing-started", "editing-canceled", "editing-done", "remove-editable". - Upon receiving GDK_KEY_Escape current editing gets canceled.
2010-11-06 06:29:27 +00:00
/* Cell Activation/Editing */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
GtkCellRenderer *gtk_cell_area_get_edited_cell (GtkCellArea *area);
GtkCellEditable *gtk_cell_area_get_edit_widget (GtkCellArea *area);
gboolean gtk_cell_area_activate_cell (GtkCellArea *area,
GtkWidget *widget,
GtkCellRenderer *renderer,
GdkEvent *event,
const GdkRectangle *cell_area,
GtkCellRendererState flags);
void gtk_cell_area_stop_editing (GtkCellArea *area,
gboolean canceled);
Committing half-way done focus work.
2010-11-05 04:05:20 +00:00
Changed GtkCellArea margin-left/right... for cell-margin-left/right... The rationale here is that every cell in an area needs to have space reserved around it, requests have to be fully margin inclusive... cells need to have the full size fed as the "background area" and the "cell area" has margins removed... This will be used by GtkTreeViewColumn to set the focus line width so that cells can paint a background on the full background, then render themselves into the cell area... and parents can go ahead and draw focus and other indicators on the background area but outside of the cell area.
2010-10-31 13:50:53 +00:00
/* Functions for area implementations */
/* Distinguish the inner cell area from the whole requested area including margins */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_inner_cell_area (GtkCellArea *area,
Removed cell margin apis and now deal with "focus-line-width".
2010-11-23 07:26:46 +00:00
GtkWidget *widget,
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
const GdkRectangle *cell_area,
Ironed out the kinks in editing apis for GtkCellArea - Added gtk_cell_area_aligned_cell_area() to get the aligned internal area use by a cell (for focus painting and for event areas). - Provide the event area in "editing-started" signal - Fire "remove-editable" when editing is canceled by the user, an implementing layouting widget need only catch "editing-started" and "remove-editable" now. - CellAreaScaffold/testcellarea now edit textrenderers.
2010-11-12 10:25:07 +00:00
GdkRectangle *inner_area);
Changed GtkCellArea margin-left/right... for cell-margin-left/right... The rationale here is that every cell in an area needs to have space reserved around it, requests have to be fully margin inclusive... cells need to have the full size fed as the "background area" and the "cell area" has margins removed... This will be used by GtkTreeViewColumn to set the focus line width so that cells can paint a background on the full background, then render themselves into the cell area... and parents can go ahead and draw focus and other indicators on the background area but outside of the cell area.
2010-10-31 13:50:53 +00:00
/* Request the size of a cell while respecting the cell margins (requests are margin inclusive) */
Distribute portions of GtkCellArea:render() background_area argument to cells Also added gtk_cell_area_get/set_style_detail() to set the string to be used by the area in gtk_paint_* functions.
2010-11-12 05:06:00 +00:00
void gtk_cell_area_request_renderer (GtkCellArea *area,
GtkCellRenderer *renderer,
GtkOrientation orientation,
GtkWidget *widget,
gint for_size,
gint *minimum_size,
gint *natural_size);
Implemented remaining portions of GtkCellLayout iface Now GtkCellArea provides a generic way of applying attributes from a GtkTreeModel/GtkTreeIter, GtkCellArea bookkeeps a hashtable of GtkCellLayoutDataFunc's and completely abstracts the applying of data to cells... GtkCellArea implementations need only to bookkeep the added renderers and attributes (probably we can abstract the attribute bookkeeping in the base class as well). Things starting to take a good and practical shape.
2010-10-24 06:44:48 +00:00
Adding vague initial draft of GtkCellArea to the codebase (treeview-refactor branch).
2010-10-21 13:46:10 +00:00
G_END_DECLS
#endif /* __GTK_CELL_AREA_H__ */
Reference in New Issue Copy Permalink