Gnome2::Canvas::Item(3) Base class for all canvas items

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'

COPYRIGHT

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

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