|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gdk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Cursors</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GDK Reference Manual">
<link rel="up" href="reference.html" title="API Reference">
<link rel="prev" href="gdk-Fonts.html" title="Fonts">
<link rel="next" href="gdk-Windows.html" title="Windows">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="reference" href="reference.html" title="API Reference">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="gdk-Fonts.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GDK Reference Manual</th>
<td><a accesskey="n" href="gdk-Windows.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3011803" class="shortcut">Top</a>
 | 
<a href="#id3012120" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="gdk-Cursors"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id3011803"></a><span class="refentrytitle">Cursors</span>
</h2>
<p>Cursors — Standard and pixmap cursors</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
#include <gdk/gdk.h>
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>;
enum <a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a>;
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-new">gdk_cursor_new</a> (<a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a> cursor_type);
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-new-from-pixmap">gdk_cursor_new_from_pixmap</a> (<a href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap">GdkPixmap</a> *source,
<a href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap">GdkPixmap</a> *mask,
const <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *fg,
const <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *bg,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-new-from-pixbuf">gdk_cursor_new_from_pixbuf</a> (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-new-from-name">gdk_cursor_new_from_name</a> (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-new-for-display">gdk_cursor_new_for_display</a> (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
<a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a> cursor_type);
<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a>* <a href="gdk-Cursors.html#gdk-cursor-get-display">gdk_cursor_get_display</a> (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* <a href="gdk-Cursors.html#gdk-cursor-get-image">gdk_cursor_get_image</a> (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);
<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* <a href="gdk-Cursors.html#gdk-cursor-ref">gdk_cursor_ref</a> (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);
void <a href="gdk-Cursors.html#gdk-cursor-unref">gdk_cursor_unref</a> (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);
#define <a href="gdk-Cursors.html#gdk-cursor-destroy">gdk_cursor_destroy</a>
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id3012120"></a><h2>Description</h2>
<p>
These functions are used to create and destroy cursors.
There is a number of standard cursors, but it is also
possible to construct new cursors from pixmaps and
pixbufs. There may be limitations as to what kinds of
cursors can be constructed on a given display, see
<a href="GdkDisplay.html#gdk-display-supports-cursor-alpha"><code class="function">gdk_display_supports_cursor_alpha()</code></a>,
<a href="GdkDisplay.html#gdk-display-supports-cursor-color"><code class="function">gdk_display_supports_cursor_color()</code></a>,
<a href="GdkDisplay.html#gdk-display-get-default-cursor-size"><code class="function">gdk_display_get_default_cursor_size()</code></a> and
<a href="GdkDisplay.html#gdk-display-get-maximal-cursor-size"><code class="function">gdk_display_get_maximal_cursor_size()</code></a>.
</p>
<p>
Cursors by themselves are not very interesting, they must be be
bound to a window for users to see them. This is done with
<a href="gdk-Windows.html#gdk-window-set-cursor"><code class="function">gdk_window_set_cursor()</code></a> or by setting the cursor member of the
<a href="gdk-Windows.html#GdkWindowAttr"><span class="type">GdkWindowAttr</span></a> struct passed to <a href="gdk-Windows.html#gdk-window-new"><code class="function">gdk_window_new()</code></a>.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id3012224"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id3012234"></a><h3>
<a name="GdkCursor"></a>GdkCursor</h3>
<a class="indexterm" name="id3012247"></a><pre class="programlisting">typedef struct {
GdkCursorType type;
} GdkCursor;
</pre>
<p>
A <span class="type">GdkCursor</span> structure represents a cursor.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a> <em class="structfield"><code>type</code></em>;</span></td>
<td>the <a href="gdk-Cursors.html#GdkCursorType"><span class="type">GdkCursorType</span></a> of the cursor
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3012300"></a><h3>
<a name="GdkCursorType"></a>enum GdkCursorType</h3>
<a class="indexterm" name="id3012313"></a><pre class="programlisting">typedef enum
{
GDK_X_CURSOR = 0,
GDK_ARROW = 2,
GDK_BASED_ARROW_DOWN = 4,
GDK_BASED_ARROW_UP = 6,
GDK_BOAT = 8,
GDK_BOGOSITY = 10,
GDK_BOTTOM_LEFT_CORNER = 12,
GDK_BOTTOM_RIGHT_CORNER = 14,
GDK_BOTTOM_SIDE = 16,
GDK_BOTTOM_TEE = 18,
GDK_BOX_SPIRAL = 20,
GDK_CENTER_PTR = 22,
GDK_CIRCLE = 24,
GDK_CLOCK = 26,
GDK_COFFEE_MUG = 28,
GDK_CROSS = 30,
GDK_CROSS_REVERSE = 32,
GDK_CROSSHAIR = 34,
GDK_DIAMOND_CROSS = 36,
GDK_DOT = 38,
GDK_DOTBOX = 40,
GDK_DOUBLE_ARROW = 42,
GDK_DRAFT_LARGE = 44,
GDK_DRAFT_SMALL = 46,
GDK_DRAPED_BOX = 48,
GDK_EXCHANGE = 50,
GDK_FLEUR = 52,
GDK_GOBBLER = 54,
GDK_GUMBY = 56,
GDK_HAND1 = 58,
GDK_HAND2 = 60,
GDK_HEART = 62,
GDK_ICON = 64,
GDK_IRON_CROSS = 66,
GDK_LEFT_PTR = 68,
GDK_LEFT_SIDE = 70,
GDK_LEFT_TEE = 72,
GDK_LEFTBUTTON = 74,
GDK_LL_ANGLE = 76,
GDK_LR_ANGLE = 78,
GDK_MAN = 80,
GDK_MIDDLEBUTTON = 82,
GDK_MOUSE = 84,
GDK_PENCIL = 86,
GDK_PIRATE = 88,
GDK_PLUS = 90,
GDK_QUESTION_ARROW = 92,
GDK_RIGHT_PTR = 94,
GDK_RIGHT_SIDE = 96,
GDK_RIGHT_TEE = 98,
GDK_RIGHTBUTTON = 100,
GDK_RTL_LOGO = 102,
GDK_SAILBOAT = 104,
GDK_SB_DOWN_ARROW = 106,
GDK_SB_H_DOUBLE_ARROW = 108,
GDK_SB_LEFT_ARROW = 110,
GDK_SB_RIGHT_ARROW = 112,
GDK_SB_UP_ARROW = 114,
GDK_SB_V_DOUBLE_ARROW = 116,
GDK_SHUTTLE = 118,
GDK_SIZING = 120,
GDK_SPIDER = 122,
GDK_SPRAYCAN = 124,
GDK_STAR = 126,
GDK_TARGET = 128,
GDK_TCROSS = 130,
GDK_TOP_LEFT_ARROW = 132,
GDK_TOP_LEFT_CORNER = 134,
GDK_TOP_RIGHT_CORNER = 136,
GDK_TOP_SIDE = 138,
GDK_TOP_TEE = 140,
GDK_TREK = 142,
GDK_UL_ANGLE = 144,
GDK_UMBRELLA = 146,
GDK_UR_ANGLE = 148,
GDK_WATCH = 150,
GDK_XTERM = 152,
GDK_LAST_CURSOR,
GDK_CURSOR_IS_PIXMAP = -1
} GdkCursorType;
</pre>
<p>
The standard cursors available.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><a name="GDK-X-CURSOR:CAPS"></a><code class="literal">GDK_X_CURSOR</code></span></td>
<td>
<img src="X_cursor.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-ARROW:CAPS"></a><code class="literal">GDK_ARROW</code></span></td>
<td>
<img src="arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BASED-ARROW-DOWN:CAPS"></a><code class="literal">GDK_BASED_ARROW_DOWN</code></span></td>
<td>
<img src="based_arrow_down.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BASED-ARROW-UP:CAPS"></a><code class="literal">GDK_BASED_ARROW_UP</code></span></td>
<td>
<img src="based_arrow_up.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOAT:CAPS"></a><code class="literal">GDK_BOAT</code></span></td>
<td>
<img src="boat.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOGOSITY:CAPS"></a><code class="literal">GDK_BOGOSITY</code></span></td>
<td>
<img src="bogosity.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOTTOM-LEFT-CORNER:CAPS"></a><code class="literal">GDK_BOTTOM_LEFT_CORNER</code></span></td>
<td>
<img src="bottom_left_corner.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOTTOM-RIGHT-CORNER:CAPS"></a><code class="literal">GDK_BOTTOM_RIGHT_CORNER</code></span></td>
<td>
<img src="bottom_right_corner.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOTTOM-SIDE:CAPS"></a><code class="literal">GDK_BOTTOM_SIDE</code></span></td>
<td>
<img src="bottom_side.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOTTOM-TEE:CAPS"></a><code class="literal">GDK_BOTTOM_TEE</code></span></td>
<td>
<img src="bottom_tee.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-BOX-SPIRAL:CAPS"></a><code class="literal">GDK_BOX_SPIRAL</code></span></td>
<td>
<img src="box_spiral.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CENTER-PTR:CAPS"></a><code class="literal">GDK_CENTER_PTR</code></span></td>
<td>
<img src="center_ptr.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CIRCLE:CAPS"></a><code class="literal">GDK_CIRCLE</code></span></td>
<td>
<img src="circle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CLOCK:CAPS"></a><code class="literal">GDK_CLOCK</code></span></td>
<td>
<img src="clock.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-COFFEE-MUG:CAPS"></a><code class="literal">GDK_COFFEE_MUG</code></span></td>
<td>
<img src="coffee_mug.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CROSS:CAPS"></a><code class="literal">GDK_CROSS</code></span></td>
<td>
<img src="cross.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CROSS-REVERSE:CAPS"></a><code class="literal">GDK_CROSS_REVERSE</code></span></td>
<td>
<img src="cross_reverse.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CROSSHAIR:CAPS"></a><code class="literal">GDK_CROSSHAIR</code></span></td>
<td>
<img src="crosshair.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DIAMOND-CROSS:CAPS"></a><code class="literal">GDK_DIAMOND_CROSS</code></span></td>
<td>
<img src="diamond_cross.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DOT:CAPS"></a><code class="literal">GDK_DOT</code></span></td>
<td>
<img src="dot.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DOTBOX:CAPS"></a><code class="literal">GDK_DOTBOX</code></span></td>
<td>
<img src="dotbox.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DOUBLE-ARROW:CAPS"></a><code class="literal">GDK_DOUBLE_ARROW</code></span></td>
<td>
<img src="double_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DRAFT-LARGE:CAPS"></a><code class="literal">GDK_DRAFT_LARGE</code></span></td>
<td>
<img src="draft_large.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DRAFT-SMALL:CAPS"></a><code class="literal">GDK_DRAFT_SMALL</code></span></td>
<td>
<img src="draft_small.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-DRAPED-BOX:CAPS"></a><code class="literal">GDK_DRAPED_BOX</code></span></td>
<td>
<img src="draped_box.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-EXCHANGE:CAPS"></a><code class="literal">GDK_EXCHANGE</code></span></td>
<td>
<img src="exchange.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-FLEUR:CAPS"></a><code class="literal">GDK_FLEUR</code></span></td>
<td>
<img src="fleur.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-GOBBLER:CAPS"></a><code class="literal">GDK_GOBBLER</code></span></td>
<td>
<img src="gobbler.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-GUMBY:CAPS"></a><code class="literal">GDK_GUMBY</code></span></td>
<td>
<img src="gumby.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-HAND1:CAPS"></a><code class="literal">GDK_HAND1</code></span></td>
<td>
<img src="hand1.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-HAND2:CAPS"></a><code class="literal">GDK_HAND2</code></span></td>
<td>
<img src="hand2.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-HEART:CAPS"></a><code class="literal">GDK_HEART</code></span></td>
<td>
<img src="heart.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-ICON:CAPS"></a><code class="literal">GDK_ICON</code></span></td>
<td>
<img src="icon.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-IRON-CROSS:CAPS"></a><code class="literal">GDK_IRON_CROSS</code></span></td>
<td>
<img src="iron_cross.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LEFT-PTR:CAPS"></a><code class="literal">GDK_LEFT_PTR</code></span></td>
<td>
<img src="left_ptr.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LEFT-SIDE:CAPS"></a><code class="literal">GDK_LEFT_SIDE</code></span></td>
<td>
<img src="left_side.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LEFT-TEE:CAPS"></a><code class="literal">GDK_LEFT_TEE</code></span></td>
<td>
<img src="left_tee.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LEFTBUTTON:CAPS"></a><code class="literal">GDK_LEFTBUTTON</code></span></td>
<td>
<img src="leftbutton.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LL-ANGLE:CAPS"></a><code class="literal">GDK_LL_ANGLE</code></span></td>
<td>
<img src="ll_angle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LR-ANGLE:CAPS"></a><code class="literal">GDK_LR_ANGLE</code></span></td>
<td>
<img src="lr_angle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-MAN:CAPS"></a><code class="literal">GDK_MAN</code></span></td>
<td>
<img src="man.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-MIDDLEBUTTON:CAPS"></a><code class="literal">GDK_MIDDLEBUTTON</code></span></td>
<td>
<img src="middlebutton.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-MOUSE:CAPS"></a><code class="literal">GDK_MOUSE</code></span></td>
<td>
<img src="mouse.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-PENCIL:CAPS"></a><code class="literal">GDK_PENCIL</code></span></td>
<td>
<img src="pencil.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-PIRATE:CAPS"></a><code class="literal">GDK_PIRATE</code></span></td>
<td>
<img src="pirate.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-PLUS:CAPS"></a><code class="literal">GDK_PLUS</code></span></td>
<td>
<img src="plus.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-QUESTION-ARROW:CAPS"></a><code class="literal">GDK_QUESTION_ARROW</code></span></td>
<td>
<img src="question_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-RIGHT-PTR:CAPS"></a><code class="literal">GDK_RIGHT_PTR</code></span></td>
<td>
<img src="right_ptr.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-RIGHT-SIDE:CAPS"></a><code class="literal">GDK_RIGHT_SIDE</code></span></td>
<td>
<img src="right_side.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-RIGHT-TEE:CAPS"></a><code class="literal">GDK_RIGHT_TEE</code></span></td>
<td>
<img src="right_tee.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-RIGHTBUTTON:CAPS"></a><code class="literal">GDK_RIGHTBUTTON</code></span></td>
<td>
<img src="rightbutton.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-RTL-LOGO:CAPS"></a><code class="literal">GDK_RTL_LOGO</code></span></td>
<td>
<img src="rtl_logo.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SAILBOAT:CAPS"></a><code class="literal">GDK_SAILBOAT</code></span></td>
<td>
<img src="sailboat.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-DOWN-ARROW:CAPS"></a><code class="literal">GDK_SB_DOWN_ARROW</code></span></td>
<td>
<img src="sb_down_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-H-DOUBLE-ARROW:CAPS"></a><code class="literal">GDK_SB_H_DOUBLE_ARROW</code></span></td>
<td>
<img src="sb_h_double_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-LEFT-ARROW:CAPS"></a><code class="literal">GDK_SB_LEFT_ARROW</code></span></td>
<td>
<img src="sb_left_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-RIGHT-ARROW:CAPS"></a><code class="literal">GDK_SB_RIGHT_ARROW</code></span></td>
<td>
<img src="sb_right_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-UP-ARROW:CAPS"></a><code class="literal">GDK_SB_UP_ARROW</code></span></td>
<td>
<img src="sb_up_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SB-V-DOUBLE-ARROW:CAPS"></a><code class="literal">GDK_SB_V_DOUBLE_ARROW</code></span></td>
<td>
<img src="sb_v_double_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SHUTTLE:CAPS"></a><code class="literal">GDK_SHUTTLE</code></span></td>
<td>
<img src="shuttle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SIZING:CAPS"></a><code class="literal">GDK_SIZING</code></span></td>
<td>
<img src="sizing.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SPIDER:CAPS"></a><code class="literal">GDK_SPIDER</code></span></td>
<td>
<img src="spider.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-SPRAYCAN:CAPS"></a><code class="literal">GDK_SPRAYCAN</code></span></td>
<td>
<img src="spraycan.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-STAR:CAPS"></a><code class="literal">GDK_STAR</code></span></td>
<td>
<img src="star.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TARGET:CAPS"></a><code class="literal">GDK_TARGET</code></span></td>
<td>
<img src="target.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TCROSS:CAPS"></a><code class="literal">GDK_TCROSS</code></span></td>
<td>
<img src="tcross.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TOP-LEFT-ARROW:CAPS"></a><code class="literal">GDK_TOP_LEFT_ARROW</code></span></td>
<td>
<img src="top_left_arrow.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TOP-LEFT-CORNER:CAPS"></a><code class="literal">GDK_TOP_LEFT_CORNER</code></span></td>
<td>
<img src="top_left_corner.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TOP-RIGHT-CORNER:CAPS"></a><code class="literal">GDK_TOP_RIGHT_CORNER</code></span></td>
<td>
<img src="top_right_corner.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TOP-SIDE:CAPS"></a><code class="literal">GDK_TOP_SIDE</code></span></td>
<td>
<img src="top_side.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TOP-TEE:CAPS"></a><code class="literal">GDK_TOP_TEE</code></span></td>
<td>
<img src="top_tee.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-TREK:CAPS"></a><code class="literal">GDK_TREK</code></span></td>
<td>
<img src="trek.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-UL-ANGLE:CAPS"></a><code class="literal">GDK_UL_ANGLE</code></span></td>
<td>
<img src="ul_angle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-UMBRELLA:CAPS"></a><code class="literal">GDK_UMBRELLA</code></span></td>
<td>
<img src="umbrella.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-UR-ANGLE:CAPS"></a><code class="literal">GDK_UR_ANGLE</code></span></td>
<td>
<img src="ur_angle.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-WATCH:CAPS"></a><code class="literal">GDK_WATCH</code></span></td>
<td>
<img src="watch.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-XTERM:CAPS"></a><code class="literal">GDK_XTERM</code></span></td>
<td>
<img src="xterm.png">
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-LAST-CURSOR:CAPS"></a><code class="literal">GDK_LAST_CURSOR</code></span></td>
<td>last cursor type
</td>
</tr>
<tr>
<td>
<span class="term"><a name="GDK-CURSOR-IS-PIXMAP:CAPS"></a><code class="literal">GDK_CURSOR_IS_PIXMAP</code></span></td>
<td>type of cursors constructed with
<a href="gdk-Cursors.html#gdk-cursor-new-from-pixmap"><code class="function">gdk_cursor_new_from_pixmap()</code></a> or <a href="gdk-Cursors.html#gdk-cursor-new-from-pixbuf"><code class="function">gdk_cursor_new_from_pixbuf()</code></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3014538"></a><h3>
<a name="gdk-cursor-new"></a>gdk_cursor_new ()</h3>
<a class="indexterm" name="id3014550"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_new (<a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a> cursor_type);</pre>
<p>
Creates a new cursor from the set of builtin cursors for the default display.
See <a href="gdk-Cursors.html#gdk-cursor-new-for-display"><code class="function">gdk_cursor_new_for_display()</code></a>.
</p>
<p>
To make the cursor invisible, use <a href="gdk-Cursors.html#gdk-cursor-new-from-pixmap"><code class="function">gdk_cursor_new_from_pixmap()</code></a> to create
a cursor with no pixels in it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cursor_type</code></em> :</span></td>
<td> cursor to create
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3014647"></a><h3>
<a name="gdk-cursor-new-from-pixmap"></a>gdk_cursor_new_from_pixmap ()</h3>
<a class="indexterm" name="id3014660"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_new_from_pixmap (<a href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap">GdkPixmap</a> *source,
<a href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap">GdkPixmap</a> *mask,
const <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *fg,
const <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> *bg,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<p>
Creates a new cursor from a given pixmap and mask. Both the pixmap and mask
must have a depth of 1 (i.e. each pixel has only 2 values - on or off).
The standard cursor size is 16 by 16 pixels. You can create a bitmap
from inline data as in the below example.
</p>
<p>
</p>
<div class="example">
<a name="id3014733"></a><p class="title"><b>Example 6. Creating a custom cursor</b></p>
<pre class="programlisting">
/* This data is in X bitmap format, and can be created with the 'bitmap'
utility. */
#define cursor1_width 16
#define cursor1_height 16
static unsigned char cursor1_bits[] = {
0x80, 0x01, 0x40, 0x02, 0x20, 0x04, 0x10, 0x08, 0x08, 0x10, 0x04, 0x20,
0x82, 0x41, 0x41, 0x82, 0x41, 0x82, 0x82, 0x41, 0x04, 0x20, 0x08, 0x10,
0x10, 0x08, 0x20, 0x04, 0x40, 0x02, 0x80, 0x01};
static unsigned char cursor1mask_bits[] = {
0x80, 0x01, 0xc0, 0x03, 0x60, 0x06, 0x30, 0x0c, 0x18, 0x18, 0x8c, 0x31,
0xc6, 0x63, 0x63, 0xc6, 0x63, 0xc6, 0xc6, 0x63, 0x8c, 0x31, 0x18, 0x18,
0x30, 0x0c, 0x60, 0x06, 0xc0, 0x03, 0x80, 0x01};
GdkCursor *cursor;
GdkPixmap *source, *mask;
GdkColor fg = { 0, 65535, 0, 0 }; /* Red. */
GdkColor bg = { 0, 0, 0, 65535 }; /* Blue. */
source = gdk_bitmap_create_from_data (NULL, cursor1_bits,
cursor1_width, cursor1_height);
mask = gdk_bitmap_create_from_data (NULL, cursor1mask_bits,
cursor1_width, cursor1_height);
cursor = gdk_cursor_new_from_pixmap (source, mask, &fg, &bg, 8, 8);
gdk_pixmap_unref (source);
gdk_pixmap_unref (mask);
gdk_window_set_cursor (widget->window, cursor);
</pre>
</div>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>source</code></em> :</span></td>
<td> the pixmap specifying the cursor.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>mask</code></em> :</span></td>
<td> the pixmap specifying the mask, which must be the same size as
<em class="parameter"><code>source</code></em>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>fg</code></em> :</span></td>
<td> the foreground color, used for the bits in the source which are 1.
The color does not have to be allocated first.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>bg</code></em> :</span></td>
<td> the background color, used for the bits in the source which are 0.
The color does not have to be allocated first.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the horizontal offset of the 'hotspot' of the cursor.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the vertical offset of the 'hotspot' of the cursor.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3014903"></a><h3>
<a name="gdk-cursor-new-from-pixbuf"></a>gdk_cursor_new_from_pixbuf ()</h3>
<a class="indexterm" name="id3014919"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_new_from_pixbuf (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
<a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a> *pixbuf,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> x,
<a
href="../glib/glib-Basic-Types.html#gint"
>gint</a> y);</pre>
<p>
Creates a new cursor from a pixbuf.
</p>
<p>
Not all GDK backends support RGBA cursors. If they are not
supported, a monochrome approximation will be displayed.
The functions <a href="GdkDisplay.html#gdk-display-supports-cursor-alpha"><code class="function">gdk_display_supports_cursor_alpha()</code></a> and
<a href="GdkDisplay.html#gdk-display-supports-cursor-color"><code class="function">gdk_display_supports_cursor_color()</code></a> can be used to determine
whether RGBA cursors are supported;
<a href="GdkDisplay.html#gdk-display-get-default-cursor-size"><code class="function">gdk_display_get_default_cursor_size()</code></a> and
<a href="GdkDisplay.html#gdk-display-get-maximal-cursor-size"><code class="function">gdk_display_get_maximal_cursor_size()</code></a> give information about
cursor sizes.
</p>
<p>
On the X backend, support for RGBA cursors requires a
sufficently new version of the X Render extension.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
<td> the <a href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> for which the cursor will be created
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></td>
<td> the <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> containing the cursor image
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>x</code></em> :</span></td>
<td> the horizontal offset of the 'hotspot' of the cursor.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>y</code></em> :</span></td>
<td> the vertical offset of the 'hotspot' of the cursor.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>.
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.4
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3015132"></a><h3>
<a name="gdk-cursor-new-from-name"></a>gdk_cursor_new_from_name ()</h3>
<a class="indexterm" name="id3015148"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_new_from_name (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
const <a
href="../glib/glib-Basic-Types.html#gchar"
>gchar</a> *name);</pre>
<p>
Creates a new cursor by looking up <em class="parameter"><code>name</code></em> in the current cursor
theme.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
<td> the <a href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> for which the cursor will be created
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the cursor
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> if there is no cursor with
the given name
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3015269"></a><h3>
<a name="gdk-cursor-new-for-display"></a>gdk_cursor_new_for_display ()</h3>
<a class="indexterm" name="id3015285"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_new_for_display (<a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a> *display,
<a href="gdk-Cursors.html#GdkCursorType">GdkCursorType</a> cursor_type);</pre>
<p>
Creates a new cursor from the set of builtin cursors.
Some useful ones are:
</p>
<div class="itemizedlist"><ul type="disc">
<li><p>
<img src="right_ptr.png"> <a href="gdk-Cursors.html#GDK-RIGHT-PTR:CAPS"><span class="type">GDK_RIGHT_PTR</span></a> (right-facing arrow)
</p></li>
<li><p>
<img src="crosshair.png"> <a href="gdk-Cursors.html#GDK-CROSSHAIR:CAPS"><span class="type">GDK_CROSSHAIR</span></a> (crosshair)
</p></li>
<li><p>
<img src="xterm.png"> <a href="gdk-Cursors.html#GDK-XTERM:CAPS"><span class="type">GDK_XTERM</span></a> (I-beam)
</p></li>
<li><p>
<img src="watch.png"> <a href="gdk-Cursors.html#GDK-WATCH:CAPS"><span class="type">GDK_WATCH</span></a> (busy)
</p></li>
<li><p>
<img src="fleur.png"> <a href="gdk-Cursors.html#GDK-FLEUR:CAPS"><span class="type">GDK_FLEUR</span></a> (for moving objects)
</p></li>
<li><p>
<img src="hand1.png"> <a href="gdk-Cursors.html#GDK-HAND1:CAPS"><span class="type">GDK_HAND1</span></a> (a right-pointing hand)
</p></li>
<li><p>
<img src="hand2.png"> <a href="gdk-Cursors.html#GDK-HAND2:CAPS"><span class="type">GDK_HAND2</span></a> (a left-pointing hand)
</p></li>
<li><p>
<img src="left_side.png"> <a href="gdk-Cursors.html#GDK-LEFT-SIDE:CAPS"><span class="type">GDK_LEFT_SIDE</span></a> (resize left side)
</p></li>
<li><p>
<img src="right_side.png"> <a href="gdk-Cursors.html#GDK-RIGHT-SIDE:CAPS"><span class="type">GDK_RIGHT_SIDE</span></a> (resize right side)
</p></li>
<li><p>
<img src="top_left_corner.png"> <a href="gdk-Cursors.html#GDK-TOP-LEFT-CORNER:CAPS"><span class="type">GDK_TOP_LEFT_CORNER</span></a> (resize northwest corner)
</p></li>
<li><p>
<img src="top_right_corner.png"> <a href="gdk-Cursors.html#GDK-TOP-RIGHT-CORNER:CAPS"><span class="type">GDK_TOP_RIGHT_CORNER</span></a> (resize northeast corner)
</p></li>
<li><p>
<img src="bottom_left_corner.png"> <a href="gdk-Cursors.html#GDK-BOTTOM-LEFT-CORNER:CAPS"><span class="type">GDK_BOTTOM_LEFT_CORNER</span></a> (resize southwest corner)
</p></li>
<li><p>
<img src="bottom_right_corner.png"> <a href="gdk-Cursors.html#GDK-BOTTOM-RIGHT-CORNER:CAPS"><span class="type">GDK_BOTTOM_RIGHT_CORNER</span></a> (resize southeast corner)
</p></li>
<li><p>
<img src="top_side.png"> <a href="gdk-Cursors.html#GDK-TOP-SIDE:CAPS"><span class="type">GDK_TOP_SIDE</span></a> (resize top side)
</p></li>
<li><p>
<img src="bottom_side.png"> <a href="gdk-Cursors.html#GDK-BOTTOM-SIDE:CAPS"><span class="type">GDK_BOTTOM_SIDE</span></a> (resize bottom side)
</p></li>
<li><p>
<img src="sb_h_double_arrow.png"> <a href="gdk-Cursors.html#GDK-SB-H-DOUBLE-ARROW:CAPS"><span class="type">GDK_SB_H_DOUBLE_ARROW</span></a> (move vertical splitter)
</p></li>
<li><p>
<img src="sb_v_double_arrow.png"> <a href="gdk-Cursors.html#GDK-SB-V-DOUBLE-ARROW:CAPS"><span class="type">GDK_SB_V_DOUBLE_ARROW</span></a> (move horizontal splitter)
</p></li>
</ul></div>
<p>
</p>
<p>
To make the cursor invisible, use <a href="gdk-Cursors.html#gdk-cursor-new-from-pixmap"><code class="function">gdk_cursor_new_from_pixmap()</code></a> to create
a cursor with no pixels in it.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>display</code></em> :</span></td>
<td> the <a href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> for which the cursor will be created
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>cursor_type</code></em> :</span></td>
<td> cursor to create
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3015758"></a><h3>
<a name="gdk-cursor-get-display"></a>gdk_cursor_get_display ()</h3>
<a class="indexterm" name="id3015773"></a><pre class="programlisting"><a href="GdkDisplay.html" title="GdkDisplay">GdkDisplay</a>* gdk_cursor_get_display (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);</pre>
<p>
Returns the display on which the <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> is defined.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cursor</code></em> :</span></td>
<td> a <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the <a href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> associated to <em class="parameter"><code>cursor</code></em>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.2
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3015867"></a><h3>
<a name="gdk-cursor-get-image"></a>gdk_cursor_get_image ()</h3>
<a class="indexterm" name="id3015883"></a><pre class="programlisting"><a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
>GdkPixbuf</a>* gdk_cursor_get_image (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);</pre>
<p>
Returns a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> with the image used to display the cursor.
</p>
<p>
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, <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a> is returned.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cursor</code></em> :</span></td>
<td> a <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a <a
href="../gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"
><span class="type">GdkPixbuf</span></a> representing <em class="parameter"><code>cursor</code></em>, or <a
href="../glib/glib-Standard-Macros.html#NULL:CAPS"
><code class="literal">NULL</code></a>
</td>
</tr>
</tbody>
</table></div>
<p>Since 2.8
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3016003"></a><h3>
<a name="gdk-cursor-ref"></a>gdk_cursor_ref ()</h3>
<a class="indexterm" name="id3016016"></a><pre class="programlisting"><a href="gdk-Cursors.html#GdkCursor">GdkCursor</a>* gdk_cursor_ref (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);</pre>
<p>
Adds a reference to <em class="parameter"><code>cursor</code></em>.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>cursor</code></em> :</span></td>
<td> a <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> Same <em class="parameter"><code>cursor</code></em> that was passed in
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3016096"></a><h3>
<a name="gdk-cursor-unref"></a>gdk_cursor_unref ()</h3>
<a class="indexterm" name="id3016109"></a><pre class="programlisting">void gdk_cursor_unref (<a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> *cursor);</pre>
<p>
Removes a reference from <em class="parameter"><code>cursor</code></em>, deallocating the cursor
if no references remain.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>cursor</code></em> :</span></td>
<td> a <a href="gdk-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a>
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3016173"></a><h3>
<a name="gdk-cursor-destroy"></a>gdk_cursor_destroy</h3>
<a class="indexterm" name="id3016188"></a><pre class="programlisting">#define gdk_cursor_destroy gdk_cursor_unref
</pre>
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Warning</h3>
<p><code class="literal">gdk_cursor_destroy</code> is deprecated and should not be used in newly-written code.</p>
</div>
<p>
Destroys a cursor, freeing any resources allocated for it.
</p>
</div>
</div>
</div>
</body>
</html>