MgCanvasItem

MgCanvasItem — Base class for all the GnomeCanvasItem derived widgets in libmergeant.

Synopsis




            MgCanvasItem;
guint       mg_canvas_item_get_type         (void);
MgCanvas*   mg_canvas_item_get_canvas       (MgCanvasItem *item);
MgGraphItem* mg_canvas_item_get_graph_item  (MgCanvasItem *item);

Object Hierarchy


  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GnomeCanvasItem
                     +----GnomeCanvasGroup
                           +----MgCanvasItem
                                 +----MgCanvasCursor
                                 +----MgCanvasText
                                 +----MgCanvasEntity

Properties


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

Signals


"drag-action"
            void        user_function      (MgCanvasItem *mgcanvasitem,
                                            gpointer      arg1,
                                            gpointer      arg2,
                                            gpointer      user_data)         : Run first
"moved"     void        user_function      (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first
"moving"    void        user_function      (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first
"shifted"   void        user_function      (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first

Description

This object adds some functionnalities on top of the GnomeCanvasItem objects such as synchronisation with a MgGraphItem 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

MgCanvasItem

typedef struct _MgCanvasItem MgCanvasItem;


mg_canvas_item_get_type ()

guint       mg_canvas_item_get_type         (void);

Returns :

mg_canvas_item_get_canvas ()

MgCanvas*   mg_canvas_item_get_canvas       (MgCanvasItem *item);

Get the MgCanvas on which item is drawn

item : a MgCanvasItem object
Returns : the MgCanvas widget

mg_canvas_item_get_graph_item ()

MgGraphItem* mg_canvas_item_get_graph_item  (MgCanvasItem *item);

Get the associated MgGraphItem to item.

item : a MgCanvasItem object
Returns : the MgGraphItem, or NULL

Property Details

The "allow-drag" property

  "allow-drag"           gboolean              : Read / Write

Default value: FALSE


The "allow-move" property

  "allow-move"           gboolean              : Read / Write

Default value: TRUE


The "graph-item" property

  "graph-item"           gpointer              : Read / Write


The "tip-text" property

  "tip-text"             gchararray            : Read / Write

Default value: NULL

Signal Details

The "drag-action" signal

void        user_function                  (MgCanvasItem *mgcanvasitem,
                                            gpointer      arg1,
                                            gpointer      arg2,
                                            gpointer      user_data)         : Run first

mgcanvasitem : the object which received the signal.
arg1 : @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @: @:
user_data : user data set when the signal handler was connected.

The "moved" signal

void        user_function                  (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first

mgcanvasitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "moving" signal

void        user_function                  (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first

mgcanvasitem : the object which received the signal.
user_data : user data set when the signal handler was connected.

The "shifted" signal

void        user_function                  (MgCanvasItem *mgcanvasitem,
                                            gpointer      user_data)         : Run first

mgcanvasitem : the object which received the signal.
user_data : user data set when the signal handler was connected.