GooCanvasWidget: GooCanvas Reference Manual

GooCanvasWidget

GooCanvasWidget — an embedded widget item.

Functions

Properties

GooCanvasAnchorType	anchor	Read / Write
double	height	Read / Write
GtkWidget *	widget	Read / Write
double	width	Read / Write
double	x	Read / Write
double	y	Read / Write

Types and Values

struct

GooCanvasWidget

Object Hierarchy

    GObject
    ╰── GooCanvasItemSimple
        ╰── GooCanvasWidget

Implemented Interfaces

GooCanvasWidget implements GooCanvasItem.

Description

GooCanvasWidget provides support for placing any GtkWidget in the canvas.

The “width” and “height” properties specify the widget's size. If either of them is -1, then the requested size of the widget is used instead, which is the default for both width and height.

Note that there are a number of limitations in the use of GooCanvasWidget:

It doesn't support any transformation besides simple translation. This means you can't scale a canvas with a GooCanvasWidget in it.
It doesn't support layering, so you can't place other items beneath or above the GooCanvasWidget.
It doesn't support rendering of widgets to a given cairo_t, which means you can't output the widget to a pdf or postscript file.
It doesn't have a model/view variant like the other standard items, so it can only be used in a simple canvas without a model.
It can't be made a static item.

Functions

goo_canvas_widget_new ()

GooCanvasItem *
goo_canvas_widget_new (GooCanvasItem *parent,
                       GtkWidget *widget,
                       gdouble x,
                       gdouble y,
                       gdouble width,
                       gdouble height,
                       ...);

Creates a new widget item.

Here's an example showing how to create an entry widget centered at (100.0, 100.0):

GtkWidget *entry = gtk_entry_new ();
GooCanvasItem *witem = goo_canvas_widget_new (mygroup, entry,
                                              100, 100, -1, -1,
                                              "anchor", GOO_CANVAS_ANCHOR_CENTER,
                                              NULL);

Parameters

parent	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.	[skip]
widget	the widget.
x	the x coordinate of the item.
y	the y coordinate of the item.
width	the width of the item, or -1 to use the widget's requested width.
height	the height of the item, or -1 to use the widget's requested height.
...	optional pairs of property names and values, and a terminating `NULL`.

Returns

a new widget item.

[transfer full]

Types and Values

struct GooCanvasWidget

struct GooCanvasWidget;

The GooCanvasWidget struct contains private data only.

Property Details

The `“anchor”` property

  “anchor”                   GooCanvasAnchorType

How to position the widget relative to the item's x and y coordinate settings.

Owner: GooCanvasWidget

Flags: Read / Write

Default value: GOO_CANVAS_ANCHOR_NORTH_WEST

The `“height”` property

  “height”                   double

The height of the widget, or -1 to use its requested height.

Owner: GooCanvasWidget

Flags: Read / Write

Default value: -1

The `“widget”` property

  “widget”                   GtkWidget *

The widget to place in the canvas.

Owner: GooCanvasWidget

Flags: Read / Write

The `“width”` property

  “width”                    double

The width of the widget, or -1 to use its requested width.

Owner: GooCanvasWidget

Flags: Read / Write

Default value: -1

The `“x”` property

  “x”                        double

The x coordinate of the widget.

Owner: GooCanvasWidget

Flags: Read / Write

Default value: 0

The `“y”` property

  “y”                        double

The y coordinate of the widget.

Owner: GooCanvasWidget

Flags: Read / Write

Default value: 0