Gnome2::Canvas::Item(3)

NAME
Gnome2::Canvas::Item - wrapper for GnomeCanvasItem

HIERARCHY
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gnome2::Canvas::Item

METHODS

  item = Gnome2::Canvas::Item->new ($parent, $object_class, ...)

•   $parent (Gnome2::Canvas::Group)

•   $object_class (string)

•   ... (list) property name => value pairs

Factory constructor for Gnome2::Canvas::Item subclasses.

  $item->affine_absolute ($affine)

•   $affine (arrayref) affine transformation matrix

Replaces $item's transformation matrix.

  $item->affine_relative ($affine)

•   $affine (arrayref) affine transformation matrix

Combines $affine with $item's current transformation.

  (x1, y1, x2, y2) = $item->get_bounds

  $canvas = $item->canvas
Fetch the Gnome2::Canvas to which $item is attached.

  grabstatus = $item->grab ($event_mask, $cursor, $etime=GDK_CURRENT_TIME)

•   $event_mask (Gtk2::Gdk::EventMask)

•   $cursor (Gtk2::Gdk::Cursor)

•   $etime (unsigned)

  $item->grab_focus

  $item->hide

  $affine = $item->i2c_affine
Fetch the affine transform that converts from item-relative coordinates to canvas pixel coordinates.

Note: This method was completely broken for all $Gnome2::Canvas::VERSION < 1.002.

  (x, y) = $item->i2w ($x, $y)

•   $x (double)

•   $y (double)

  $affine = $item->i2w_affine
Fetch the affine transform that converts from item's coordinate system to world coordinates.

Note: This method was completely broken for all $Gnome2::Canvas::VERSION < 1.002.

  $item->lower ($positions)

•   $positions (integer)

  $item->lower_to_bottom

  $item->move ($dx, $dy)

•   $dx (double)

•   $dy (double)

  $canvasgroup = $item->parent
Fetch $item's parent group item.

  $item->raise ($positions)

•   $positions (integer)

  $item->raise_to_top

  $item->reparent ($new_group)

•   $new_group (Gnome2::Canvas::Group)

  $item->request_update

  $item->reset_bounds
Reset the bounding box of $item to an empty rectangle.

  $item->show

  $item->ungrab ($etime=GDK_CURRENT_TIME)

•   $etime (unsigned)

  $item->update_bbox ($x1, $y1, $x2, $y2)

•   $x1 (integer)

•   $y1 (integer)

•   $x2 (integer)

•   $y2 (integer)

Set $item's bounding box to a new rectangle, and request a full repaint.

  (x, y) = $item->w2i ($x, $y)

•   $x (double)

•   $y (double)

PROPERTIES

'parent' (Gnome2::Canvas::Item : default undef : readable / writable)

SIGNALS
boolean = event (Gnome2::Canvas::Item, Gtk2::Gdk::Event)

ENUMS AND FLAGS

  flags Gtk2::Gdk::EventMask

•   'exposure-mask' / 'GDK_EXPOSURE_MASK'

•   'pointer-motion-mask' / 'GDK_POINTER_MOTION_MASK'

•   'pointer-motion-hint-mask' / 'GDK_POINTER_MOTION_HINT_MASK'

•   'button-motion-mask' / 'GDK_BUTTON_MOTION_MASK'

•   'button1-motion-mask' / 'GDK_BUTTON1_MOTION_MASK'

•   'button2-motion-mask' / 'GDK_BUTTON2_MOTION_MASK'

•   'button3-motion-mask' / 'GDK_BUTTON3_MOTION_MASK'

•   'button-press-mask' / 'GDK_BUTTON_PRESS_MASK'

•   'button-release-mask' / 'GDK_BUTTON_RELEASE_MASK'

•   'key-press-mask' / 'GDK_KEY_PRESS_MASK'

•   'key-release-mask' / 'GDK_KEY_RELEASE_MASK'

•   'enter-notify-mask' / 'GDK_ENTER_NOTIFY_MASK'

•   'leave-notify-mask' / 'GDK_LEAVE_NOTIFY_MASK'

•   'focus-change-mask' / 'GDK_FOCUS_CHANGE_MASK'

•   'structure-mask' / 'GDK_STRUCTURE_MASK'

•   'property-change-mask' / 'GDK_PROPERTY_CHANGE_MASK'

•   'visibility-notify-mask' / 'GDK_VISIBILITY_NOTIFY_MASK'

•   'proximity-in-mask' / 'GDK_PROXIMITY_IN_MASK'

•   'proximity-out-mask' / 'GDK_PROXIMITY_OUT_MASK'

•   'substructure-mask' / 'GDK_SUBSTRUCTURE_MASK'

•   'scroll-mask' / 'GDK_SCROLL_MASK'

•   'all-events-mask' / 'GDK_ALL_EVENTS_MASK'

  enum Gtk2::Gdk::GrabStatus

•   'success' / 'GDK_GRAB_SUCCESS'

•   'already-grabbed' / 'GDK_GRAB_ALREADY_GRABBED'

•   'invalid-time' / 'GDK_GRAB_INVALID_TIME'

•   'not-viewable' / 'GDK_GRAB_NOT_VIEWABLE'

•   'frozen' / 'GDK_GRAB_FROZEN'

SEE ALSO
Gnome2::Canvas, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object

COPYRIGHT
Copyright (C) 2003-2004 by the Gtk2-Perl Team.

This software is licensed under the LGPL; see Gnome2::Canvas for a full notice.