X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=gtk%2Fgtkcellrenderer.h;h=8948e64c56751d14586eea8ece13d0d53526786e;hb=320613c439c6c7eeb5bc64685522195e0a6adc4e;hp=bcb021031b513230200866de0002c7d60c461f03;hpb=2bb1cc877dc477a2e3a630ac5272a493df4cbff4;p=~andy%2Fgtk diff --git a/gtk/gtkcellrenderer.h b/gtk/gtkcellrenderer.h index bcb021031..8948e64c5 100644 --- a/gtk/gtkcellrenderer.h +++ b/gtk/gtkcellrenderer.h @@ -12,24 +12,34 @@ * 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. + * License along with this library. If not, see . */ -#if defined(GTK_DISABLE_SINGLE_INCLUDES) && !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) -#error "Only can be included directly." -#endif - #ifndef __GTK_CELL_RENDERER_H__ #define __GTK_CELL_RENDERER_H__ -#include -#include +#if !defined (__GTK_H_INSIDE__) && !defined (GTK_COMPILATION) +#error "Only can be included directly." +#endif + #include G_BEGIN_DECLS + +/** + * GtkCellRendererState: + * @GTK_CELL_RENDERER_SELECTED: The cell is currently selected, and + * probably has a selection colored background to render to. + * @GTK_CELL_RENDERER_PRELIT: The mouse is hovering over the cell. + * @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner + * @GTK_CELL_RENDERER_SORTED: The cell is in a sorted row + * @GTK_CELL_RENDERER_FOCUSED: The cell is in the focus row. + * @GTK_CELL_RENDERER_EXPANDABLE: The cell is in a row that can be expanded. Since 3.4 + * @GTK_CELL_RENDERER_EXPANDED: The cell is in a row that is expanded. Since 3.4 + * + * Tells how a cell is to be rendered. + */ typedef enum { GTK_CELL_RENDERER_SELECTED = 1 << 0, @@ -37,9 +47,22 @@ typedef enum GTK_CELL_RENDERER_INSENSITIVE = 1 << 2, /* this flag means the cell is in the sort column/row */ GTK_CELL_RENDERER_SORTED = 1 << 3, - GTK_CELL_RENDERER_FOCUSED = 1 << 4 + GTK_CELL_RENDERER_FOCUSED = 1 << 4, + GTK_CELL_RENDERER_EXPANDABLE = 1 << 5, + GTK_CELL_RENDERER_EXPANDED = 1 << 6 } GtkCellRendererState; +/** + * GtkCellRendererMode: + * @GTK_CELL_RENDERER_MODE_INERT: The cell is just for display + * and cannot be interacted with. Note that this doesn't mean that eg. the + * row being drawn can't be selected -- just that a particular element of + * it cannot be individually modified. + * @GTK_CELL_RENDERER_MODE_ACTIVATABLE: The cell can be clicked. + * @GTK_CELL_RENDERER_MODE_EDITABLE: The cell can be edited or otherwise modified. + * + * Identifies how the user can interact with a particular cell. + */ typedef enum { GTK_CELL_RENDERER_MODE_INERT, @@ -54,64 +77,75 @@ typedef enum #define GTK_IS_CELL_RENDERER_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_CELL_RENDERER)) #define GTK_CELL_RENDERER_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_CELL_RENDERER, GtkCellRendererClass)) -typedef struct _GtkCellRenderer GtkCellRenderer; -typedef struct _GtkCellRendererClass GtkCellRendererClass; +typedef struct _GtkCellRenderer GtkCellRenderer; +typedef struct _GtkCellRendererPrivate GtkCellRendererPrivate; +typedef struct _GtkCellRendererClass GtkCellRendererClass; +typedef struct _GtkCellRendererClassPrivate GtkCellRendererClassPrivate; struct _GtkCellRenderer { - GtkObject parent; - - gfloat GSEAL (xalign); - gfloat GSEAL (yalign); + GInitiallyUnowned parent_instance; - gint GSEAL (width); - gint GSEAL (height); - - guint16 GSEAL (xpad); - guint16 GSEAL (ypad); - - guint GSEAL (mode : 2); - guint GSEAL (visible : 1); - guint GSEAL (is_expander : 1); - guint GSEAL (is_expanded : 1); - guint GSEAL (cell_background_set : 1); - guint GSEAL (sensitive : 1); - guint GSEAL (editing : 1); + /*< private >*/ + GtkCellRendererPrivate *priv; }; struct _GtkCellRendererClass { - GtkObjectClass parent_class; + GInitiallyUnownedClass parent_class; /* vtable - not signals */ - void (* get_size) (GtkCellRenderer *cell, - GtkWidget *widget, - GdkRectangle *cell_area, - gint *x_offset, - gint *y_offset, - gint *width, - gint *height); - void (* render) (GtkCellRenderer *cell, - GdkDrawable *window, - GtkWidget *widget, - GdkRectangle *background_area, - GdkRectangle *cell_area, - GdkRectangle *expose_area, - GtkCellRendererState flags); - gboolean (* activate) (GtkCellRenderer *cell, - GdkEvent *event, - GtkWidget *widget, - const gchar *path, - GdkRectangle *background_area, - GdkRectangle *cell_area, - GtkCellRendererState flags); - GtkCellEditable *(* start_editing) (GtkCellRenderer *cell, - GdkEvent *event, - GtkWidget *widget, - const gchar *path, - GdkRectangle *background_area, - GdkRectangle *cell_area, - GtkCellRendererState flags); + GtkSizeRequestMode (* get_request_mode) (GtkCellRenderer *cell); + void (* get_preferred_width) (GtkCellRenderer *cell, + GtkWidget *widget, + gint *minimum_size, + gint *natural_size); + void (* get_preferred_height_for_width) (GtkCellRenderer *cell, + GtkWidget *widget, + gint width, + gint *minimum_height, + gint *natural_height); + void (* get_preferred_height) (GtkCellRenderer *cell, + GtkWidget *widget, + gint *minimum_size, + gint *natural_size); + void (* get_preferred_width_for_height) (GtkCellRenderer *cell, + GtkWidget *widget, + gint height, + gint *minimum_width, + gint *natural_width); + void (* get_aligned_area) (GtkCellRenderer *cell, + GtkWidget *widget, + GtkCellRendererState flags, + const GdkRectangle *cell_area, + GdkRectangle *aligned_area); + void (* get_size) (GtkCellRenderer *cell, + GtkWidget *widget, + const GdkRectangle *cell_area, + gint *x_offset, + gint *y_offset, + gint *width, + gint *height); + void (* render) (GtkCellRenderer *cell, + cairo_t *cr, + GtkWidget *widget, + const GdkRectangle *background_area, + const GdkRectangle *cell_area, + GtkCellRendererState flags); + gboolean (* activate) (GtkCellRenderer *cell, + GdkEvent *event, + GtkWidget *widget, + const gchar *path, + const GdkRectangle *background_area, + const GdkRectangle *cell_area, + GtkCellRendererState flags); + GtkCellEditable * (* start_editing) (GtkCellRenderer *cell, + GdkEvent *event, + GtkWidget *widget, + const gchar *path, + const GdkRectangle *background_area, + const GdkRectangle *cell_area, + GtkCellRendererState flags); /* Signals */ void (* editing_canceled) (GtkCellRenderer *cell); @@ -119,26 +153,58 @@ struct _GtkCellRendererClass GtkCellEditable *editable, const gchar *path); + GtkCellRendererClassPrivate *priv; + /* Padding for future expansion */ - void (*_gtk_reserved1) (void); void (*_gtk_reserved2) (void); + void (*_gtk_reserved3) (void); + void (*_gtk_reserved4) (void); }; -GType gtk_cell_renderer_get_type (void) G_GNUC_CONST; +GType gtk_cell_renderer_get_type (void) G_GNUC_CONST; +GtkSizeRequestMode gtk_cell_renderer_get_request_mode (GtkCellRenderer *cell); +void gtk_cell_renderer_get_preferred_width (GtkCellRenderer *cell, + GtkWidget *widget, + gint *minimum_size, + gint *natural_size); +void gtk_cell_renderer_get_preferred_height_for_width (GtkCellRenderer *cell, + GtkWidget *widget, + gint width, + gint *minimum_height, + gint *natural_height); +void gtk_cell_renderer_get_preferred_height (GtkCellRenderer *cell, + GtkWidget *widget, + gint *minimum_size, + gint *natural_size); +void gtk_cell_renderer_get_preferred_width_for_height (GtkCellRenderer *cell, + GtkWidget *widget, + gint height, + gint *minimum_width, + gint *natural_width); +void gtk_cell_renderer_get_preferred_size (GtkCellRenderer *cell, + GtkWidget *widget, + GtkRequisition *minimum_size, + GtkRequisition *natural_size); +void gtk_cell_renderer_get_aligned_area (GtkCellRenderer *cell, + GtkWidget *widget, + GtkCellRendererState flags, + const GdkRectangle *cell_area, + GdkRectangle *aligned_area); + +GDK_DEPRECATED_IN_3_0_FOR(gtk_cell_renderer_get_preferred_size) void gtk_cell_renderer_get_size (GtkCellRenderer *cell, - GtkWidget *widget, - const GdkRectangle *cell_area, - gint *x_offset, - gint *y_offset, - gint *width, - gint *height); + GtkWidget *widget, + const GdkRectangle *cell_area, + gint *x_offset, + gint *y_offset, + gint *width, + gint *height); void gtk_cell_renderer_render (GtkCellRenderer *cell, - GdkWindow *window, + cairo_t *cr, GtkWidget *widget, const GdkRectangle *background_area, const GdkRectangle *cell_area, - const GdkRectangle *expose_area, GtkCellRendererState flags); gboolean gtk_cell_renderer_activate (GtkCellRenderer *cell, GdkEvent *event, @@ -154,6 +220,7 @@ GtkCellEditable *gtk_cell_renderer_start_editing (GtkCellRenderer *cell, const GdkRectangle *background_area, const GdkRectangle *cell_area, GtkCellRendererState flags); + void gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell, gint width, gint height); @@ -161,13 +228,52 @@ void gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell, gint *width, gint *height); +void gtk_cell_renderer_set_alignment (GtkCellRenderer *cell, + gfloat xalign, + gfloat yalign); +void gtk_cell_renderer_get_alignment (GtkCellRenderer *cell, + gfloat *xalign, + gfloat *yalign); + +void gtk_cell_renderer_set_padding (GtkCellRenderer *cell, + gint xpad, + gint ypad); +void gtk_cell_renderer_get_padding (GtkCellRenderer *cell, + gint *xpad, + gint *ypad); + +void gtk_cell_renderer_set_visible (GtkCellRenderer *cell, + gboolean visible); +gboolean gtk_cell_renderer_get_visible (GtkCellRenderer *cell); + +void gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell, + gboolean sensitive); +gboolean gtk_cell_renderer_get_sensitive (GtkCellRenderer *cell); + +gboolean gtk_cell_renderer_is_activatable (GtkCellRenderer *cell); + /* For use by cell renderer implementations only */ -#ifndef GTK_DISABLE_DEPRECATED -void gtk_cell_renderer_editing_canceled (GtkCellRenderer *cell); -#endif -void gtk_cell_renderer_stop_editing (GtkCellRenderer *cell, - gboolean canceled); +void gtk_cell_renderer_stop_editing (GtkCellRenderer *cell, + gboolean canceled); + + +void _gtk_cell_renderer_calc_offset (GtkCellRenderer *cell, + const GdkRectangle *cell_area, + GtkTextDirection direction, + gint width, + gint height, + gint *x_offset, + gint *y_offset); + +GtkStateFlags gtk_cell_renderer_get_state (GtkCellRenderer *cell, + GtkWidget *widget, + GtkCellRendererState cell_state); +void gtk_cell_renderer_class_set_accessible_type + (GtkCellRendererClass *renderer_class, + GType type); +GType _gtk_cell_renderer_get_accessible_type + (GtkCellRenderer * renderer); G_END_DECLS