| GooCanvas Reference Manual | ||||
|---|---|---|---|---|
GooCanvasGrid;
GooCanvasItem* goo_canvas_grid_new (GooCanvasItem *parent,
gdouble x,
gdouble y,
gdouble width,
gdouble height,
gdouble x_step,
gdouble y_step,
gdouble x_offset,
gdouble y_offset,
...);
"border-color" gchararray : Write "border-color-rgba" guint : Read / Write "border-pattern" GooCairoPattern : Read / Write "border-pixbuf" GdkPixbuf : Write "border-width" gdouble : Read / Write "height" gdouble : Read / Write "horz-grid-line-color" gchararray : Write "horz-grid-line-color-rgba" guint : Read / Write "horz-grid-line-pattern" GooCairoPattern : Read / Write "horz-grid-line-pixbuf" GdkPixbuf : Write "horz-grid-line-width" gdouble : Read / Write "show-horz-grid-lines" gboolean : Read / Write "show-vert-grid-lines" gboolean : Read / Write "vert-grid-line-color" gchararray : Write "vert-grid-line-color-rgba" guint : Read / Write "vert-grid-line-pattern" GooCairoPattern : Read / Write "vert-grid-line-pixbuf" GdkPixbuf : Write "vert-grid-line-width" gdouble : Read / Write "vert-grid-lines-on-top" gboolean : Read / Write "width" gdouble : Read / Write "x" gdouble : Read / Write "x-offset" gdouble : Read / Write "x-step" gdouble : Read / Write "y" gdouble : Read / Write "y-offset" gdouble : Read / Write "y-step" gdouble : Read / Write
GooCanvasGrid represents a grid item.
It is a subclass of GooCanvasItemSimple and so inherits all of the style properties such as "stroke-color", "fill-color" and "line-width".
It also implements the GooCanvasItem interface, so you can use the
GooCanvasItem functions such as goo_canvas_item_raise() and
goo_canvas_item_rotate().
To create a GooCanvasGrid use goo_canvas_grid_new().
To get or set the properties of an existing GooCanvasGrid, use
g_object_get() and g_object_set().
typedef struct _GooCanvasGrid GooCanvasGrid;
The GooCanvasGrid struct contains private data only.
GooCanvasItem* goo_canvas_grid_new (GooCanvasItem *parent, gdouble x, gdouble y, gdouble width, gdouble height, gdouble x_step, gdouble y_step, gdouble x_offset, gdouble y_offset, ...);
Creates a new grid item.
|
the parent item, or NULL. If a parent is specified, it will assume
ownership of the item, and the item will automatically be freed when it is
removed from the parent. Otherwise call g_object_unref() to free it.
|
|
the x coordinate of the left of the grid. |
|
the y coordinate of the top of the grid. |
|
the width of the grid. |
|
the height of the grid. |
|
the distance between the vertical grid lines. |
|
the distance between the horizontal grid lines. |
|
the distance before the first vertical grid line. |
|
the distance before the first horizontal grid line. |
|
optional pairs of property names and values, and a terminating NULL.
|
Returns : |
a new grid item. |
Here's an example showing how to create a grid:
GooCanvasItem *grid = goo_canvas_grid_new (mygroup, 100.0, 100.0, 400.0, 200.0,
20.0, 20.0, 10.0, 10.0,
"horz-grid-line-width", 4.0,
"horz-grid-line-color", "yellow",
"vert-grid-line-width", 2.0,
"vert-grid-line-color", "red",
"border-width", 3.0,
"border-color", "white",
"fill-color", "blue",
NULL);
"border-color" property"border-color" gchararray : Write
The color to use for the border.
Default value: NULL
"border-color-rgba" property"border-color-rgba" guint : Read / Write
The color to use for the border, specified as a 32-bit integer value.
Default value: 0
"border-pattern" property"border-pattern" GooCairoPattern : Read / Write
The cairo pattern to paint the border with.
"border-pixbuf" property"border-pixbuf" GdkPixbuf : Write
The pixbuf to use to draw the border.
"border-width" property"border-width" gdouble : Read / Write
The width of the border around the grid.
Default value: -1
"height" property"height" gdouble : Read / Write
The height of the grid.
Allowed values: >= 0
Default value: 0
"horz-grid-line-color" property"horz-grid-line-color" gchararray : Write
The color to use for the horizontal grid lines.
Default value: NULL
"horz-grid-line-color-rgba" property"horz-grid-line-color-rgba" guint : Read / Write
The color to use for the horizontal grid lines, specified as a 32-bit integer value.
Default value: 0
"horz-grid-line-pattern" property"horz-grid-line-pattern" GooCairoPattern : Read / Write
The cairo pattern to paint the horizontal grid lines with.
"horz-grid-line-pixbuf" property"horz-grid-line-pixbuf" GdkPixbuf : Write
The pixbuf to use to draw the horizontal grid lines.
"horz-grid-line-width" property"horz-grid-line-width" gdouble : Read / Write
The width of the horizontal grid lines.
Default value: -1
"show-horz-grid-lines" property"show-horz-grid-lines" gboolean : Read / Write
If the horizontal grid lines are shown.
Default value: TRUE
"show-vert-grid-lines" property"show-vert-grid-lines" gboolean : Read / Write
If the vertical grid lines are shown.
Default value: TRUE
"vert-grid-line-color" property"vert-grid-line-color" gchararray : Write
The color to use for the vertical grid lines.
Default value: NULL
"vert-grid-line-color-rgba" property"vert-grid-line-color-rgba" guint : Read / Write
The color to use for the vertical grid lines, specified as a 32-bit integer value.
Default value: 0
"vert-grid-line-pattern" property"vert-grid-line-pattern" GooCairoPattern : Read / Write
The cairo pattern to paint the vertical grid lines with.
"vert-grid-line-pixbuf" property"vert-grid-line-pixbuf" GdkPixbuf : Write
The pixbuf to use to draw the vertical grid lines.
"vert-grid-line-width" property"vert-grid-line-width" gdouble : Read / Write
The width of the vertical grid lines.
Default value: -1
"vert-grid-lines-on-top" property"vert-grid-lines-on-top" gboolean : Read / Write
If the vertical grid lines are painted above the horizontal grid lines.
Default value: FALSE
"width" property"width" gdouble : Read / Write
The width of the grid.
Allowed values: >= 0
Default value: 0
"x-offset" property"x-offset" gdouble : Read / Write
The distance before the first vertical grid line.
Allowed values: >= 0
Default value: 0
"x-step" property"x-step" gdouble : Read / Write
The distance between the vertical grid lines.
Allowed values: >= 0
Default value: 10
"y-offset" property"y-offset" gdouble : Read / Write
The distance before the first horizontal grid line.
Allowed values: >= 0
Default value: 0
"y-step" property"y-step" gdouble : Read / Write
The distance between the horizontal grid lines.
Allowed values: >= 0
Default value: 10