gtkmm 3.16.0

- Main Page
- Related Pages
- Modules
- Namespaces
- Classes

- Class List
- Class Index
- Class Hierarchy
- Class Members

Public Member Functions | Static Public Member Functions | Protected Member Functions | Related Functions | List of all members
Gdk::Cursor Class Reference

This represents a cursor. More...

`#include <gdkmm/cursor.h>`

Inheritance diagram for Gdk::Cursor:
[legend]

## Public Member Functions

virtual | ~Cursor ()
GdkCursor* | gobj ()
| Provides access to the underlying C GObject. More...
const GdkCursor* | gobj () const
| Provides access to the underlying C GObject. More...
GdkCursor* | gobj_copy ()
| Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. More...
Glib::RefPtr< Display > | get_display ()
| Returns the display on which the Gdk::Cursor is defined. More...
Glib::RefPtr< const Display > | get_display () const
| Returns the display on which the Gdk::Cursor is defined. More...
Glib::RefPtr< Gdk::Pixbuf > | get_image ()
| Returns a Gdk::Pixbuf with the image used to display the cursor. More...
Glib::RefPtr< const Gdk::Pixbuf > | get_image () const
| Returns a Gdk::Pixbuf with the image used to display the cursor. More...
Cairo::RefPtr< Cairo::Surface > | get_surface (double& x_hot, double& y_hot)
| Returns a cairo image surface with the image used to display the cursor. More...
Cairo::RefPtr< const Cairo::Surface > | get_surface (double& x_hot, double& y_hot) const
| Returns a cairo image surface with the image used to display the cursor. More...
CursorType | get_cursor_type () const
| Returns the cursor type for this cursor. More...
Public Member Functions inherited from Glib::Object
void * | get_data (const QueryQuark &key)
void | set_data (const Quark &key, void *data)
void | set_data (const Quark &key, void *data, DestroyNotify notify)
void | remove_data (const QueryQuark &quark)
void * | steal_data (const QueryQuark &quark)
Glib::RefPtr< Glib::Object > | wrap (GObject *object, bool take_copy=false)
Public Member Functions inherited from Glib::ObjectBase
void | set_property_value (const Glib::ustring &property_name, const Glib::ValueBase &value)
void | get_property_value (const Glib::ustring &property_name, Glib::ValueBase &value) const
void | set_property (const Glib::ustring &property_name, const PropertyType &value)
void | get_property (const Glib::ustring &property_name, PropertyType &value) const
void | connect_property_changed (const Glib::ustring &property_name, const sigc::slot< void > &slot)
sigc::connection | connect_property_changed_with_return (const Glib::ustring &property_name, const sigc::slot< void > &slot)
void | freeze_notify ()
void | thaw_notify ()
virtual void | reference () const
virtual void | unreference () const
GObject * | gobj ()
const GObject * | gobj () const
GObject * | gobj_copy () const

## Static Public Member Functions

static GType | get_type ()
| Get the GType for this class, for use with the underlying GObject type system. More...
static Glib::RefPtr< Cursor > | create (CursorType cursor_type)
| Creates a new cursor from the set of builtin cursors for the default display. More...
static Glib::RefPtr< Cursor > | create (const Glib::RefPtr< Display >& display, CursorType cursor_type)
| Creates a new cursor from the set of builtin cursors. More...
static Glib::RefPtr< Cursor > | create (const Glib::RefPtr< Display >& display, const Glib::RefPtr< Pixbuf >& pixbuf, int x, int y)
| Creates a new cursor from a pixbuf. More...
static Glib::RefPtr< Cursor > | create (const Glib::RefPtr< Display >& display, const ::Cairo::RefPtr< ::Cairo::Surface >& surface, double x, double y)
| Creates a new cursor from a cairo image surface. More...
static Glib::RefPtr< Cursor > | create (const Glib::RefPtr< Display >& display, const Glib::ustring& name)
| Creates a new cursor by looking up name in the current cursor theme. More...

## Protected Member Functions

| Cursor (const Glib::RefPtr< Display >& display, const Glib::ustring& name)
Protected Member Functions inherited from Glib::Object
| Object ()
| Object (const Glib::ConstructParams &construct_params)
| Object (GObject *castitem)
virtual | ~Object ()
Protected Member Functions inherited from Glib::ObjectBase
| ObjectBase ()
| ObjectBase (const char *custom_type_name)
| ObjectBase (const std::type_info &custom_type_info)
virtual | ~ObjectBase ()=0
void | initialize (GObject *castitem)

## Related Functions

