Gtk2::Gdk::Cursor3pm

Wrapper for gdkcursor

Overview

For reference, cursors are a per-display resource and can only be used with the display they were created on.

As of Gtk 2.22 a cursor doesn't keep a reference to its "Gtk2::Gdk::Display" and if the display object is destroyed before the cursor then a later destroy of the cursor may get a segv. Perl-Gtk2 doesn't try to do anything about this. Care may be needed if keeping a cursor separate from a widget or window. (Closing the display is fine, but not destroying it.)

Hierarchy

  Glib::Boxed
  +----Gtk2::Gdk::Cursor

Methods

cursor = Gtk2::Gdk::Cursor->new ($cursor_type)

•: $cursor_type (Gtk2::Gdk::CursorType)

cursor = Gtk2::Gdk::Cursor->new_for_display ($display, $cursor_type)

`•`	`$display` (Gtk2::Gdk::Display)
`•`	`$cursor_type` (Gtk2::Gdk::CursorType)

Since: gtk+ 2.2

cursor = Gtk2::Gdk::Cursor->new_from_name ($display, $name)

`•`	`$display` (Gtk2::Gdk::Display)
`•`	`$name` (string)

Since: gtk+ 2.8

cursor = Gtk2::Gdk::Cursor->new_from_pixbuf ($display, $pixbuf, $x, $y)

`•`	`$display` (Gtk2::Gdk::Display)
`•`	`$pixbuf` (Gtk2::Gdk::Pixbuf)
`•`	`$x` (integer)
`•`	`$y` (integer)

Since: gtk+ 2.4

cursor = Gtk2::Gdk::Cursor->new_from_pixmap ($source, $mask, $fg, $bg, $x, $y)

`•`	`$source` (Gtk2::Gdk::Pixmap)
`•`	`$mask` (Gtk2::Gdk::Pixmap)
`•`	`$fg` (Gtk2::Gdk::Color)
`•`	`$bg` (Gtk2::Gdk::Color)
`•`	`$x` (integer)
`•`	`$y` (integer)

cursortype = $cursor->get_cursor_type

Since: gtk+ 2.22

display = $cursor->get_display

Since: gtk+ 2.2

pixbuf = $cursor->get_image

Since: gtk+ 2.8

cursortype = $cursor->type

Enums and flags

enum Gtk2::Gdk::CursorType

