← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-Cursors.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/html/gdk-Cursors.html
47
47
                                                         <em class="parameter"><code><a class="link" href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"><span class="type">GdkPixmap</span></a> *mask</code></em>,
48
48
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *fg</code></em>,
49
49
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *bg</code></em>,
50
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
51
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
 
50
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 
51
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
52
52
<a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-new-from-pixbuf" title="gdk_cursor_new_from_pixbuf ()">gdk_cursor_new_from_pixbuf</a>          (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
53
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
54
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
55
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
 
53
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
 
54
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);
56
56
<a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-new-from-name" title="gdk_cursor_new_from_name ()">gdk_cursor_new_from_name</a>            (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
57
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
 
57
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);
58
58
<a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-new-for-display" title="gdk_cursor_new_for_display ()">gdk_cursor_new_for_display</a>          (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
59
59
                                                         <em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursorType" title="enum GdkCursorType"><span class="type">GdkCursorType</span></a> cursor_type</code></em>);
60
60
<a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="returnvalue">GdkDisplay</span></a>*         <a class="link" href="gdk-Cursors.html#gdk-cursor-get-display" title="gdk_cursor_get_display ()">gdk_cursor_get_display</a>              (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
61
 
<a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-get-image" title="gdk_cursor_get_image ()">gdk_cursor_get_image</a>                (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
 
61
<a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-get-image" title="gdk_cursor_get_image ()">gdk_cursor_get_image</a>                (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
62
62
<a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          <a class="link" href="gdk-Cursors.html#gdk-cursor-ref" title="gdk_cursor_ref ()">gdk_cursor_ref</a>                      (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="gdk-Cursors.html#gdk-cursor-unref" title="gdk_cursor_unref ()">gdk_cursor_unref</a>                    (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);
64
64
#define             <a class="link" href="gdk-Cursors.html#gdk-cursor-destroy" title="gdk_cursor_destroy">gdk_cursor_destroy</a>
704
704
                                                         <em class="parameter"><code><a class="link" href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap"><span class="type">GdkPixmap</span></a> *mask</code></em>,
705
705
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *fg</code></em>,
706
706
                                                         <em class="parameter"><code>const <a class="link" href="gdk-Colormaps-and-Colors.html#GdkColor" title="GdkColor"><span class="type">GdkColor</span></a> *bg</code></em>,
707
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
708
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
 
707
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 
708
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
709
709
<p>
710
710
Creates a new cursor from a given pixmap and mask. Both the pixmap and mask
711
711
must have a depth of 1 (i.e. each pixel has only 2 values - on or off).
715
715
<p>
716
716
</p>
717
717
<div class="example">
718
 
<a name="id592129"></a><p class="title"><b>Example 6. Creating a custom cursor</b></p>
 
718
<a name="id656846"></a><p class="title"><b>Example 6. Creating a custom cursor</b></p>
719
719
<div class="example-contents">
720
720
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
721
721
    <tbody>
766
766
<span class="normal">  </span><span class="number">0x30</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x0c</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x60</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x06</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0xc0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x03</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x80</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0x01</span><span class="cbracket">}</span><span class="symbol">;</span>
767
767
<span class="normal"> </span>
768
768
<span class="normal"> </span>
769
 
<span class="normal"> <a href="gdk-Cursors.html#GdkCursor">GdkCursor</a> </span><span class="symbol">*</span><span class="normal">cursor</span><span class="symbol">;</span>
770
 
<span class="normal"> <a href="gdk-Bitmaps-and-Pixmaps.html#GdkPixmap">GdkPixmap</a> </span><span class="symbol">*</span><span class="normal">source</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">mask</span><span class="symbol">;</span>
771
 
<span class="normal"> <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> fg </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">65535</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Red. */</span>
772
 
<span class="normal"> <a href="gdk-Colormaps-and-Colors.html#GdkColor">GdkColor</a> bg </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">65535</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Blue. */</span>
773
 
<span class="normal"> </span>
774
 
<span class="normal"> </span>
775
 
<span class="normal"> source </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Bitmaps-and-Pixmaps.html#gdk-bitmap-create-from-data">gdk_bitmap_create_from_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> cursor1_bits</span><span class="symbol">,</span>
 
769
<span class="normal"> </span><span class="usertype">GdkCursor</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">cursor</span><span class="symbol">;</span>
 
770
<span class="normal"> </span><span class="usertype">GdkPixmap</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">source</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">mask</span><span class="symbol">;</span>
 
771
<span class="normal"> </span><span class="usertype">GdkColor</span><span class="normal"> fg </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">65535</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Red. */</span>
 
772
<span class="normal"> </span><span class="usertype">GdkColor</span><span class="normal"> bg </span><span class="symbol">=</span><span class="normal"> </span><span class="cbracket">{</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">0</span><span class="symbol">,</span><span class="normal"> </span><span class="number">65535</span><span class="normal"> </span><span class="cbracket">}</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/* Blue. */</span>
 
773
<span class="normal"> </span>
 
774
<span class="normal"> </span>
 
775
<span class="normal"> source </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Bitmaps-and-Pixmaps.html#gdk-bitmap-create-from-data">gdk_bitmap_create_from_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> cursor1_bits</span><span class="symbol">,</span>
776
776
<span class="normal">                                       cursor1_width</span><span class="symbol">,</span><span class="normal"> cursor1_height</span><span class="symbol">);</span>
777
 
<span class="normal"> mask </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Bitmaps-and-Pixmaps.html#gdk-bitmap-create-from-data">gdk_bitmap_create_from_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> cursor1mask_bits</span><span class="symbol">,</span>
 
777
<span class="normal"> mask </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Bitmaps-and-Pixmaps.html#gdk-bitmap-create-from-data">gdk_bitmap_create_from_data</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">,</span><span class="normal"> cursor1mask_bits</span><span class="symbol">,</span>
778
778
<span class="normal">                                     cursor1_width</span><span class="symbol">,</span><span class="normal"> cursor1_height</span><span class="symbol">);</span>
779
779
<span class="normal"> cursor </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="gdk-Cursors.html#gdk-cursor-new-from-pixmap">gdk_cursor_new_from_pixmap</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">source</span><span class="symbol">,</span><span class="normal"> mask</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">fg</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">bg</span><span class="symbol">,</span><span class="normal"> </span><span class="number">8</span><span class="symbol">,</span><span class="normal"> </span><span class="number">8</span><span class="symbol">);</span>
780
 
