## GnomeDbCanvasItem

GnomeDbCanvasItem — Base class for all the GnomeCanvasItem derived widgets in libgnomedb.

##

# Synopsis

    struct      GnomeDbCanvasItem;
    GnomeDbCanvas* gnome_db_canvas_item_get_canvas
                                                (GnomeDbCanvasItem *item);
    GdaGraphItem* gnome_db_canvas_item_get_graph_item
                                                (GnomeDbCanvasItem *item);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GnomeCanvasItem
                         +----GnomeCanvasGroup
                               +----GnomeDbCanvasItem
                                     +----GnomeDbCanvasCursor
                                     +----GnomeDbCanvasEntity
                                     +----GnomeDbCanvasText
                                     +----GnomeDbCanvasFkconstraint
                                     +----GnomeDbCanvasJoin

## Properties

      "allow-drag"           gboolean             : Read / Write
      "allow-move"           gboolean             : Read / Write
      "graph-item"           gpointer             : Read / Write
      "tip-text"             gchararray           : Read / Write

## Signal Prototypes

    "drag-action"
                void        user_function      (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer arg1,
                                                gpointer arg2,
                                                gpointer user_data);
    "moved"     void        user_function      (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);
    "moving"    void        user_function      (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);
    "shifted"   void        user_function      (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);

## Description

This object adds some functionnalities on top of the GnomeCanvasItem objects such as synchronisation with a GdaGraphItem object (to have a persistent position on the canvas), the ability to be moved on the canvas, and the ability to initiate and report simple drag and drop within the canvas.

## Details

### struct GnomeDbCanvasItem

    struct GnomeDbCanvasItem;

### gnome_db_canvas_item_get_canvas ()

    GnomeDbCanvas* gnome_db_canvas_item_get_canvas
                                                (GnomeDbCanvasItem *item);

Get the GnomeDbCanvas on which `item` is drawn

`item` : | a GnomeDbCanvasItem object
Returns : | the GnomeDbCanvas widget

### gnome_db_canvas_item_get_graph_item ()

    GdaGraphItem* gnome_db_canvas_item_get_graph_item
                                                (GnomeDbCanvasItem *item);

Get the associated GdaGraphItem to `item`.

`item` : | a GnomeDbCanvasItem object
Returns : | the GdaGraphItem, or `NULL`

## Properties

"`allow-drag`" (gboolean : Read / Write) |
"`allow-move`" (gboolean : Read / Write) |
"`graph-item`" (gpointer : Read / Write) |
"`tip-text`" (gchararray : Read / Write) |

## Signals

### The "drag-action" signal

    void        user_function                  (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer arg1,
                                                gpointer arg2,
                                                gpointer user_data);

`dbcanvasitem` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.

### The "moved" signal

    void        user_function                  (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);

`dbcanvasitem` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The "moving" signal

    void        user_function                  (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);

`dbcanvasitem` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.

### The "shifted" signal

    void        user_function                  (GnomeDbCanvasItem *dbcanvasitem,
                                                gpointer user_data);

`dbcanvasitem` : | the object which received the signal.
`user_data` : | user data set when the signal handler was connected.