Top | ![]() |
![]() |
![]() |
![]() |
char * | border-color | Write |
GdkRGBA * | border-color-gdk-rgba | Read / Write |
guint | border-color-rgba | Read / Write |
GooCairoPattern * | border-pattern | Read / Write |
GdkPixbuf * | border-pixbuf | Write |
double | border-width | Read / Write |
double | height | Read / Write |
char * | horz-grid-line-color | Write |
GdkRGBA * | horz-grid-line-color-gdk-rgba | Read / Write |
guint | horz-grid-line-color-rgba | Read / Write |
GooCairoPattern * | horz-grid-line-pattern | Read / Write |
GdkPixbuf * | horz-grid-line-pixbuf | Write |
double | horz-grid-line-width | Read / Write |
gboolean | show-horz-grid-lines | Read / Write |
gboolean | show-vert-grid-lines | Read / Write |
char * | vert-grid-line-color | Write |
GdkRGBA * | vert-grid-line-color-gdk-rgba | Read / Write |
guint | vert-grid-line-color-rgba | Read / Write |
GooCairoPattern * | vert-grid-line-pattern | Read / Write |
GdkPixbuf * | vert-grid-line-pixbuf | Write |
double | vert-grid-line-width | Read / Write |
gboolean | vert-grid-lines-on-top | Read / Write |
double | width | Read / Write |
double | x | Read / Write |
double | x-offset | Read / Write |
double | x-step | Read / Write |
double | y | Read / Write |
double | y-offset | Read / Write |
double | y-step | Read / Write |
GooCanvasGridModel represents a model for grid items. A grid consists of a number of equally-spaced horizontal and vertical grid lines, plus an optional border.
It is a subclass of GooCanvasItemModelSimple and so inherits all of the style properties such as "stroke-color", "fill-color" and "line-width".
It also implements the GooCanvasItemModel interface, so you can use the
GooCanvasItemModel functions such as goo_canvas_item_model_raise()
and
goo_canvas_item_model_rotate()
.
To create a GooCanvasGridModel use goo_canvas_grid_model_new()
.
To get or set the properties of an existing GooCanvasGridModel, use
g_object_get()
and g_object_set()
.
To respond to events such as mouse clicks on the grid you must connect
to the signal handlers of the corresponding GooCanvasGrid objects.
(See goo_canvas_get_item()
and “item-created”.)
The grid's position and size is specified with the “x”, “y”, “width” and “height” properties.
The “x-step” and “y-step” properties specify the distance between grid lines. The “x-offset” and “y-offset” properties specify the distance before the first grid lines.
The horizontal or vertical grid lines can be hidden using the “show-horz-grid-lines” and “show-vert-grid-lines” properties.
The width of the border can be set using the “border-width” property. The border is drawn outside the area specified with the “x”, “y”, “width” and “height” properties.
Other properties allow the colors and widths of the grid lines to be set. The grid line color and width properties override the standard “stroke-color” and “line-width” properties, enabling different styles for horizontal and vertical grid lines.
GooCanvasItemModel * goo_canvas_grid_model_new (GooCanvasItemModel *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 model.
Here's an example showing how to create a grid:
1 2 3 4 5 6 7 8 9 10 |
GooCanvasItemModel *grid = goo_canvas_grid_model_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); |
parent |
the parent model, or |
[skip] |
x |
the x coordinate of the left of the grid. |
|
y |
the y coordinate of the top of the grid. |
|
width |
the width of the grid. |
|
height |
the height of the grid. |
|
x_step |
the distance between the vertical grid lines. |
|
y_step |
the distance between the horizontal grid lines. |
|
x_offset |
the distance before the first vertical grid line. |
|
y_offset |
the distance before the first horizontal grid line. |
|
... |
optional pairs of property names and values, and a terminating |
struct GooCanvasGridModel;
The GooCanvasGridModel struct contains private data only.
“border-color”
property “border-color” char *
The color to use for the border.
Owner: GooCanvasGridModel
Flags: Write
Default value: NULL
“border-color-gdk-rgba”
property “border-color-gdk-rgba” GdkRGBA *
The color to use for the border, specified as a GdkRGBA.
Owner: GooCanvasGridModel
Flags: Read / Write
“border-color-rgba”
property “border-color-rgba” guint
The color to use for the border, specified as a 32-bit integer value.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: 0
“border-pattern”
property“border-pattern” GooCairoPattern *
The cairo pattern to paint the border with.
Owner: GooCanvasGridModel
Flags: Read / Write
“border-pixbuf”
property “border-pixbuf” GdkPixbuf *
The pixbuf to use to draw the border.
Owner: GooCanvasGridModel
Flags: Write
“border-width”
property “border-width” double
The width of the border around the grid.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: -1
“height”
property “height” double
The height of the grid.
Owner: GooCanvasGridModel
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“horz-grid-line-color”
property “horz-grid-line-color” char *
The color to use for the horizontal grid lines.
Owner: GooCanvasGridModel
Flags: Write
Default value: NULL
“horz-grid-line-color-gdk-rgba”
property “horz-grid-line-color-gdk-rgba” GdkRGBA *
The color to use for the horizontal grid lines, specified as a GdkRGBA.
Owner: GooCanvasGridModel
Flags: Read / Write
“horz-grid-line-color-rgba”
property “horz-grid-line-color-rgba” guint
The color to use for the horizontal grid lines, specified as a 32-bit integer value.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: 0
“horz-grid-line-pattern”
property“horz-grid-line-pattern” GooCairoPattern *
The cairo pattern to paint the horizontal grid lines with.
Owner: GooCanvasGridModel
Flags: Read / Write
“horz-grid-line-pixbuf”
property “horz-grid-line-pixbuf” GdkPixbuf *
The pixbuf to use to draw the horizontal grid lines.
Owner: GooCanvasGridModel
Flags: Write
“horz-grid-line-width”
property “horz-grid-line-width” double
The width of the horizontal grid lines.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: -1
“show-horz-grid-lines”
property “show-horz-grid-lines” gboolean
If the horizontal grid lines are shown.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: TRUE
“show-vert-grid-lines”
property “show-vert-grid-lines” gboolean
If the vertical grid lines are shown.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: TRUE
“vert-grid-line-color”
property “vert-grid-line-color” char *
The color to use for the vertical grid lines.
Owner: GooCanvasGridModel
Flags: Write
Default value: NULL
“vert-grid-line-color-gdk-rgba”
property “vert-grid-line-color-gdk-rgba” GdkRGBA *
The color to use for the vertical grid lines, specified as a GdkRGBA.
Owner: GooCanvasGridModel
Flags: Read / Write
“vert-grid-line-color-rgba”
property “vert-grid-line-color-rgba” guint
The color to use for the vertical grid lines, specified as a 32-bit integer value.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: 0
“vert-grid-line-pattern”
property“vert-grid-line-pattern” GooCairoPattern *
The cairo pattern to paint the vertical grid lines with.
Owner: GooCanvasGridModel
Flags: Read / Write
“vert-grid-line-pixbuf”
property “vert-grid-line-pixbuf” GdkPixbuf *
The pixbuf to use to draw the vertical grid lines.
Owner: GooCanvasGridModel
Flags: Write
“vert-grid-line-width”
property “vert-grid-line-width” double
The width of the vertical grid lines.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: -1
“vert-grid-lines-on-top”
property “vert-grid-lines-on-top” gboolean
If the vertical grid lines are painted above the horizontal grid lines.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: FALSE
“width”
property “width” double
The width of the grid.
Owner: GooCanvasGridModel
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“x”
property “x” double
The x coordinate of the grid.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: 0
“x-offset”
property “x-offset” double
The distance before the first vertical grid line.
Owner: GooCanvasGridModel
Flags: Read / Write
Allowed values: >= 0
Default value: 0
“x-step”
property “x-step” double
The distance between the vertical grid lines.
Owner: GooCanvasGridModel
Flags: Read / Write
Allowed values: >= 0
Default value: 10
“y”
property “y” double
The y coordinate of the grid.
Owner: GooCanvasGridModel
Flags: Read / Write
Default value: 0
“y-offset”
property “y-offset” double
The distance before the first horizontal grid line.
Owner: GooCanvasGridModel
Flags: Read / Write
Allowed values: >= 0
Default value: 0