<span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">source</span><span class="symbol">);</span>
781
 
<span class="normal"> </span><span class="function"><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mask</span><span class="symbol">);</span>
 
780
<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">source</span><span class="symbol">);</span>
 
781
<span class="normal"> </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref">g_object_unref</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">mask</span><span class="symbol">);</span>
782
782
<span class="normal"> </span>
783
783
<span class="normal"> </span>
784
784
<span class="normal"> </span><span class="function"><a href="gdk-Windows.html#gdk-window-set-cursor">gdk_window_set_cursor</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">widget</span><span class="symbol">-&gt;</span><span class="normal">window</span><span class="symbol">,</span><span class="normal"> cursor</span><span class="symbol">);</span></pre></td>
838
838
<div class="refsect2" title="gdk_cursor_new_from_pixbuf ()">
839
839
<a name="gdk-cursor-new-from-pixbuf"></a><h3>gdk_cursor_new_from_pixbuf ()</h3>
840
840
<pre class="programlisting"><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          gdk_cursor_new_from_pixbuf          (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
841
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
842
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
843
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
 
841
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> *pixbuf</code></em>,
 
842
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
 
843
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
844
844
<p>
845
845
Creates a new cursor from a pixbuf. 
846
846
</p>
868
868
</tr>
869
869
<tr>
870
870
<td><p><span class="term"><em class="parameter"><code>pixbuf</code></em> :</span></p></td>
871
 
<td>the <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing the cursor image
 
871
<td>the <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> containing the cursor image
872
872
</td>
873
873
</tr>
874
874
<tr>
895
895
<div class="refsect2" title="gdk_cursor_new_from_name ()">
896
896
<a name="gdk-cursor-new-from-name"></a><h3>gdk_cursor_new_from_name ()</h3>
897
897
<pre class="programlisting"><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="returnvalue">GdkCursor</span></a>*          gdk_cursor_new_from_name            (<em class="parameter"><code><a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> *display</code></em>,
898
 
                                                         <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
 
898
                                                         <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
899
899
<p>
900
900
Creates a new cursor by looking up <em class="parameter"><code>name</code></em> in the current cursor
901
901
theme.
915
915
</tr>
916
916
<tr>
917
917
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
918
 
<td> a new <a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no cursor with 
 
918
<td> a new <a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no cursor with 
919
919
  the given name 
920
920
 
921
921
</td>
1042
1042
<hr>
1043
1043
<div class="refsect2" title="gdk_cursor_get_image ()">
1044
1044
<a name="gdk-cursor-get-image"></a><h3>gdk_cursor_get_image ()</h3>
1045
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>*          gdk_cursor_get_image                (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
 
1045
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="returnvalue">GdkPixbuf</span></a>*          gdk_cursor_get_image                (<em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>);</pre>
1046
1046
<p>
1047
 
Returns a <a href="/usr/share/gtk-doc/html/gdk-pixbuf/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with the image used to display the cursor.
 
1047
Returns a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> with the image used to display the cursor.
1048
1048
</p>
1049
1049
<p>
1050
1050
Note that depending on the capabilities of the windowing system and 
1051
1051
on the cursor, GDK may not be able to obtain the image data. In this 
1052
 
case, <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.
 
1052
case, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.
1053
1053
</p>
1054
1054
<div class="variablelist"><table border="0">
1055
1055
<col align="left" valign="top">
1061
1061
</tr>
1062
1062
<tr>
1063
1063
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1064
 
<td> a <a href="/usr/share/gtk-doc/html/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="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
1064
<td> a <a href="http://library.gnome.org/devel/gdk-pixbuf/unstable/gdk-pixbuf-gdk-pixbuf.html#GdkPixbuf"><span class="type">GdkPixbuf</span></a> representing <em class="parameter"><code>cursor</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
1065
1065
 
1066
1066
</td>
1067
1067
</tr>