New upstream version 3.24.2

This commit is contained in:
Jeremy Bicha
2018-12-12 16:07:25 -05:00
572 changed files with 819858 additions and 710881 deletions

View File

@ -8,7 +8,7 @@
<link rel="up" href="reference.html" title="API Reference">
<link rel="prev" href="GdkDisplay.html" title="GdkDisplay">
<link rel="next" href="GdkSeat.html" title="GdkSeat">
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
<meta name="generator" content="GTK-Doc V1.29 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@ -68,7 +68,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-is-composited" title="gdk_screen_is_composited ()">gdk_screen_is_composited</a> <span class="c_punctuation">()</span>
@ -92,7 +92,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-number" title="gdk_screen_get_number ()">gdk_screen_get_number</a> <span class="c_punctuation">()</span>
@ -100,7 +100,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-width" title="gdk_screen_get_width ()">gdk_screen_get_width</a> <span class="c_punctuation">()</span>
@ -108,7 +108,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-height" title="gdk_screen_get_height ()">gdk_screen_get_height</a> <span class="c_punctuation">()</span>
@ -116,7 +116,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-width-mm" title="gdk_screen_get_width_mm ()">gdk_screen_get_width_mm</a> <span class="c_punctuation">()</span>
@ -124,7 +124,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-height-mm" title="gdk_screen_get_height_mm ()">gdk_screen_get_height_mm</a> <span class="c_punctuation">()</span>
@ -132,7 +132,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-list-visuals" title="gdk_screen_list_visuals ()">gdk_screen_list_visuals</a> <span class="c_punctuation">()</span>
@ -140,7 +140,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-toplevel-windows" title="gdk_screen_get_toplevel_windows ()">gdk_screen_get_toplevel_windows</a> <span class="c_punctuation">()</span>
@ -148,7 +148,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-make-display-name" title="gdk_screen_make_display_name ()">gdk_screen_make_display_name</a> <span class="c_punctuation">()</span>
@ -156,7 +156,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-n-monitors" title="gdk_screen_get_n_monitors ()">gdk_screen_get_n_monitors</a> <span class="c_punctuation">()</span>
@ -164,7 +164,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-primary-monitor" title="gdk_screen_get_primary_monitor ()">gdk_screen_get_primary_monitor</a> <span class="c_punctuation">()</span>
@ -188,7 +188,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-at-point" title="gdk_screen_get_monitor_at_point ()">gdk_screen_get_monitor_at_point</a> <span class="c_punctuation">()</span>
@ -196,7 +196,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-at-window" title="gdk_screen_get_monitor_at_window ()">gdk_screen_get_monitor_at_window</a> <span class="c_punctuation">()</span>
@ -204,7 +204,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-height-mm" title="gdk_screen_get_monitor_height_mm ()">gdk_screen_get_monitor_height_mm</a> <span class="c_punctuation">()</span>
@ -212,7 +212,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-width-mm" title="gdk_screen_get_monitor_width_mm ()">gdk_screen_get_monitor_width_mm</a> <span class="c_punctuation">()</span>
@ -220,7 +220,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-plug-name" title="gdk_screen_get_monitor_plug_name ()">gdk_screen_get_monitor_plug_name</a> <span class="c_punctuation">()</span>
@ -228,7 +228,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<span class="returnvalue">gint</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-monitor-scale-factor" title="gdk_screen_get_monitor_scale_factor ()">gdk_screen_get_monitor_scale_factor</a> <span class="c_punctuation">()</span>
@ -236,14 +236,14 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-setting" title="gdk_screen_get_setting ()">gdk_screen_get_setting</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">cairo_font_options_t</span> *
<td class="function_type">const <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t"><span class="returnvalue">cairo_font_options_t</span></a> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-font-options" title="gdk_screen_get_font_options ()">gdk_screen_get_font_options</a> <span class="c_punctuation">()</span>
@ -259,7 +259,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>
<span class="returnvalue">gdouble</span>
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-resolution" title="gdk_screen_get_resolution ()">gdk_screen_get_resolution</a> <span class="c_punctuation">()</span>
@ -283,7 +283,7 @@
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<span class="returnvalue">GList</span> *
</td>
<td class="function_name">
<a class="link" href="GdkScreen.html#gdk-screen-get-window-stack" title="gdk_screen_get_window_stack ()">gdk_screen_get_window_stack</a> <span class="c_punctuation">()</span>
@ -302,12 +302,12 @@
</colgroup>
<tbody>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></td>
<td class="property_type"><span class="type">gpointer</span></td>
<td class="property_name"><a class="link" href="GdkScreen.html#GdkScreen--font-options" title="The “font-options” property">font-options</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></td>
<td class="property_type"><span class="type">gdouble</span></td>
<td class="property_name"><a class="link" href="GdkScreen.html#GdkScreen--resolution" title="The “resolution” property">resolution</a></td>
<td class="property_flags">Read / Write</td>
</tr>
@ -326,17 +326,17 @@
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdkScreen.html#GdkScreen-composited-changed" title="The “composited-changed” signal">composited-changed</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdkScreen.html#GdkScreen-monitors-changed" title="The “monitors-changed” signal">monitors-changed</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
<tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GdkScreen.html#GdkScreen-size-changed" title="The “size-changed” signal">size-changed</a></td>
<td class="signal_flags"><a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></td>
<td class="signal_flags">Run Last</td>
</tr>
</tbody>
</table></div>
@ -356,7 +356,7 @@
</div>
<div class="refsect1">
<a name="GdkScreen.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a>
<pre class="screen"> GObject
<span class="lineart">╰──</span> GdkScreen
</pre>
</div>
@ -388,7 +388,7 @@ gdk_screen_get_default (<em class="parameter"><code><span class="type">void</spa
<a class="link" href="GdkDisplay.html#gdk-display-get-default" title="gdk_display_get_default ()"><code class="function">gdk_display_get_default()</code></a>).</p>
<div class="refsect3">
<a name="gdk-screen-get-default.returns"></a><h4>Returns</h4>
<p>a <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if
<p>a <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a>, or <code class="literal">NULL</code> if
there is no default display. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -432,8 +432,8 @@ The return value should not be freed.</p>
gdk_screen_get_rgba_visual (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Gets a visual to use for creating windows with an alpha channel.
The windowing system on which GTK+ is running
may not support this capability, in which case <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> will
be returned. Even if a non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value is returned, its
may not support this capability, in which case <code class="literal">NULL</code> will
be returned. Even if a non-<code class="literal">NULL</code> value is returned, its
possible that the windows alpha channel wont be honored
when displaying the window on the screen: in particular, for
X an appropriate windowing manager and compositing manager
@ -459,7 +459,7 @@ must be running to provide appropriate display.</p>
<div class="refsect3">
<a name="gdk-screen-get-rgba-visual.returns"></a><h4>Returns</h4>
<p>a visual to use for windows
with an alpha channel or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the capability is not
with an alpha channel or <code class="literal">NULL</code> if the capability is not
available. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
@ -468,7 +468,7 @@ available. </p>
<hr>
<div class="refsect2">
<a name="gdk-screen-is-composited"></a><h3>gdk_screen_is_composited ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gdk_screen_is_composited (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Returns whether windows with an RGBA visual can reasonably
be expected to have their alpha channel drawn correctly on
@ -560,7 +560,7 @@ belongs. </p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-number"></a><h3>gdk_screen_get_number ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_number (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning"><p><code class="literal">gdk_screen_get_number</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
<p>Gets the index of <em class="parameter"><code>screen</code></em>
@ -590,7 +590,7 @@ to which it belongs. (See <a class="link" href="GdkScreen.html#gdk-screen-get-di
<hr>
<div class="refsect2">
<a name="gdk-screen-get-width"></a><h3>gdk_screen_get_width ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_width (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_width</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -625,7 +625,7 @@ in pixels.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-height"></a><h3>gdk_screen_get_height ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_height (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_height</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -660,7 +660,7 @@ in pixels.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-width-mm"></a><h3>gdk_screen_get_width_mm ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_width_mm (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_width_mm</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -696,7 +696,7 @@ in millimeters.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-height-mm"></a><h3>gdk_screen_get_height_mm ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_height_mm (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_height_mm</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -732,14 +732,14 @@ in millimeters.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-list-visuals"></a><h3>gdk_screen_list_visuals ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<pre class="programlisting"><span class="returnvalue">GList</span> *
gdk_screen_list_visuals (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Lists the available visuals for the specified <em class="parameter"><code>screen</code></em>
.
A visual describes a hardware image data format.
For example, a visual might support 24-bit color, or 8-bit color,
and might expect pixels to be in a certain format.</p>
<p>Call <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> on the return value when youre finished with it.</p>
<p>Call <code class="function">g_list_free()</code> on the return value when youre finished with it.</p>
<div class="refsect3">
<a name="gdk-screen-list-visuals.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -765,13 +765,13 @@ and might expect pixels to be in a certain format.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-toplevel-windows"></a><h3>gdk_screen_get_toplevel_windows ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<pre class="programlisting"><span class="returnvalue">GList</span> *
gdk_screen_get_toplevel_windows (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Obtains a list of all toplevel windows known to GDK on the screen <em class="parameter"><code>screen</code></em>
.
A toplevel window is a child of the root window (see
<a class="link" href="gdk3-Windows.html#gdk-get-default-root-window" title="gdk_get_default_root_window ()"><code class="function">gdk_get_default_root_window()</code></a>).</p>
<p>The returned list should be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>, but
<p>The returned list should be freed with <code class="function">g_list_free()</code>, but
its elements need not be freed.</p>
<div class="refsect3">
<a name="gdk-screen-get-toplevel-windows.parameters"></a><h4>Parameters</h4>
@ -790,7 +790,7 @@ its elements need not be freed.</p>
</div>
<div class="refsect3">
<a name="gdk-screen-get-toplevel-windows.returns"></a><h4>Returns</h4>
<p>list of toplevel windows, free with <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a>. </p>
<p>list of toplevel windows, free with <code class="function">g_list_free()</code>. </p>
<p><span class="annotation">[<acronym title="Free data container after the code is done."><span class="acronym">transfer container</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span></p>
</div>
<p class="since">Since: 2.2</p>
@ -798,7 +798,7 @@ its elements need not be freed.</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-make-display-name"></a><h3>gdk_screen_make_display_name ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gdk_screen_make_display_name (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning"><p><code class="literal">gdk_screen_make_display_name</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p></div>
<p>Determines the name to pass to <a class="link" href="GdkDisplay.html#gdk-display-open" title="gdk_display_open ()"><code class="function">gdk_display_open()</code></a> to get
@ -820,14 +820,14 @@ a <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">G
</div>
<div class="refsect3">
<a name="gdk-screen-make-display-name.returns"></a><h4>Returns</h4>
<p> a newly allocated string, free with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></p>
<p> a newly allocated string, free with <code class="function">g_free()</code></p>
</div>
<p class="since">Since: 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-n-monitors"></a><h3>gdk_screen_get_n_monitors ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_n_monitors (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_n_monitors</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -860,7 +860,7 @@ consists of</p>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-primary-monitor"></a><h3>gdk_screen_get_primary_monitor ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_primary_monitor (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_primary_monitor</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -900,7 +900,7 @@ will be 0, defaulting to the first monitor.</p>
<a name="gdk-screen-get-monitor-geometry"></a><h3>gdk_screen_get_monitor_geometry ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdk_screen_get_monitor_geometry (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>,
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *dest</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_geometry</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -950,7 +950,7 @@ the monitor geometry. </p></td>
<a name="gdk-screen-get-monitor-workarea"></a><h3>gdk_screen_get_monitor_workarea ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdk_screen_get_monitor_workarea (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>,
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Points-Rectangles-and-Regions.html#GdkRectangle" title="GdkRectangle"><span class="type">GdkRectangle</span></a> *dest</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_workarea</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
@ -1002,10 +1002,10 @@ the monitor workarea. </p></td>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-at-point"></a><h3>gdk_screen_get_monitor_at_point ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_monitor_at_point (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> x</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> y</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> x</code></em>,
<em class="parameter"><code><span class="type">gint</span> y</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_at_point</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GdkDisplay.html#gdk-display-get-monitor-at-point" title="gdk_display_get_monitor_at_point ()"><code class="function">gdk_display_get_monitor_at_point()</code></a> instead</p>
@ -1054,7 +1054,7 @@ a monitor close to (<em class="parameter"><code>x</code></em>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-at-window"></a><h3>gdk_screen_get_monitor_at_window ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_monitor_at_window (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>);</pre>
<div class="warning">
@ -1100,9 +1100,9 @@ close to <em class="parameter"><code>window</code></em>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-height-mm"></a><h3>gdk_screen_get_monitor_height_mm ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_monitor_height_mm (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_height_mm</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GdkMonitor.html#gdk-monitor-get-height-mm" title="gdk_monitor_get_height_mm ()"><code class="function">gdk_monitor_get_height_mm()</code></a> instead</p>
@ -1139,9 +1139,9 @@ gdk_screen_get_monitor_height_mm (<em class="parameter"><code><a class="link" hr
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-width-mm"></a><h3>gdk_screen_get_monitor_width_mm ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_monitor_width_mm (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_width_mm</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GdkMonitor.html#gdk-monitor-get-width-mm" title="gdk_monitor_get_width_mm ()"><code class="function">gdk_monitor_get_width_mm()</code></a> instead</p>
@ -1178,9 +1178,9 @@ gdk_screen_get_monitor_width_mm (<em class="parameter"><code><a class="link" hre
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-plug-name"></a><h3>gdk_screen_get_monitor_plug_name ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
<pre class="programlisting"><span class="returnvalue">gchar</span> *
gdk_screen_get_monitor_plug_name (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_plug_name</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GdkMonitor.html#gdk-monitor-get-model" title="gdk_monitor_get_model ()"><code class="function">gdk_monitor_get_model()</code></a> instead</p>
@ -1213,7 +1213,7 @@ product name of the display device.</p>
<div class="refsect3">
<a name="gdk-screen-get-monitor-plug-name.returns"></a><h4>Returns</h4>
<p>a newly-allocated string containing the name
of the monitor, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the name cannot be determined. </p>
of the monitor, or <code class="literal">NULL</code> if the name cannot be determined. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.14</p>
@ -1221,9 +1221,9 @@ of the monitor, or <a href="https://developer.gnome.org/glib/unstable/glib-Stand
<hr>
<div class="refsect2">
<a name="gdk-screen-get-monitor-scale-factor"></a><h3>gdk_screen_get_monitor_scale_factor ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
<pre class="programlisting"><span class="returnvalue">gint</span>
gdk_screen_get_monitor_scale_factor (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> monitor_num</code></em>);</pre>
<em class="parameter"><code><span class="type">gint</span> monitor_num</code></em>);</pre>
<div class="warning">
<p><code class="literal">gdk_screen_get_monitor_scale_factor</code> has been deprecated since version 3.22 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GdkMonitor.html#gdk-monitor-get-scale-factor" title="gdk_monitor_get_scale_factor ()"><code class="function">gdk_monitor_get_scale_factor()</code></a> instead</p>
@ -1265,10 +1265,10 @@ where it is better to use <a class="link" href="gdk3-Windows.html#gdk-window-get
<hr>
<div class="refsect2">
<a name="gdk-screen-get-setting"></a><h3>gdk_screen_get_setting ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gdk_screen_get_setting (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue-struct"><span class="type">GValue</span></a> *value</code></em>);</pre>
<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
<em class="parameter"><code><span class="type">GValue</span> *value</code></em>);</pre>
<p>Retrieves a desktop-wide setting such as double-click time
for the <a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> <em class="parameter"><code>screen</code></em>
.</p>
@ -1303,16 +1303,16 @@ more information.</p>
</div>
<div class="refsect3">
<a name="gdk-screen-get-setting.returns"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the setting existed and a value was stored
<p> <code class="literal">TRUE</code> if the setting existed and a value was stored
in <em class="parameter"><code>value</code></em>
, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</p>
, <code class="literal">FALSE</code> otherwise.</p>
</div>
<p class="since">Since: 2.2</p>
</div>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-font-options"></a><h3>gdk_screen_get_font_options ()</h3>
<pre class="programlisting">const <span class="returnvalue">cairo_font_options_t</span> *
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t"><span class="returnvalue">cairo_font_options_t</span></a> *
gdk_screen_get_font_options (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Gets any options previously set with <a class="link" href="GdkScreen.html#gdk-screen-set-font-options" title="gdk_screen_set_font_options ()"><code class="function">gdk_screen_set_font_options()</code></a>.</p>
<div class="refsect3">
@ -1332,7 +1332,7 @@ gdk_screen_get_font_options (<em class="parameter"><code><a class="link" href="G
</div>
<div class="refsect3">
<a name="gdk-screen-get-font-options.returns"></a><h4>Returns</h4>
<p>the current font options, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no
<p>the current font options, or <code class="literal">NULL</code> if no
default font options have been set. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
@ -1343,7 +1343,7 @@ default font options have been set. </p>
<a name="gdk-screen-set-font-options"></a><h3>gdk_screen_set_font_options ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdk_screen_set_font_options (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code>const <span class="type">cairo_font_options_t</span> *options</code></em>);</pre>
<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a> *options</code></em>);</pre>
<p>Sets the default font options for the screen. These
options will be set on any <a href="/usr/share/gtk-doc/html/pango/pango-Text-Processing.html#PangoContext-struct"><span class="type">PangoContext</span></a>s newly created
with <a class="link" href="gdk3-Pango-Interaction.html#gdk-pango-context-get-for-screen" title="gdk_pango_context_get_for_screen ()"><code class="function">gdk_pango_context_get_for_screen()</code></a>. Changing the
@ -1365,7 +1365,7 @@ have already been created.</p>
</tr>
<tr>
<td class="parameter_name"><p>options</p></td>
<td class="parameter_description"><p>a <span class="type">cairo_font_options_t</span>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to unset any
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/cairo/cairo-cairo-font-options-t.html#cairo-font-options-t"><span class="type">cairo_font_options_t</span></a>, or <code class="literal">NULL</code> to unset any
previously set default font options. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
@ -1377,7 +1377,7 @@ previously set default font options. </p></td>
<hr>
<div class="refsect2">
<a name="gdk-screen-get-resolution"></a><h3>gdk_screen_get_resolution ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="returnvalue">gdouble</span></a>
<pre class="programlisting"><span class="returnvalue">gdouble</span>
gdk_screen_get_resolution (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Gets the resolution for font handling on the screen; see
<a class="link" href="GdkScreen.html#gdk-screen-set-resolution" title="gdk_screen_set_resolution ()"><code class="function">gdk_screen_set_resolution()</code></a> for full details.</p>
@ -1408,7 +1408,7 @@ has been set.</p>
<a name="gdk-screen-set-resolution"></a><h3>gdk_screen_set_resolution ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gdk_screen_set_resolution (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dpi</code></em>);</pre>
<em class="parameter"><code><span class="type">gdouble</span> dpi</code></em>);</pre>
<p>Sets the resolution for font handling on the screen. This is a
scale factor between points specified in a <a href="/usr/share/gtk-doc/html/pango/pango-Fonts.html#PangoFontDescription-struct"><span class="type">PangoFontDescription</span></a>
and cairo units. The default value is 96, meaning that a 10 point
@ -1450,10 +1450,10 @@ on the root window, as described in the
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>.
If there is no currently currently active
window, or the window manager does not support the
_NET_ACTIVE_WINDOW hint, this function returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<p>On other platforms, this function may return <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, depending on whether
_NET_ACTIVE_WINDOW hint, this function returns <code class="literal">NULL</code>.</p>
<p>On other platforms, this function may return <code class="literal">NULL</code>, depending on whether
it is implementable on that platform.</p>
<p>The returned window should be unrefed using <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when
<p>The returned window should be unrefed using <code class="function">g_object_unref()</code> when
no longer needed.</p>
<div class="refsect3">
<a name="gdk-screen-get-active-window.parameters"></a><h4>Parameters</h4>
@ -1473,7 +1473,7 @@ no longer needed.</p>
<div class="refsect3">
<a name="gdk-screen-get-active-window.returns"></a><h4>Returns</h4>
<p>the currently active window,
or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -1481,20 +1481,20 @@ or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#
<hr>
<div class="refsect2">
<a name="gdk-screen-get-window-stack"></a><h3>gdk_screen_get_window_stack ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
<pre class="programlisting"><span class="returnvalue">GList</span> *
gdk_screen_get_window_stack (<em class="parameter"><code><a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen</code></em>);</pre>
<p>Returns a <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a> representing the current
<p>Returns a <span class="type">GList</span> of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a> representing the current
window stack.</p>
<p>On X11, this is done by inspecting the _NET_CLIENT_LIST_STACKING
property on the root window, as described in the
<a class="ulink" href="http://www.freedesktop.org/Standards/wm-spec" target="_top">Extended Window Manager Hints</a>.
If the window manager does not support the
_NET_CLIENT_LIST_STACKING hint, this function returns <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
<p>On other platforms, this function may return <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, depending on whether
_NET_CLIENT_LIST_STACKING hint, this function returns <code class="literal">NULL</code>.</p>
<p>On other platforms, this function may return <code class="literal">NULL</code>, depending on whether
it is implementable on that platform.</p>
<p>The returned list is newly allocated and owns references to the
windows it contains, so it should be freed using <a href="https://developer.gnome.org/glib/unstable/glib-Doubly-Linked-Lists.html#g-list-free"><code class="function">g_list_free()</code></a> and
its windows unrefed using <a href="https://developer.gnome.org/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.</p>
windows it contains, so it should be freed using <code class="function">g_list_free()</code> and
its windows unrefed using <code class="function">g_object_unref()</code> when no longer needed.</p>
<div class="refsect3">
<a name="gdk-screen-get-window-stack.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
@ -1513,7 +1513,7 @@ its windows unrefed using <a href="https://developer.gnome.org/gobject/unstable/
<div class="refsect3">
<a name="gdk-screen-get-window-stack.returns"></a><h4>Returns</h4>
<p>a
list of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a> for the current window stack, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p>
list of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindows</span></a> for the current window stack, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GdkWindow]</span></p>
</div>
<p class="since">Since: 2.10</p>
@ -1530,14 +1530,14 @@ list of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindo
<a name="GdkScreen.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GdkScreen--font-options"></a><h3>The <code class="literal">“font-options”</code> property</h3>
<pre class="programlisting"> “font-options” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a></pre>
<pre class="programlisting"> “font-options” <span class="type">gpointer</span></pre>
<p>The default font options for the screen.</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GdkScreen--resolution"></a><h3>The <code class="literal">“resolution”</code> property</h3>
<pre class="programlisting"> “resolution” <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a></pre>
<pre class="programlisting"> “resolution” <span class="type">gdouble</span></pre>
<p>The resolution for fonts on the screen.</p>
<p>Flags: Read / Write</p>
<p>Allowed values: [-1,10000]</p>
@ -1550,7 +1550,7 @@ list of <a href="gdk3-Windows.html#GdkWindow-struct"><span class="type">GdkWindo
<a name="GdkScreen-composited-changed"></a><h3>The <code class="literal">“composited-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gpointer</span> user_data)</pre>
<p>The ::composited-changed signal is emitted when the composited
status of the screen changes</p>
<div class="refsect3">
@ -1575,7 +1575,7 @@ status of the screen changes</p>
</tbody>
</table></div>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
@ -1583,7 +1583,7 @@ status of the screen changes</p>
<a name="GdkScreen-monitors-changed"></a><h3>The <code class="literal">“monitors-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gpointer</span> user_data)</pre>
<p>The ::monitors-changed signal is emitted when the number, size
or position of the monitors attached to the screen change. </p>
<p>Only for X11 and OS X for now. A future implementation for Win32
@ -1610,7 +1610,7 @@ may be a possibility.</p>
</tbody>
</table></div>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.14</p>
</div>
<hr>
@ -1618,7 +1618,7 @@ may be a possibility.</p>
<a name="GdkScreen-size-changed"></a><h3>The <code class="literal">“size-changed”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GdkScreen.html" title="GdkScreen"><span class="type">GdkScreen</span></a> *screen,
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)</pre>
<span class="type">gpointer</span> user_data)</pre>
<p>The ::size-changed signal is emitted when the pixel width or
height of a screen changes.</p>
@ -1644,12 +1644,12 @@ height of a screen changes.</p>
</tbody>
</table></div>
</div>
<p>Flags: <a href="https://developer.gnome.org/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS">Run Last</a></p>
<p>Flags: Run Last</p>
<p class="since">Since: 2.2</p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.28</div>
<hr>Generated by GTK-Doc V1.29</div>
</body>
</html>