<?xml version="1.0" standalone="no"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
    "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">

<refentry id="class-gdkcursor">
  <refnamediv>
    <refname>gtk.gdk.Cursor</refname>
    <refpurpose>standard and pixmap cursors</refpurpose>
  </refnamediv>

  <refsect1>
    <title>Synopsis</title>

    <classsynopsis language="python">
      <ooclass><classname>gtk.gdk.Cursor</classname></ooclass>
      <ooclass><classname>gobject.GBoxed</classname></ooclass>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gdkcursor1">gtk.gdk.Cursor</link></methodname>
	<methodparam><parameter role="keyword">cursor_type</parameter></methodparam>
      </constructorsynopsis>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gdkcursor2">gtk.gdk.Cursor</link></methodname>
	<methodparam><parameter role="keyword">display</parameter></methodparam>
	<methodparam><parameter role="keyword">cursor_type</parameter></methodparam>
      </constructorsynopsis>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gdkcursor3">gtk.gdk.Cursor</link></methodname>
	<methodparam><parameter role="keyword">display</parameter></methodparam>
	<methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
	<methodparam><parameter role="keyword">x</parameter></methodparam>
	<methodparam><parameter role="keyword">y</parameter></methodparam>
      </constructorsynopsis>
      <constructorsynopsis language="python">
	<methodname><link
linkend="constructor-gdkcursor4">gtk.gdk.Cursor</link></methodname>
	<methodparam><parameter role="keyword">source</parameter></methodparam>
	<methodparam><parameter role="keyword">mask</parameter></methodparam>
	<methodparam><parameter role="keyword">fg</parameter></methodparam>
	<methodparam><parameter role="keyword">bg</parameter></methodparam>
	<methodparam><parameter role="keyword">x</parameter></methodparam>
	<methodparam><parameter role="keyword">y</parameter></methodparam>
      </constructorsynopsis>
      <methodsynopsis language="python">
	<methodname><link linkend="method-gdkcursor--get-display">get_display</link></methodname>
	<methodparam></methodparam>
      </methodsynopsis>
    </classsynopsis>

  </refsect1>

  <refsect1>
    <title>Description</title>

    <para>A <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link>
represents a bitmap image used for the mouse pointer. Each <link
linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> can
have its own cursor. By default a <link
linkend="class-gdkwindow"><classname>gtk.gdk.Window</classname></link> uses
its parent's cursor. A standard set of cursors is provided in
<literal>PyGTK</literal>:</para>

    <variablelist>
      <varlistentry>
	<term><literal>gtk.gdk.X_CURSOR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/X_cursor.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BASED_ARROW_DOWN</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/based_arrow_down.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BASED_ARROW_UP</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/based_arrow_up.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOAT</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/boat.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOGOSITY</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/bogosity.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOTTOM_LEFT_CORNER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/bottom_left_corner.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOTTOM_RIGHT_CORNER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/bottom_right_corner.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOTTOM_SIDE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/bottom_side.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOTTOM_TEE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/bottom_tee.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.BOX_SPIRAL</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/box_spiral.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CENTER_PTR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/center_ptr.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CIRCLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/circle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CLOCK</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/clock.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.COFFEE_MUG</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/coffee_mug.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CROSS</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/cross.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CROSS_REVERSE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/cross_reverse.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.CROSSHAIR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/crosshair.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DIAMOND_CROSS</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/diamond_cross.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DOT</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/dot.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DOTBOX</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/dotbox.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DOUBLE_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/double_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DRAFT_LARGE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/draft_large.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DRAFT_SMALL</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/draft_small.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.DRAPED_BOX</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/draped_box.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.EXCHANGE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/exchange.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.FLEUR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/fleur.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.GOBBLER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/gobbler.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.GUMBY</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/gumby.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.HAND1</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/hand1.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.HAND2</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/hand2.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.HEART</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/heart.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.ICON</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/icon.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.IRON_CROSS</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/iron_cross.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LEFT_PTR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/left_ptr.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LEFT_SIDE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/left_side.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LEFT_TEE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/left_tee.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LEFTBUTTON</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/leftbutton.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LL_ANGLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/ll_angle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.LR_ANGLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/lr_angle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.MAN</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/man.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.MIDDLEBUTTON</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/middlebutton.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.MOUSE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/mouse.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.PENCIL</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/pencil.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.PIRATE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/pirate.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.PLUS</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/plus.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.QUESTION_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/question_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.RIGHT_PTR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/right_ptr.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.RIGHT_SIDE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/right_side.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.RIGHT_TEE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/right_tee.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.RIGHTBUTTON</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/rightbutton.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.RTL_LOGO</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/rtl_logo.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SAILBOAT</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sailboat.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_DOWN_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_down_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_H_DOUBLE_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_h_double_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_LEFT_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_left_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_RIGHT_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_right_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_UP_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_up_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SB_V_DOUBLE_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sb_v_double_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SHUTTLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/shuttle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SIZING</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/sizing.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SPIDER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/spider.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.SPRAYCAN</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/spraycan.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.STAR</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/star.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TARGET</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/target.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TCROSS</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/tcross.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TOP_LEFT_ARROW</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/top_left_arrow.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TOP_LEFT_CORNER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/top_left_corner.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TOP_RIGHT_CORNER</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/top_right_corner.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TOP_SIDE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/top_side.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TOP_TEE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/top_tee.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.TREK</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/trek.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.UL_ANGLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/ul_angle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.UMBRELLA</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/umbrella.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.UR_ANGLE</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/ur_angle.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.WATCH</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/watch.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
      <varlistentry>
	<term><literal>gtk.gdk.XTERM</literal></term>
         <listitem>
           <simpara><imagedata fileref="cursors/xterm.png" format="png"/></simpara>
         </listitem>
      </varlistentry>
    </variablelist>

    <para></para>

  </refsect1>

  <refsect1>
    <title>Constructor</title>

    <refsect2 id="constructor-gdkcursor1">

      <programlisting><constructorsynopsis language="python">
	  <methodname>gtk.gdk.Cursor</methodname>
	  <methodparam><parameter role="keyword">cursor_type</parameter></methodparam>
  </constructorsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">cursor_type</parameter>&nbsp;:</term>
	  <listitem><simpara>the standard cursor to
