626f27f7ed
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.
268 lines
15 KiB
C
268 lines
15 KiB
C
/* gtkcellrenderer.h
|
|
* Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.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, 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_RENDERER_H__
|
|
#define __GTK_CELL_RENDERER_H__
|
|
|
|
#include <gtk/gtkcelleditable.h>
|
|
|
|
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.
|
|
*
|
|
* Tells how a cell is to be rendererd.
|
|
*/
|
|
typedef enum
|
|
{
|
|
GTK_CELL_RENDERER_SELECTED = 1 << 0,
|
|
GTK_CELL_RENDERER_PRELIT = 1 << 1,
|
|
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
|
|
} 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,
|
|
GTK_CELL_RENDERER_MODE_ACTIVATABLE,
|
|
GTK_CELL_RENDERER_MODE_EDITABLE
|
|
} GtkCellRendererMode;
|
|
|
|
#define GTK_TYPE_CELL_RENDERER (gtk_cell_renderer_get_type ())
|
|
#define GTK_CELL_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), GTK_TYPE_CELL_RENDERER, GtkCellRenderer))
|
|
#define GTK_CELL_RENDERER_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_CELL_RENDERER, GtkCellRendererClass))
|
|
#define GTK_IS_CELL_RENDERER(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GTK_TYPE_CELL_RENDERER))
|
|
#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 _GtkCellRendererPrivate GtkCellRendererPrivate;
|
|
typedef struct _GtkCellRendererClass GtkCellRendererClass;
|
|
|
|
struct _GtkCellRenderer
|
|
{
|
|
GInitiallyUnowned parent_instance;
|
|
|
|
/*< private >*/
|
|
GtkCellRendererPrivate *priv;
|
|
};
|
|
|
|
struct _GtkCellRendererClass
|
|
{
|
|
GInitiallyUnownedClass parent_class;
|
|
|
|
/* vtable - not signals */
|
|
GtkSizeRequestMode (* get_request_mode) (GtkCellRenderer *cell);
|
|
void (* get_preferred_width) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size);
|
|
void (* get_preferred_height_for_width) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
gint width,
|
|
gint *minimum_height,
|
|
gint *natural_height);
|
|
void (* get_preferred_height) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
gint *minimum_size,
|
|
gint *natural_size);
|
|
void (* get_preferred_width_for_height) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
gint height,
|
|
gint *minimum_width,
|
|
gint *natural_width);
|
|
void (* get_aligned_area) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
GtkCellRendererState flags,
|
|
const GdkRectangle *cell_area,
|
|
GdkRectangle *aligned_area);
|
|
void (* get_size) (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
const GdkRectangle *cell_area,
|
|
gint *x_offset,
|
|
gint *y_offset,
|
|
gint *width,
|
|
gint *height);
|
|
void (* render) (GtkCellRenderer *cell,
|
|
cairo_t *cr,
|
|
GtkWidget *widget,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
gboolean (* activate) (GtkCellRenderer *cell,
|
|
GdkEvent *event,
|
|
GtkWidget *widget,
|
|
const gchar *path,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
GtkCellEditable * (* start_editing) (GtkCellRenderer *cell,
|
|
GdkEvent *event,
|
|
GtkWidget *widget,
|
|
const gchar *path,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
|
|
/* Signals */
|
|
void (* editing_canceled) (GtkCellRenderer *cell);
|
|
void (* editing_started) (GtkCellRenderer *cell,
|
|
GtkCellEditable *editable,
|
|
const gchar *path);
|
|
|
|
/* 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;
|
|
|
|
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);
|
|
|
|
#ifndef GTK_DISABLE_DEPRECATED
|
|
void gtk_cell_renderer_get_size (GtkCellRenderer *cell,
|
|
GtkWidget *widget,
|
|
const GdkRectangle *cell_area,
|
|
gint *x_offset,
|
|
gint *y_offset,
|
|
gint *width,
|
|
gint *height);
|
|
#endif
|
|
void gtk_cell_renderer_render (GtkCellRenderer *cell,
|
|
cairo_t *cr,
|
|
GtkWidget *widget,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
gboolean gtk_cell_renderer_activate (GtkCellRenderer *cell,
|
|
GdkEvent *event,
|
|
GtkWidget *widget,
|
|
const gchar *path,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
GtkCellEditable *gtk_cell_renderer_start_editing (GtkCellRenderer *cell,
|
|
GdkEvent *event,
|
|
GtkWidget *widget,
|
|
const gchar *path,
|
|
const GdkRectangle *background_area,
|
|
const GdkRectangle *cell_area,
|
|
GtkCellRendererState flags);
|
|
|
|
void gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
|
|
gint width,
|
|
gint height);
|
|
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 */
|
|
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);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GTK_CELL_RENDERER_H__ */
|