NAME¶

Gnome2::Canvas::Item - 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'

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.