create</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>Creates the new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link> from
a builtin cursor specified by <parameter>cursor_type</parameter>. To make
the cursor invisible, see the description of the <link
linkend="constructor-gdkcursor4">gtk.gdk.Cursor</link>() constructor that
creates a cursor from a pixmap below.</para>

    </refsect2>

    <refsect2 id="constructor-gdkcursor2">

      <programlisting><constructorsynopsis language="python">
	  <methodname>gtk.gdk.Cursor</methodname>
	  <methodparam><parameter role="keyword">display</parameter></methodparam>
	  <methodparam><parameter role="keyword">cursor_type</parameter></methodparam>
  </constructorsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">display</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
	  linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link>
	  to create the cursor for</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">cursor_type</parameter>&nbsp;:</term>
	  <listitem><simpara>the standard cursor to
create</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This constructor is available in PyGTK 2.4 and above.</para>
      </note>

      <para>Creates the new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link> for
the <link
linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link>
specified by <parameter>display</parameter> from a builtin cursor specified
by <parameter>cursor_type</parameter>. To make the cursor invisible, see the
description of the <link
linkend="constructor-gdkcursor4">gtk.gdk.Cursor</link>() constructor that
creates a cursor from a pixmap below.</para>

    </refsect2>

    <refsect2 id="constructor-gdkcursor3">

      <programlisting><constructorsynopsis language="python">
	  <methodname>gtk.gdk.Cursor</methodname>
	  <methodparam><parameter role="keyword">display</parameter></methodparam>
	  <methodparam><parameter role="keyword">pixbuf</parameter></methodparam>
	  <methodparam><parameter role="keyword">x</parameter></methodparam>
	  <methodparam><parameter role="keyword">y</parameter></methodparam>
  </constructorsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">display</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
	  linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link>
	  to create the cursor for</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">pixbuf</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link>
holding the cursor image</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">x</parameter>&nbsp;:</term>
	  <listitem><simpara>the "hot spot" x offset</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">y</parameter>&nbsp;:</term>
	  <listitem><simpara>the "hot spot" y offset</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This constructor is available in PyGTK 2.4 and above.</para>
      </note>

      <para>Creates a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link> for
