Constructor

GdkCursornew_from_name

since: 2.8

Declaration [src]

GdkCursor*
gdk_cursor_new_from_name (
  GdkDisplay* display,
  const gchar* name
)

Description [src]

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

A recommended set of cursor names that will work across different platforms can be found in the CSS specification: - “none” - “default” - “help” - “pointer” - “context-menu” - “progress” - “wait” - “cell” - “crosshair” - “text” - “vertical-text” - “alias” - “copy” - “no-drop” - “move” - “not-allowed” - “grab” - “grabbing” - “all-scroll” - “col-resize” - “row-resize” - “n-resize” - “e-resize” - “s-resize” - “w-resize” - “ne-resize” - “nw-resize” - “sw-resize” - “se-resize” - “ew-resize” - “ns-resize” - “nesw-resize” - “nwse-resize” - “zoom-in” -  “zoom-out”

Available since: 2.8

Parameters

display

Type: GdkDisplay

The GdkDisplay for which the cursor will be created.

The data is owned by the caller of the function.
name

Type: const gchar*

The name of the cursor.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: GdkCursor

A new GdkCursor, or NULL if there is no cursor with the given name.

The caller of the function takes ownership of the data, and is responsible for freeing it.
The return value can be NULL.