`•`	'x-cursor' / 'GDK_X_CURSOR'
`•`	'arrow' / 'GDK_ARROW'
`•`	'based-arrow-down' / 'GDK_BASED_ARROW_DOWN'
`•`	'based-arrow-up' / 'GDK_BASED_ARROW_UP'
`•`	'boat' / 'GDK_BOAT'
`•`	'bogosity' / 'GDK_BOGOSITY'
`•`	'bottom-left-corner' / 'GDK_BOTTOM_LEFT_CORNER'
`•`	'bottom-right-corner' / 'GDK_BOTTOM_RIGHT_CORNER'
`•`	'bottom-side' / 'GDK_BOTTOM_SIDE'
`•`	'bottom-tee' / 'GDK_BOTTOM_TEE'
`•`	'box-spiral' / 'GDK_BOX_SPIRAL'
`•`	'center-ptr' / 'GDK_CENTER_PTR'
`•`	'circle' / 'GDK_CIRCLE'
`•`	'clock' / 'GDK_CLOCK'
`•`	'coffee-mug' / 'GDK_COFFEE_MUG'
`•`	'cross' / 'GDK_CROSS'
`•`	'cross-reverse' / 'GDK_CROSS_REVERSE'
`•`	'crosshair' / 'GDK_CROSSHAIR'
`•`	'diamond-cross' / 'GDK_DIAMOND_CROSS'
`•`	'dot' / 'GDK_DOT'
`•`	'dotbox' / 'GDK_DOTBOX'
`•`	'double-arrow' / 'GDK_DOUBLE_ARROW'
`•`	'draft-large' / 'GDK_DRAFT_LARGE'
`•`	'draft-small' / 'GDK_DRAFT_SMALL'
`•`	'draped-box' / 'GDK_DRAPED_BOX'
`•`	'exchange' / 'GDK_EXCHANGE'
`•`	'fleur' / 'GDK_FLEUR'
`•`	'gobbler' / 'GDK_GOBBLER'
`•`	'gumby' / 'GDK_GUMBY'
`•`	'hand1' / 'GDK_HAND1'
`•`	'hand2' / 'GDK_HAND2'
`•`	'heart' / 'GDK_HEART'
`•`	'icon' / 'GDK_ICON'
`•`	'iron-cross' / 'GDK_IRON_CROSS'
`•`	'left-ptr' / 'GDK_LEFT_PTR'
`•`	'left-side' / 'GDK_LEFT_SIDE'
`•`	'left-tee' / 'GDK_LEFT_TEE'
`•`	'leftbutton' / 'GDK_LEFTBUTTON'
`•`	'll-angle' / 'GDK_LL_ANGLE'
`•`	'lr-angle' / 'GDK_LR_ANGLE'
`•`	'man' / 'GDK_MAN'
`•`	'middlebutton' / 'GDK_MIDDLEBUTTON'
`•`	'mouse' / 'GDK_MOUSE'
`•`	'pencil' / 'GDK_PENCIL'
`•`	'pirate' / 'GDK_PIRATE'
`•`	'plus' / 'GDK_PLUS'
`•`	'question-arrow' / 'GDK_QUESTION_ARROW'
`•`	'right-ptr' / 'GDK_RIGHT_PTR'
`•`	'right-side' / 'GDK_RIGHT_SIDE'
`•`	'right-tee' / 'GDK_RIGHT_TEE'
`•`	'rightbutton' / 'GDK_RIGHTBUTTON'
`•`	'rtl-logo' / 'GDK_RTL_LOGO'
`•`	'sailboat' / 'GDK_SAILBOAT'
`•`	'sb-down-arrow' / 'GDK_SB_DOWN_ARROW'
`•`	'sb-h-double-arrow' / 'GDK_SB_H_DOUBLE_ARROW'
`•`	'sb-left-arrow' / 'GDK_SB_LEFT_ARROW'
`•`	'sb-right-arrow' / 'GDK_SB_RIGHT_ARROW'
`•`	'sb-up-arrow' / 'GDK_SB_UP_ARROW'
`•`	'sb-v-double-arrow' / 'GDK_SB_V_DOUBLE_ARROW'
`•`	'shuttle' / 'GDK_SHUTTLE'
`•`	'sizing' / 'GDK_SIZING'
`•`	'spider' / 'GDK_SPIDER'
`•`	'spraycan' / 'GDK_SPRAYCAN'
`•`	'star' / 'GDK_STAR'
`•`	'target' / 'GDK_TARGET'
`•`	'tcross' / 'GDK_TCROSS'
`•`	'top-left-arrow' / 'GDK_TOP_LEFT_ARROW'
`•`	'top-left-corner' / 'GDK_TOP_LEFT_CORNER'
`•`	'top-right-corner' / 'GDK_TOP_RIGHT_CORNER'
`•`	'top-side' / 'GDK_TOP_SIDE'
`•`	'top-tee' / 'GDK_TOP_TEE'
`•`	'trek' / 'GDK_TREK'
`•`	'ul-angle' / 'GDK_UL_ANGLE'
`•`	'umbrella' / 'GDK_UMBRELLA'
`•`	'ur-angle' / 'GDK_UR_ANGLE'
`•`	'watch' / 'GDK_WATCH'
`•`	'xterm' / 'GDK_XTERM'
`•`	'last-cursor' / 'GDK_LAST_CURSOR'
`•`	'blank-cursor' / 'GDK_BLANK_CURSOR'
`•`	'cursor-is-pixmap' / 'GDK_CURSOR_IS_PIXMAP'

Releases

7 releases since Debian 3.1 (Sarge); the text changed 6 times.