(Note that these are not member functions.)
Glib::RefPtr< Gdk::Cursor > | wrap (GdkCursor* object, bool take_copy=false)
| A Glib::wrap() method for this object. More...

## Additional Inherited Members

Public Types inherited from Glib::Object
typedef void(* | DestroyNotify) (gpointer data)

## Detailed Description

This represents a cursor.

## Constructor & Destructor Documentation

virtual Gdk::Cursor::~Cursor | ( |  | ) |

virtual

Gdk::Cursor::Cursor | ( | const Glib::RefPtr< Display >& | display,
|  | const Glib::ustring & | name
| ) |  |

explicit protected

## Member Function Documentation

static Glib::RefPtr<Cursor> Gdk::Cursor::create | ( | CursorType | cursor_type | ) |

static

Creates a new cursor from the set of builtin cursors for the default display.

See new_for_display().

To make the cursor invisible, use Gdk::BLANK_CURSOR.

Deprecated: 3.16: Use new_for_display() instead.

Deprecated:
  Use the constructor that takes a Display instead.

Parameters

  cursor_type | Cursor to create.

Returns
  A new Gdk::Cursor.

static Glib::RefPtr<Cursor> Gdk::Cursor::create | ( | const Glib::RefPtr< Display >& | display,
|  | CursorType | cursor_type
| ) |  |

static

Creates a new cursor from the set of builtin cursors.

Some useful ones are:

- Gdk::RIGHT_PTR (right-facing arrow)
- Gdk::CROSSHAIR (crosshair)
- Gdk::XTERM (I-beam)
- Gdk::WATCH (busy)
- Gdk::FLEUR (for moving objects)
- Gdk::HAND1 (a right-pointing hand)
- Gdk::HAND2 (a left-pointing hand)
- Gdk::LEFT_SIDE (resize left side)
- Gdk::RIGHT_SIDE (resize right side)
- Gdk::TOP_LEFT_CORNER (resize northwest corner)
- Gdk::TOP_RIGHT_CORNER (resize northeast corner)
- Gdk::BOTTOM_LEFT_CORNER (resize southwest corner)
- Gdk::BOTTOM_RIGHT_CORNER (resize southeast corner)
- Gdk::TOP_SIDE (resize top side)
- Gdk::BOTTOM_SIDE (resize bottom side)
- Gdk::SB_H_DOUBLE_ARROW (move vertical splitter)
- Gdk::SB_V_DOUBLE_ARROW (move horizontal splitter)
- Gdk::BLANK_CURSOR (Blank cursor).
  Since gtkmm 2.16:

Since gtkmm 2.2:

Parameters

  display | The Gdk::Display for which the cursor will be created.
  cursor_type | Cursor to create.

Returns
  A new Gdk::Cursor.

static Glib::RefPtr<Cursor> Gdk::Cursor::create | ( | const Glib::RefPtr< Display >& | display,
|  | const Glib::RefPtr< Pixbuf >& | pixbuf,
|  | int | x,
|  | int | y
| ) |  |

static

Creates a new cursor from a pixbuf.

Not all GDK backends support RGBA cursors. If they are not supported, a monochrome approximation will be displayed. The functions Gdk::Display::supports_cursor_alpha() and Gdk::Display::supports_cursor_color() can be used to determine whether RGBA cursors are supported; Gdk::Display::get_default_cursor_size() and Gdk::Display::get_maximal_cursor_size() give information about cursor sizes.

If x or y are `-1`, the pixbuf must have options named “x_hot” and “y_hot”, resp., containing integer values between `0` and the width resp. height of the pixbuf. (Since: 3.0)

On the X backend, support for RGBA cursors requires a sufficently new version of the X Render extension.

Since gtkmm 2.4:

Parameters

  display | The Gdk::Display for which the cursor will be created.
  pixbuf | The Gdk::Pixbuf containing the cursor image.
  x | The horizontal offset of the “hotspot” of the cursor.
  y | The vertical offset of the “hotspot” of the cursor.

Returns
  A new Gdk::Cursor.

static Glib::RefPtr<Cursor> Gdk::Cursor::create | ( | const Glib::RefPtr< Display >& | display,
|  | const ::Cairo::RefPtr< ::Cairo::Surface > & | surface,
|  | double | x,
|  | double | y
| ) |  |

static

Creates a new cursor from a cairo image surface.

