8
8
<link rel="up" href="reference.html" title="API Reference">
9
9
<link rel="prev" href="multihead.html" title="Multi-head Support Overview">
10
10
<link rel="next" href="GdkDisplayManager.html" title="GdkDisplayManager">
11
<meta name="generator" content="GTK-Doc V1.14 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.15 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
201
201
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
202
202
<td> a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</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 default
204
. <acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>. </td>
203
display. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
207
207
<p class="since">Since 2.2</p>
708
708
<td><p><span class="term"><em class="parameter"><code>screen</code></em> :</span></p></td>
709
709
<td> location to store the screen that the
710
cursor is on, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
710
cursor is on, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
713
714
<td><p><span class="term"><em class="parameter"><code>x</code></em> :</span></p></td>
714
<td> location to store root window X coordinate of pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
715
<td> location to store root window X coordinate of pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
717
719
<td><p><span class="term"><em class="parameter"><code>y</code></em> :</span></p></td>
718
<td> location to store root window Y coordinate of pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
720
<td> location to store root window Y coordinate of pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
721
724
<td><p><span class="term"><em class="parameter"><code>mask</code></em> :</span></p></td>
722
<td> location to store current modifier mask, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
725
<td> location to store current modifier mask, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
749
753
<td><p><span class="term"><em class="parameter"><code>win_x</code></em> :</span></p></td>
750
754
<td> return location for x coordinate of the pointer location relative
751
to the window origin, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
755
to the window origin, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
754
759
<td><p><span class="term"><em class="parameter"><code>win_y</code></em> :</span></p></td>
755
760
<td> return location for y coordinate of the pointer location relative
756
& to the window origin, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>. <acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>. </td>
761
& to the window origin, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
759
765
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
760
<td> the window under the mouse pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
761
. <acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>. </td>
766
<td> the window under the mouse pointer, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
877
883
Note that the pointer should normally be under the
878
884
control of the user. This function was added to cover
879
885
some rare use cases like keyboard navigation support
880
for the color picker in the <a href="/usr/share/gtk-doc/html/gtk/GtkColorSelectionDialog.html"><span class="type">GtkColorSelectionDialog</span></a>.
886
for the color picker in the <a href="/usr/share/gtk-doc/html/gtk3/GtkColorSelectionDialog.html"><span class="type">GtkColorSelectionDialog</span></a>.
882
888
<div class="variablelist"><table border="0">
883
889
<col align="left" valign="top">