Top | ![]() |
![]() |
![]() |
![]() |
Functions
void | goc_item_bounds_changed () |
void | goc_item_destroy () |
double | goc_item_distance () |
void | goc_item_draw () |
gboolean | goc_item_draw_region () |
void | goc_item_get_bounds () |
cairo_operator_t | goc_item_get_operator () |
GocGroup * | goc_item_get_parent () |
GtkStyleContext * | goc_item_get_style_context () |
GdkWindow * | goc_item_get_window () |
void | goc_item_grab () |
void | goc_item_hide () |
void | goc_item_invalidate () |
gboolean | goc_item_is_visible () |
void | goc_item_lower () |
void | goc_item_lower_to_bottom () |
GocItem * | goc_item_new () |
void | goc_item_raise () |
void | goc_item_raise_to_top () |
void | goc_item_set () |
void | goc_item_set_operator () |
void | goc_item_set_transform () |
void | goc_item_set_visible () |
void | goc_item_show () |
void | goc_item_ungrab () |
Object Hierarchy
GObject ╰── GocItem ├── GocStyledItem ├── GocComponent ├── GocGraph ├── GocGroup ├── GocImage ├── GocPixbuf ╰── GocWidget
Functions
goc_item_bounds_changed ()
void
goc_item_bounds_changed (GocItem *item
);
This function needs to be called each time the bounds of item
change. It
is normally called from inside the implementation of items derived classes.
goc_item_destroy ()
void
goc_item_destroy (GocItem *item
);
Destroys item
, removes it from its parent group and updates the canvas
accordingly.
goc_item_distance ()
double goc_item_distance (GocItem *item
,double x
,double y
,GocItem **near_item
);
Evaluates the distance between the point with canvas coordinates x
,y
and the nearest point of item
. near_item
is set with either item
or
its appropriate child.
goc_item_draw ()
void goc_item_draw (GocItem const *item
,cairo_t *cr
);
Renders item
using cr
. There is no need to call this function directly.
Invalidating the item is the way to go.
goc_item_draw_region ()
gboolean goc_item_draw_region (GocItem const *item
,cairo_t *cr
,double x0
,double y0
,double x1
,double y1
);
Renders item
using cr
, limiting all drawings to the region limited by
x0
, y0
, x1
, and y1
. If this function returns FALSE
, goc_item_draw
should be called. There is no need to call this function directly.
Invalidating the item is the way to go.
goc_item_get_bounds ()
void goc_item_get_bounds (GocItem const *item
,double *x0
,double *y0
,double *x1
,double *y1
);
Retrieves the bounds of item
in canvas coordinates.
goc_item_get_window ()
GdkWindow *
goc_item_get_window (GocItem *item
);
Returns
The GdkWindow associated with the item if any or NULL. Only GocWidget owns a GdkWindow.
[transfer none]
goc_item_grab ()
void
goc_item_grab (GocItem *item
);
Grabs the item. This function will fail if another item is grabbed.
goc_item_invalidate ()
void
goc_item_invalidate (GocItem *item
);
Force a redraw of item
bounding region.
goc_item_lower ()
void goc_item_lower (GocItem *item
,int n
);
Lowers item
by n
steps inside its parent GocGroup (or less if the list
is too short) in the item list so that it is displayed more deeply in the
items stack.
goc_item_lower_to_bottom ()
void
goc_item_lower_to_bottom (GocItem *item
);
Lowers item
to bottom inside its parent GocGroup so that it will be at
least partly hidden by any overlapping item.
goc_item_new ()
GocItem * goc_item_new (GocGroup *parent
,GType type
,const gchar *first_arg_name
,...
);
Creates a new item of type type
in group group
. Properties can be
set just the same way they are in g_object_new.
Parameters
parent |
parent GocGroup for the new item |
|
type |
GType of the new item |
|
first_arg_name |
property name or |
|
... |
value for the first property, followed optionally by more
name/value pairs, followed by |
goc_item_raise ()
void goc_item_raise (GocItem *item
,int n
);
Raises item
by n
steps inside its parent GocGroup (or less if the list
is too short) in the item list so that it is displayed nearer the top of
the items stack.
goc_item_raise_to_top ()
void
goc_item_raise_to_top (GocItem *item
);
Raises item
to front so that it becomes the toplevel item inside
its parent GocGroup.
goc_item_set ()
void goc_item_set (GocItem *item
,const gchar *first_arg_name
,...
);
Set properties and updates the canvas. Using g_object_set instead would set the properties, but not update the canvas.
goc_item_set_operator ()
void goc_item_set_operator (GocItem *item
,cairo_operator_t op
);
Set the operator used when drawing the item.
goc_item_set_transform ()
void goc_item_set_transform (GocItem *item
,cairo_matrix_t *m
);
Set the matrix used to transform the item.
goc_item_set_visible ()
void goc_item_set_visible (GocItem *item
,gboolean visible
);
Either hides or shows item
as appropriate..
Types and Values
struct GocItemClass
struct GocItemClass { GObjectClass base; double (*distance) (GocItem *item, double x, double y, GocItem **near_item); void (*draw) (GocItem const *item, cairo_t *cr); gboolean (*draw_region) (GocItem const *item, cairo_t *cr, double x0, double y0, double x1, double y1); void (*update_bounds) (GocItem *item); /* events related functions */ gboolean (*button_pressed) (GocItem *item, int button, double x, double y); gboolean (*button2_pressed) (GocItem *item, int button, double x, double y); gboolean (*button_released) (GocItem *item, int button, double x, double y); gboolean (*motion) (GocItem *item, double x, double y); gboolean (*enter_notify) (GocItem *item, double x, double y); gboolean (*leave_notify) (GocItem *item, double x, double y); void (*realize) (GocItem *item); void (*unrealize) (GocItem *item); void (*notify_scrolled) (GocItem *item); #ifdef GOFFICE_WITH_GTK gboolean (*key_pressed) (GocItem *item, GdkEventKey* ev); gboolean (*key_released) (GocItem *item, GdkEventKey* ev); GdkWindow* (*get_window) (GocItem *item); #endif };
The base class for all canvas items.
Members
the parent class |
||
returns the distance between the item and the point defined by
|
||
draws the item to the cairo context. |
||
draws the item in the region defined by |
||
updates the bounds stored in GocItem as fields x0, y0, x1,and y1. |
||
callback for a button press event. |
||
callback for a double click event. |
||
callback for a button release event. |
||
callback for a motion event. |
||
callback for an enter notify event. |
||
callback for a leave notify event. |
||
callback for a realizes event. |
||
callback for an unrealize event. |
||
callback for a notify scrolled event. This is useful to reposition children of the GtkLayout parent of the canvas to their new position. |
||
callback for a key press event. |
||
callback for a key release event. |
||
returns the GdkWindow for the item if any. |