 |
 |
 |
GooCanvas Reference Manual |  |
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | ||||
Synopsis
GooCanvasEllipseModel; GooCanvasItemModel* goo_canvas_ellipse_model_new (GooCanvasItemModel *parent,gdouble center_x,gdouble center_y,gdouble radius_x,gdouble radius_y,...);
Properties
"center-x" gdouble : Read / Write "center-y" gdouble : Read / Write "height" gdouble : Read / Write "radius-x" gdouble : Read / Write "radius-y" gdouble : Read / Write "width" gdouble : Read / Write "x" gdouble : Read / Write "y" gdouble : Read / Write
Description
GooCanvasEllipseModel represents a model for ellipse items.
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 GooCanvasEllipseModel use goo_canvas_ellipse_model_new().
To get or set the properties of an existing GooCanvasEllipseModel, use
g_object_get() and g_object_set().
The ellipse can be specified either with the "center-x", "center-y", "radius-x" and "radius-y" properties, or with the "x", "y", "width" and "height" properties.
To respond to events such as mouse clicks on the ellipse you must connect
to the signal handlers of the corresponding GooCanvasEllipse objects.
(See goo_canvas_get_item() and "item-created".)
Details
GooCanvasEllipseModel
typedef struct _GooCanvasEllipseModel GooCanvasEllipseModel;
The GooCanvasEllipseModel struct contains private data only.
goo_canvas_ellipse_model_new ()
GooCanvasItemModel* goo_canvas_ellipse_model_new (GooCanvasItemModel *parent,gdouble center_x,gdouble center_y,gdouble radius_x,gdouble radius_y,...);
Creates a new ellipse model.
|
the parent model, 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 center of the ellipse. |
|
the y coordinate of the center of the ellipse. |
|
the horizontal radius of the ellipse. |
|
the vertical radius of the ellipse. |
|
optional pairs of property names and values, and a terminating NULL.
|
Returns : |
a new ellipse model. |
Here's an example showing how to create an ellipse centered at (100.0, 100.0), with a horizontal radius of 50.0 and a vertical radius of 30.0. It is drawn with a red outline with a width of 5.0 and filled with blue:
1 2 3 4 5 |
GooCanvasItemModel *ellipse = goo_canvas_ellipse_model_new (mygroup, 100.0, 100.0, 50.0, 30.0, "stroke-color", "red", "line-width", 5.0, "fill-color", "blue", NULL); |
Property Details
The "center-x" property
"center-x" gdouble : Read / Write
The x coordinate of the center of the ellipse.
Default value: 0
The "center-y" property
"center-y" gdouble : Read / Write
The y coordinate of the center of the ellipse.
Default value: 0
The "height" property
"height" gdouble : Read / Write
The height of the ellipse.
Allowed values: >= 0
Default value: 0
The "radius-x" property
"radius-x" gdouble : Read / Write
The horizontal radius of the ellipse.
Allowed values: >= 0
Default value: 0
The "radius-y" property
"radius-y" gdouble : Read / Write
The vertical radius of the ellipse.
Allowed values: >= 0
Default value: 0
The "width" property
"width" gdouble : Read / Write
The width of the ellipse.
Allowed values: >= 0
Default value: 0
The "x" property
"x" gdouble : Read / Write
The x coordinate of the left side of the ellipse.
Default value: 0