Not all GDK backends support RGBA cursors. If they are not supported, a monochrome approximation will be displayed. The functions Gdk::Display::supports_cursor_alpha() and Gdk::Display::supports_cursor_color() can be used to determine whether RGBA cursors are supported; Gdk::Display::get_default_cursor_size() and Gdk::Display::get_maximal_cursor_size() give information about cursor sizes.

On the X backend, support for RGBA cursors requires a sufficently new version of the X Render extension.

Since gtkmm 3.10:

Parameters

  display | The Gdk::Display for which the cursor will be created.
  surface | The cairo image surface containing the cursor pixel data.
  x | The horizontal offset of the “hotspot” of the cursor.
  y | The vertical offset of the “hotspot” of the cursor.

Returns
  A new Gdk::Cursor.

static Glib::RefPtr<Cursor> Gdk::Cursor::create | ( | const Glib::RefPtr< Display >& | display,
|  | const Glib::ustring & | name
| ) |  |

static

Creates a new cursor by looking up name in the current cursor theme.

Since gtkmm 2.8:

Parameters

  display | The Gdk::Display for which the cursor will be created.
  name | The name of the cursor.

Returns
  A new Gdk::Cursor, or `0` if there is no cursor with the given name.

CursorType Gdk::Cursor::get_cursor_type | ( |  | ) | const

Returns the cursor type for this cursor.

Since gtkmm 2.22:

Returns
  A Gdk::CursorType.

Glib::RefPtr<Display> Gdk::Cursor::get_display | ( |  | ) |

Returns the display on which the Gdk::Cursor is defined.

Since gtkmm 2.2:

Returns
  The Gdk::Display associated to cursor.

Glib::RefPtr<const Display> Gdk::Cursor::get_display | ( |  | ) | const

Returns the display on which the Gdk::Cursor is defined.

Since gtkmm 2.2:

Returns
  The Gdk::Display associated to cursor.

Glib::RefPtr<Gdk::Pixbuf> Gdk::Cursor::get_image | ( |  | ) |

Returns a Gdk::Pixbuf with the image used to display the cursor.

Note that depending on the capabilities of the windowing system and on the cursor, GDK may not be able to obtain the image data. In this case, `0` is returned.

Since gtkmm 2.8:

Returns
  A Gdk::Pixbuf representing cursor, or `0`.

Glib::RefPtr<const Gdk::Pixbuf> Gdk::Cursor::get_image | ( |  | ) | const

Returns a Gdk::Pixbuf with the image used to display the cursor.

Note that depending on the capabilities of the windowing system and on the cursor, GDK may not be able to obtain the image data. In this case, `0` is returned.

Since gtkmm 2.8:

Returns
  A Gdk::Pixbuf representing cursor, or `0`.

Cairo::RefPtr<Cairo::Surface> Gdk::Cursor::get_surface | ( | double & | x_hot,
|  | double & | y_hot
| ) |  |

Returns a cairo image surface with the image used to display the cursor.

Note that depending on the capabilities of the windowing system and on the cursor, GDK may not be able to obtain the image data. In this case, `0` is returned.

Since gtkmm 3.10:

Parameters

  x_hot | Location to store the hotspot x position, or `0`.
  y_hot | Location to store the hotspot y position, or `0`.

Returns
  A #cairo_surface_t representing cursor, or `0`.

Cairo::RefPtr<const Cairo::Surface> Gdk::Cursor::get_surface | ( | double & | x_hot,
|  | double & | y_hot
| ) |  | const

Returns a cairo image surface with the image used to display the cursor.

Note that depending on the capabilities of the windowing system and on the cursor, GDK may not be able to obtain the image data. In this case, `0` is returned.

Since gtkmm 3.10:

Parameters

  x_hot | Location to store the hotspot x position, or `0`.
  y_hot | Location to store the hotspot y position, or `0`.

Returns
  A #cairo_surface_t representing cursor, or `0`.

static GType Gdk::Cursor::get_type | ( |  | ) |

static

Get the GType for this class, for use with the underlying GObject type system.

GdkCursor* Gdk::Cursor::gobj | ( |  | ) |

inline

Provides access to the underlying C GObject.

const GdkCursor* Gdk::Cursor::gobj | ( |  | ) | const

inline

Provides access to the underlying C GObject.

GdkCursor* Gdk::Cursor::gobj_copy | ( |  | ) |

Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.

## Friends And Related Function Documentation

Glib::RefPtr< Gdk::Cursor > wrap | ( | GdkCursor * | object,
|  | bool | take_copy = `false`
| ) |  |

related

A Glib::wrap() method for this object.

Parameters

  object | The C instance.
  take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns
  A C++ instance that wraps this C instance.