the <link
linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link>
specified by display using the <link
linkend="class-gdkpixbuf"><classname>gtk.gdk.Pixbuf</classname></link>
specified by <parameter>source</parameter> as the icon image. The "hotspot"
of the cursor will be located as the position specified by
<parameter>x</parameter> and <parameter>y</parameter>. To make the cursor
invisible, see the description of the <link
linkend="constructor-gdkcursor4">gtk.gdk.Cursor</link>() constructor that
creates a cursor from a pixmap below</para>

    </refsect2>

    <refsect2 id="constructor-gdkcursor4">

      <programlisting><constructorsynopsis language="python">
	  <methodname>gtk.gdk.Cursor</methodname>
	  <methodparam><parameter role="keyword">source</parameter></methodparam>
	  <methodparam><parameter role="keyword">mask</parameter></methodparam>
	  <methodparam><parameter role="keyword">fg</parameter></methodparam>
	  <methodparam><parameter role="keyword">bg</parameter></methodparam>
	  <methodparam><parameter role="keyword">x</parameter></methodparam>
	  <methodparam><parameter role="keyword">y</parameter></methodparam>
  </constructorsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	  <term><parameter role="keyword">source</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
holding the cursor image</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">mask</parameter>&nbsp;:</term>
	  <listitem><simpara>the <link
linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link> to
use as a mask</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">fg</parameter>&nbsp;:</term>
	  <listitem><simpara>the unallocated foreground <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">bg</parameter>&nbsp;:</term>
	  <listitem><simpara>the unallocated background <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link></simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">x</parameter>&nbsp;:</term>
	  <listitem><simpara>the "hot spot" x offset</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><parameter role="keyword">y</parameter>&nbsp;:</term>
	  <listitem><simpara>the "hot spot" y offset</simpara></listitem>
	</varlistentry>
	<varlistentry>
	  <term><emphasis>Returns</emphasis>&nbsp;:</term>
	  <listitem><simpara>a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link></simpara></listitem>
	</varlistentry>
      </variablelist>

      <para>Creates a new <link
linkend="class-gdkcursor"><classname>gtk.gdk.Cursor</classname></link>
using:</para>

      <itemizedlist>
	<listitem>
	  <simpara>the <link
linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
specified by <parameter>source</parameter> as the icon image</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
specified by <parameter>mask</parameter> to mask
<parameter>source</parameter> (must be the same size as source)</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>
specified by <parameter>fg</parameter> as the foreground color of the
cursor</simpara>
	</listitem>
	<listitem>
	  <simpara>the <link
linkend="class-gdkcolor"><classname>gtk.gdk.Color</classname></link>
specified by <parameter>bg</parameter> as the background color of the
cursor</simpara>
	</listitem>
	<listitem>
	  <simpara>the horizontal offset of the cursor "hot spot" specified
by <parameter>x</parameter></simpara>
	</listitem>
	<listitem>
	  <simpara>the vertical offset of the cursor "hot spot" specified
by <parameter>y</parameter></simpara>
	</listitem>
      </itemizedlist>

      <para>To make the cursor invisible, create a cursor from an empty
<link linkend="class-gdkpixmap"><classname>gtk.gdk.Pixmap</classname></link>
as follows:</para>

      <programlisting>
  pixmap = gtk.gdk.Pixmap(None, 1, 1, 1)
  color = gtk.gdk.Color()
  cursor = gtk.gdk.Cursor(pixmap, pixmap, color, color, 0, 0)
</programlisting>

    </refsect2>

  </refsect1>

  <refsect1>
    <title>Methods</title>

    <refsect2 id="method-gdkcursor--get-display">
      <title>gtk.gdk.Cursor.get_display</title>

      <programlisting><methodsynopsis language="python">
	  <methodname>get_display</methodname>
	</methodsynopsis></programlisting>
      <variablelist>
	<varlistentry>
	<term><emphasis>Returns</emphasis>&nbsp;:</term>
          <listitem><simpara>the associated <link
linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link></simpara></listitem>
	</varlistentry>
      </variablelist>

      <note>
	<para>This method is available in PyGTK 2.2 and above.</para>
      </note>

      <para>The <methodname>get_display</methodname>() method returns the
<link
linkend="class-gdkdisplay"><classname>gtk.gdk.Display</classname></link> on
which the cursor is defined.</para>

    </refsect2>

  </refsect1>

</refentry>
