GooCanvasWidget

GooCanvasWidget — an embedded widget item.

Properties

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

Types and Values

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):

1
2
3
4
5
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.

Flags: Read / Write

Default value: GOO_CANVAS_ANCHOR_NORTH_WEST


The “height” property

  “height”                   gdouble

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

Flags: Read / Write

Default value: -1


The “widget” property

  “widget”                   GtkWidget *

The widget to place in the canvas.

Flags: Read / Write


The “width” property

  “width”                    gdouble

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

Flags: Read / Write

Default value: -1


The “x” property

  “x”                        gdouble

The x coordinate of the widget.

Flags: Read / Write

Default value: 0


The “y” property

  “y”                        gdouble

The y coordinate of the widget.

Flags: Read / Write

Default value: 0