---
name: "Gtk2::Gdk::Cursor"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::Gdk::Cursor"
---

# Gtk2::Gdk::Cursor(3pm)

wrapper for GdkCursor

## NAME

Gtk2::Gdk::Cursor - wrapper for GdkCursor

## DESCRIPTION

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'

## SEE ALSO

Gtk2, Glib::Boxed

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.