RubyGems - gdk3 - Versions diffs - 1.2.0-x86-mingw32 - Mend

gdk3 1.2.0-x86-mingw32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1337) hide show

data/vendor/local/share/gtk-doc/html/gdk3/gdk3-General.html ADDED Viewed

@@ -0,0 +1,952 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>General</title>
+<meta name="generator" content="DocBook XSL Stylesheets V1.78.0">
+<link rel="home" href="index.html" title="GDK 3 Reference Manual">
+<link rel="up" href="reference.html" title="API Reference">
+<link rel="prev" href="reference.html" title="API Reference">
+<link rel="next" href="GdkDisplayManager.html" title="GdkDisplayManager">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
+<link rel="stylesheet" href="style.css" type="text/css">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
+<tr valign="middle">
+<td><a accesskey="p" href="reference.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
+<td><a accesskey="u" href="reference.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
+<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
+<th width="100%" align="center">GDK 3 Reference Manual</th>
+<td><a accesskey="n" href="GdkDisplayManager.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
+</tr>
+<tr><td colspan="5" class="shortcuts">
+<a href="#gdk3-General.synopsis" class="shortcut">Top</a>
+                   |
+                  <a href="#gdk3-General.description" class="shortcut">Description</a>
+</td></tr>
+</table>
+<div class="refentry">
+<a name="gdk3-General"></a><div class="titlepage"></div>
+<div class="refnamediv"><table width="100%"><tr>
+<td valign="top">
+<h2><span class="refentrytitle"><a name="gdk3-General.top_of_page"></a>General</span></h2>
+<p>General — Library initialization and miscellaneous functions</p>
+</td>
+<td valign="top" align="right"></td>
+</tr></table></div>
+<div class="refsynopsisdiv">
+<a name="gdk3-General.synopsis"></a><h2>Synopsis</h2>
+<pre class="synopsis">
+#include &lt;gdk/gdk.h&gt;
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-init" title="gdk_init ()">gdk_init</a>                            (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gdk3-General.html#gdk-init-check" title="gdk_init_check ()">gdk_init_check</a>                      (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-parse-args" title="gdk_parse_args ()">gdk_parse_args</a>                      (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="gdk3-General.html#gdk-get-display-arg-name" title="gdk_get_display_arg_name ()">gdk_get_display_arg_name</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-notify-startup-complete" title="gdk_notify_startup_complete ()">gdk_notify_startup_complete</a>         (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-notify-startup-complete-with-id" title="gdk_notify_startup_complete_with_id ()">gdk_notify_startup_complete_with_id</a> (<em class="parameter"><code>const <span class="type">gchar</span> *startup_id</code></em>);
+const <span class="returnvalue">gchar</span> *       <a class="link" href="gdk3-General.html#gdk-get-program-class" title="gdk_get_program_class ()">gdk_get_program_class</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-set-program-class" title="gdk_set_program_class ()">gdk_set_program_class</a>               (<em class="parameter"><code>const <span class="type">gchar</span> *program_class</code></em>);
+<span class="returnvalue">gchar</span> *             <a class="link" href="gdk3-General.html#gdk-get-display" title="gdk_get_display ()">gdk_get_display</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-flush" title="gdk_flush ()">gdk_flush</a>                           (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="gdk3-General.html#gdk-screen-width" title="gdk_screen_width ()">gdk_screen_width</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="gdk3-General.html#gdk-screen-height" title="gdk_screen_height ()">gdk_screen_height</a>                   (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="gdk3-General.html#gdk-screen-width-mm" title="gdk_screen_width_mm ()">gdk_screen_width_mm</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="gdk3-General.html#gdk-screen-height-mm" title="gdk_screen_height_mm ()">gdk_screen_height_mm</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
+<a class="link" href="gdk3-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       <a class="link" href="gdk3-General.html#gdk-pointer-grab" title="gdk_pointer_grab ()">gdk_pointer_grab</a>                    (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> owner_events</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *confine_to</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
+enum                <a class="link" href="gdk3-General.html#GdkGrabStatus" title="enum GdkGrabStatus">GdkGrabStatus</a>;
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-pointer-ungrab" title="gdk_pointer_ungrab ()">gdk_pointer_ungrab</a>                  (<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
+<span class="returnvalue">gboolean</span>            <a class="link" href="gdk3-General.html#gdk-pointer-is-grabbed" title="gdk_pointer_is_grabbed ()">gdk_pointer_is_grabbed</a>              (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-set-double-click-time" title="gdk_set_double_click_time ()">gdk_set_double_click_time</a>           (<em class="parameter"><code><span class="type">guint</span> msec</code></em>);
+<a class="link" href="gdk3-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       <a class="link" href="gdk3-General.html#gdk-keyboard-grab" title="gdk_keyboard_grab ()">gdk_keyboard_grab</a>                   (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> owner_events</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-keyboard-ungrab" title="gdk_keyboard_ungrab ()">gdk_keyboard_ungrab</a>                 (<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-beep" title="gdk_beep ()">gdk_beep</a>                            (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-error-trap-push" title="gdk_error_trap_push ()">gdk_error_trap_push</a>                 (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">gint</span>                <a class="link" href="gdk3-General.html#gdk-error-trap-pop" title="gdk_error_trap_pop ()">gdk_error_trap_pop</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
+<span class="returnvalue">void</span>                <a class="link" href="gdk3-General.html#gdk-error-trap-pop-ignored" title="gdk_error_trap_pop_ignored ()">gdk_error_trap_pop_ignored</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
+#define             <a class="link" href="gdk3-General.html#GDK-WINDOWING-X11:CAPS" title="GDK_WINDOWING_X11">GDK_WINDOWING_X11</a>
+#define             <a class="link" href="gdk3-General.html#GDK-WINDOWING-WIN32:CAPS" title="GDK_WINDOWING_WIN32">GDK_WINDOWING_WIN32</a>
+#define             <a class="link" href="gdk3-General.html#GDK-VERSION-3-0:CAPS" title="GDK_VERSION_3_0">GDK_VERSION_3_0</a>
+#define             <a class="link" href="gdk3-General.html#GDK-VERSION-3-2:CAPS" title="GDK_VERSION_3_2">GDK_VERSION_3_2</a>
+#define             <a class="link" href="gdk3-General.html#GDK-VERSION-3-4:CAPS" title="GDK_VERSION_3_4">GDK_VERSION_3_4</a>
+#define             <a class="link" href="gdk3-General.html#GDK-VERSION-MIN-REQUIRED:CAPS" title="GDK_VERSION_MIN_REQUIRED">GDK_VERSION_MIN_REQUIRED</a>
+#define             <a class="link" href="gdk3-General.html#GDK-VERSION-MAX-ALLOWED:CAPS" title="GDK_VERSION_MAX_ALLOWED">GDK_VERSION_MAX_ALLOWED</a>
+</pre>
+</div>
+<div class="refsect1">
+<a name="gdk3-General.description"></a><h2>Description</h2>
+<p>
+This section describes the GDK initialization functions and miscellaneous
+utility functions, as well as deprecation facilities.
+</p>
+<p>
+The GDK and GTK+ headers annotate deprecated APIs in a way that produces
+compiler warnings if these deprecated APIs are used. The warnings
+can be turned off by defining the macro <code class="literal">GDK_DISABLE_DEPRECATION_WARNINGS</code>
+before including the glib.h header.
+</p>
+<p>
+GDK and GTK+ also provide support for building applications against
+defined subsets of deprecated or new APIs. Define the macro
+<a class="link" href="gdk3-General.html#GDK-VERSION-MIN-REQUIRED:CAPS" title="GDK_VERSION_MIN_REQUIRED"><code class="literal">GDK_VERSION_MIN_REQUIRED</code></a> to specify up to what version
+you want to receive warnings about deprecated APIs. Define the
+macro <a class="link" href="gdk3-General.html#GDK-VERSION-MAX-ALLOWED:CAPS" title="GDK_VERSION_MAX_ALLOWED"><code class="literal">GDK_VERSION_MAX_ALLOWED</code></a> to specify the newest version
+whose API you want to use.
+</p>
+</div>
+<div class="refsect1">
+<a name="gdk3-General.details"></a><h2>Details</h2>
+<div class="refsect2">
+<a name="gdk-init"></a><h3>gdk_init ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_init                            (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);</pre>
+<p>
+Initializes the GDK library and connects to the windowing system.
+If initialization fails, a warning message is output and the application
+terminates with a call to <code class="literal">exit(1)</code>.
+</p>
+<p>
+Any arguments used by GDK are removed from the array and <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em>
+are updated accordingly.
+</p>
+<p>
+GTK+ initializes GDK in <a href="http://library.gnome.org/devel/gtk3/gtk2-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually
+needed by GTK+ applications.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
+<td>the number of command line arguments. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
+<td>the array of command line arguments. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-init-check"></a><h3>gdk_init_check ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_init_check                      (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);</pre>
+<p>
+Initializes the GDK library and connects to the windowing system,
+returning <code class="literal">TRUE</code> on success.
+</p>
+<p>
+Any arguments used by GDK are removed from the array and <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em>
+are updated accordingly.
+</p>
+<p>
+GTK+ initializes GDK in <a href="http://library.gnome.org/devel/gtk3/gtk2-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually
+needed by GTK+ applications.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
+<td>the number of command line arguments. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
+<td>the array of command line arguments. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc][<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if initialization succeeded.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-parse-args"></a><h3>gdk_parse_args ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_parse_args                      (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
+                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);</pre>
+<p>
+Parse command line arguments, and store for future
+use by calls to <a class="link" href="GdkDisplay.html#gdk-display-open" title="gdk_display_open ()"><code class="function">gdk_display_open()</code></a>.
+</p>
+<p>
+Any arguments used by GDK are removed from the array and <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em> are
+updated accordingly.
+</p>
+<p>
+You shouldn't call this function explicitely if you are using
+<a href="http://library.gnome.org/devel/gtk3/gtk2-General.html#gtk-init"><code class="function">gtk_init()</code></a>, <a href="http://library.gnome.org/devel/gtk3/gtk2-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a>, <a class="link" href="gdk3-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a>, or <a class="link" href="gdk3-General.html#gdk-init-check" title="gdk_init_check ()"><code class="function">gdk_init_check()</code></a>.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argc</code></em> :</span></p></td>
+<td>the number of command line arguments.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>argv</code></em> :</span></p></td>
+<td>the array of command line arguments. <span class="annotation">[<acronym title="Parameter for input and for returning results. Default is transfer full."><span class="acronym">inout</span></acronym>][<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> length=argc]</span>
+</td>
+</tr>
+</tbody>
+</table></div>
+<p class="since">Since 2.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-get-display-arg-name"></a><h3>gdk_get_display_arg_name ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gdk_get_display_arg_name            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Gets the display name specified in the command line arguments passed
+to <a class="link" href="gdk3-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a> or <a class="link" href="gdk3-General.html#gdk-parse-args" title="gdk_parse_args ()"><code class="function">gdk_parse_args()</code></a>, if any.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the display name, if specified explicitely, otherwise <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
+this string is owned by GTK+ and must not be modified or freed.</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-notify-startup-complete"></a><h3>gdk_notify_startup_complete ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_notify_startup_complete         (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Indicates to the GUI environment that the application has finished
+loading. If the applications opens windows, this function is
+normally called after opening the application's initial set of
+windows.
+</p>
+<p>
+GTK+ will call this function automatically after opening the first
+<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> unless <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called
+to disable that feature.
+</p>
+<p class="since">Since 2.2</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-notify-startup-complete-with-id"></a><h3>gdk_notify_startup_complete_with_id ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_notify_startup_complete_with_id (<em class="parameter"><code>const <span class="type">gchar</span> *startup_id</code></em>);</pre>
+<p>
+Indicates to the GUI environment that the application has
+finished loading, using a given identifier.
+</p>
+<p>
+GTK+ will call this function automatically for <a href="http://library.gnome.org/devel/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a>
+with custom startup-notification identifier unless
+<a href="http://library.gnome.org/devel/gtk3/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called to
+disable that feature.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>startup_id</code></em> :</span></p></td>
+<td>a startup-notification identifier, for which
+notification process should be completed</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.12</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-get-program-class"></a><h3>gdk_get_program_class ()</h3>
+<pre class="programlisting">const <span class="returnvalue">gchar</span> *       gdk_get_program_class               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Gets the program class. Unless the program class has explicitly
+been set with <a class="link" href="gdk3-General.html#gdk-set-program-class" title="gdk_set_program_class ()"><code class="function">gdk_set_program_class()</code></a> or with the <code class="option">--class</code>
+commandline option, the default value is the program name (determined
+with <code class="function">g_get_prgname()</code>) with the first character converted to uppercase.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the program class.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-set-program-class"></a><h3>gdk_set_program_class ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_program_class               (<em class="parameter"><code>const <span class="type">gchar</span> *program_class</code></em>);</pre>
+<p>
+Sets the program class. The X11 backend uses the program class to set
+the class name part of the <code class="literal">WM_CLASS</code> property on
+toplevel windows; see the ICCCM.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>program_class</code></em> :</span></p></td>
+<td>a string.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-get-display"></a><h3>gdk_get_display ()</h3>
+<pre class="programlisting"><span class="returnvalue">gchar</span> *             gdk_get_display                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Gets the name of the display, which usually comes from the
+<code class="envar">DISPLAY</code> environment variable or the
+<code class="option">--display</code> command line option.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the name of the display.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-flush"></a><h3>gdk_flush ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_flush                           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Flushes the output buffers of all display connections and waits
+until all requests have been processed.
+This is rarely needed by applications.
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-screen-width"></a><h3>gdk_screen_width ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_screen_width                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Returns the width of the default screen in pixels.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the width of the default screen in pixels.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-screen-height"></a><h3>gdk_screen_height ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_screen_height                   (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Returns the height of the default screen in pixels.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the height of the default screen in pixels.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-screen-width-mm"></a><h3>gdk_screen_width_mm ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_screen_width_mm                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Returns the width of the default screen in millimeters.
+Note that on many X servers this value will not be correct.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the width of the default screen in millimeters,
+though it is not always correct.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-screen-height-mm"></a><h3>gdk_screen_height_mm ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_screen_height_mm                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Returns the height of the default screen in millimeters.
+Note that on many X servers this value will not be correct.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>the height of the default screen in millimeters,
+though it is not always correct.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-pointer-grab"></a><h3>gdk_pointer_grab ()</h3>
+<pre class="programlisting"><a class="link" href="gdk3-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       gdk_pointer_grab                    (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> owner_events</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *confine_to</code></em>,
+                                                         <em class="parameter"><code><a class="link" href="gdk3-Cursors.html#GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gdk_pointer_grab</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDevice.html#gdk-device-grab" title="gdk_device_grab ()"><code class="function">gdk_device_grab()</code></a> instead.</p>
+</div>
+<p>
+Grabs the pointer (usually a mouse) so that all events are passed to this
+application until the pointer is ungrabbed with <a class="link" href="gdk3-General.html#gdk-pointer-ungrab" title="gdk_pointer_ungrab ()"><code class="function">gdk_pointer_ungrab()</code></a>, or
+the grab window becomes unviewable.
+This overrides any previous pointer grab by this client.
+</p>
+<p>
+Pointer grabs are used for operations which need complete control over mouse
+events, even if the mouse leaves the application.
+For example in GTK+ it is used for Drag and Drop, for dragging the handle in
+the <a href="http://library.gnome.org/devel/gtk3/GtkHPaned.html"><span class="type">GtkHPaned</span></a> and <a href="http://library.gnome.org/devel/gtk3/GtkVPaned.html"><span class="type">GtkVPaned</span></a> widgets.
+</p>
+<p>
+Note that if the event mask of an X window has selected both button press and
+button release events, then a button press event will cause an automatic
+pointer grab until the button is released.
+X does this automatically since most applications expect to receive button
+press and release events in pairs.
+It is equivalent to a pointer grab on the window with <em class="parameter"><code>owner_events</code></em> set to
+<code class="literal">TRUE</code>.
+</p>
+<p>
+If you set up anything at the time you take the grab that needs to be cleaned
+up when the grab ends, you should handle the <a class="link" href="gdk3-Event-Structures.html#GdkEventGrabBroken" title="struct GdkEventGrabBroken"><span class="type">GdkEventGrabBroken</span></a> events that
+are emitted when the grab ends unvoluntarily.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
+<td>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> which will own the grab (the grab window).</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>owner_events</code></em> :</span></p></td>
+<td>if <code class="literal">FALSE</code> then all pointer events are reported with respect to
+<em class="parameter"><code>window</code></em> and are only reported if selected by <em class="parameter"><code>event_mask</code></em>. If <code class="literal">TRUE</code> then pointer
+events for this application are reported as normal, but pointer events outside
+this application are reported with respect to <em class="parameter"><code>window</code></em> and only if selected by
+<em class="parameter"><code>event_mask</code></em>. In either mode, unreported events are discarded.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>event_mask</code></em> :</span></p></td>
+<td>specifies the event mask, which is used in accordance with
+<em class="parameter"><code>owner_events</code></em>. Note that only pointer events (i.e. button and motion events)
+may be selected.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>confine_to</code></em> :</span></p></td>
+<td>If non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, the pointer will be confined to this
+window during the grab. If the pointer is outside <em class="parameter"><code>confine_to</code></em>, it will
+automatically be moved to the closest edge of <em class="parameter"><code>confine_to</code></em> and enter
+and leave events will be generated as necessary. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
+<td>the cursor to display while the grab is active. If this is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> then
+the normal cursors are used for <em class="parameter"><code>window</code></em> and its descendants, and the cursor
+for <em class="parameter"><code>window</code></em> is used for all other windows. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
+</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
+<td>the timestamp of the event which led to this pointer grab. This usually
+comes from a <a class="link" href="gdk3-Event-Structures.html#GdkEventButton" title="struct GdkEventButton"><span class="type">GdkEventButton</span></a> struct, though <a class="link" href="gdk3-Events.html#GDK-CURRENT-TIME:CAPS" title="GDK_CURRENT_TIME"><code class="literal">GDK_CURRENT_TIME</code></a> can be used if
+the time isn't known.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<a class="link" href="gdk3-General.html#GDK-GRAB-SUCCESS:CAPS"><code class="literal">GDK_GRAB_SUCCESS</code></a> if the grab was successful.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GdkGrabStatus"></a><h3>enum GdkGrabStatus</h3>
+<pre class="programlisting">typedef enum {
+  GDK_GRAB_SUCCESS         = 0,
+  GDK_GRAB_ALREADY_GRABBED = 1,
+  GDK_GRAB_INVALID_TIME    = 2,
+  GDK_GRAB_NOT_VIEWABLE    = 3,
+  GDK_GRAB_FROZEN          = 4
+} GdkGrabStatus;
+</pre>
+<p>
+Returned by <a class="link" href="gdk3-General.html#gdk-pointer-grab" title="gdk_pointer_grab ()"><code class="function">gdk_pointer_grab()</code></a> and <a class="link" href="gdk3-General.html#gdk-keyboard-grab" title="gdk_keyboard_grab ()"><code class="function">gdk_keyboard_grab()</code></a> to indicate
+success or the reason for the failure of the grab attempt.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><a name="GDK-GRAB-SUCCESS:CAPS"></a><span class="term"><code class="literal">GDK_GRAB_SUCCESS</code></span></p></td>
+<td>the resource was successfully grabbed.
+</td>
+</tr>
+<tr>
+<td><p><a name="GDK-GRAB-ALREADY-GRABBED:CAPS"></a><span class="term"><code class="literal">GDK_GRAB_ALREADY_GRABBED</code></span></p></td>
+<td>the resource is actively grabbed by another client.
+</td>
+</tr>
+<tr>
+<td><p><a name="GDK-GRAB-INVALID-TIME:CAPS"></a><span class="term"><code class="literal">GDK_GRAB_INVALID_TIME</code></span></p></td>
+<td>the resource was grabbed more recently than the
+ specified time.
+</td>
+</tr>
+<tr>
+<td><p><a name="GDK-GRAB-NOT-VIEWABLE:CAPS"></a><span class="term"><code class="literal">GDK_GRAB_NOT_VIEWABLE</code></span></p></td>
+<td>the grab window or the <em class="parameter"><code>confine_to</code></em> window are not
+ viewable.
+</td>
+</tr>
+<tr>
+<td><p><a name="GDK-GRAB-FROZEN:CAPS"></a><span class="term"><code class="literal">GDK_GRAB_FROZEN</code></span></p></td>
+<td>the resource is frozen by an active grab of another client.
+</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-pointer-ungrab"></a><h3>gdk_pointer_ungrab ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_pointer_ungrab                  (<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gdk_pointer_ungrab</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDevice.html#gdk-device-ungrab" title="gdk_device_ungrab ()"><code class="function">gdk_device_ungrab()</code></a>, together with <a class="link" href="GdkDevice.html#gdk-device-grab" title="gdk_device_grab ()"><code class="function">gdk_device_grab()</code></a>
+            instead.</p>
+</div>
+<p>
+Ungrabs the pointer on the default display, if it is grabbed by this
+application.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
+<td>a timestamp from a <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a>, or <a class="link" href="gdk3-Events.html#GDK-CURRENT-TIME:CAPS" title="GDK_CURRENT_TIME"><code class="literal">GDK_CURRENT_TIME</code></a> if no
+timestamp is available.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-pointer-is-grabbed"></a><h3>gdk_pointer_is_grabbed ()</h3>
+<pre class="programlisting"><span class="returnvalue">gboolean</span>            gdk_pointer_is_grabbed              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gdk_pointer_is_grabbed</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDisplay.html#gdk-display-device-is-grabbed" title="gdk_display_device_is_grabbed ()"><code class="function">gdk_display_device_is_grabbed()</code></a> instead.</p>
+</div>
+<p>
+Returns <code class="literal">TRUE</code> if the pointer on the default display is currently
+grabbed by this application.
+</p>
+<p>
+Note that this does not take the inmplicit pointer grab on button
+presses into account.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<code class="literal">TRUE</code> if the pointer is currently grabbed by this application.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-set-double-click-time"></a><h3>gdk_set_double_click_time ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_double_click_time           (<em class="parameter"><code><span class="type">guint</span> msec</code></em>);</pre>
+<p>
+Set the double click time for the default display. See
+<a class="link" href="GdkDisplay.html#gdk-display-set-double-click-time" title="gdk_display_set_double_click_time ()"><code class="function">gdk_display_set_double_click_time()</code></a>.
+See also <a class="link" href="GdkDisplay.html#gdk-display-set-double-click-distance" title="gdk_display_set_double_click_distance ()"><code class="function">gdk_display_set_double_click_distance()</code></a>.
+Applications should <span class="emphasis"><em>not</em></span> set this, it is a
+global user-configured setting.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>msec</code></em> :</span></p></td>
+<td>double click time in milliseconds (thousandths of a second)</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-keyboard-grab"></a><h3>gdk_keyboard_grab ()</h3>
+<pre class="programlisting"><a class="link" href="gdk3-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       gdk_keyboard_grab                   (<em class="parameter"><code><a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
+                                                         <em class="parameter"><code><span class="type">gboolean</span> owner_events</code></em>,
+                                                         <em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gdk_keyboard_grab</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDevice.html#gdk-device-grab" title="gdk_device_grab ()"><code class="function">gdk_device_grab()</code></a> instead.</p>
+</div>
+<p>
+Grabs the keyboard so that all events are passed to this
+application until the keyboard is ungrabbed with <a class="link" href="gdk3-General.html#gdk-keyboard-ungrab" title="gdk_keyboard_ungrab ()"><code class="function">gdk_keyboard_ungrab()</code></a>.
+This overrides any previous keyboard grab by this client.
+</p>
+<p>
+If you set up anything at the time you take the grab that needs to be cleaned
+up when the grab ends, you should handle the <a class="link" href="gdk3-Event-Structures.html#GdkEventGrabBroken" title="struct GdkEventGrabBroken"><span class="type">GdkEventGrabBroken</span></a> events that
+are emitted when the grab ends unvoluntarily.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>window</code></em> :</span></p></td>
+<td>the <a class="link" href="gdk3-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> which will own the grab (the grab window).</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>owner_events</code></em> :</span></p></td>
+<td>if <code class="literal">FALSE</code> then all keyboard events are reported with respect to
+<em class="parameter"><code>window</code></em>. If <code class="literal">TRUE</code> then keyboard events for this application are
+reported as normal, but keyboard events outside this application
+are reported with respect to <em class="parameter"><code>window</code></em>. Both key press and key
+release events are always reported, independant of the event mask
+set by the application.</td>
+</tr>
+<tr>
+<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
+<td>a timestamp from a <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a>, or <a class="link" href="gdk3-Events.html#GDK-CURRENT-TIME:CAPS" title="GDK_CURRENT_TIME"><code class="literal">GDK_CURRENT_TIME</code></a> if no timestamp is
+available.</td>
+</tr>
+<tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>
+<a class="link" href="gdk3-General.html#GDK-GRAB-SUCCESS:CAPS"><code class="literal">GDK_GRAB_SUCCESS</code></a> if the grab was successful.</td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-keyboard-ungrab"></a><h3>gdk_keyboard_ungrab ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_keyboard_ungrab                 (<em class="parameter"><code><span class="type">guint32</span> time_</code></em>);</pre>
+<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
+<h3 class="title">Warning</h3>
+<p><code class="literal">gdk_keyboard_ungrab</code> has been deprecated since version 3.0 and should not be used in newly-written code. Use <a class="link" href="GdkDevice.html#gdk-device-ungrab" title="gdk_device_ungrab ()"><code class="function">gdk_device_ungrab()</code></a>, together with <a class="link" href="GdkDevice.html#gdk-device-grab" title="gdk_device_grab ()"><code class="function">gdk_device_grab()</code></a>
+            instead.</p>
+</div>
+<p>
+Ungrabs the keyboard on the default display, if it is grabbed by this
+application.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><em class="parameter"><code>time_</code></em> :</span></p></td>
+<td>a timestamp from a <a class="link" href="gdk3-Event-Structures.html#GdkEvent" title="union GdkEvent"><span class="type">GdkEvent</span></a>, or <a class="link" href="gdk3-Events.html#GDK-CURRENT-TIME:CAPS" title="GDK_CURRENT_TIME"><code class="literal">GDK_CURRENT_TIME</code></a> if no
+timestamp is available.</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-beep"></a><h3>gdk_beep ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_beep                            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Emits a short beep on the default display.
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-error-trap-push"></a><h3>gdk_error_trap_push ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_error_trap_push                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+This function allows X errors to be trapped instead of the normal
+behavior of exiting the application. It should only be used if it
+is not possible to avoid the X error in any other way. Errors are
+ignored on all <a class="link" href="GdkDisplay.html" title="GdkDisplay"><span class="type">GdkDisplay</span></a> currently known to the
+<a class="link" href="GdkDisplayManager.html" title="GdkDisplayManager"><span class="type">GdkDisplayManager</span></a>. If you don't care which error happens and just
+want to ignore everything, pop with <a class="link" href="gdk3-General.html#gdk-error-trap-pop-ignored" title="gdk_error_trap_pop_ignored ()"><code class="function">gdk_error_trap_pop_ignored()</code></a>.
+If you need the error code, use <a class="link" href="gdk3-General.html#gdk-error-trap-pop" title="gdk_error_trap_pop ()"><code class="function">gdk_error_trap_pop()</code></a> which may have
+to block and wait for the error to arrive from the X server.
+</p>
+<p>
+This API exists on all platforms but only does anything on X.
+</p>
+<p>
+You can use <a class="link" href="gdk3-X-Window-System-Interaction.html#gdk-x11-display-error-trap-push" title="gdk_x11_display_error_trap_push ()"><code class="function">gdk_x11_display_error_trap_push()</code></a> to ignore errors
+on only a single display.
+</p>
+<p>
+</p>
+<div class="example">
+<a name="idm139727039036144"></a><p class="title"><b>Example 1. Trapping an X error</b></p>
+<div class="example-contents">
+  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
+    <tbody>
+      <tr>
+        <td class="listing_lines" align="right"><pre>1
+2
+3
+4
+5
+6
+7
+8
+9</pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="gdk3-General.html#gdk-error-trap-push">gdk_error_trap_push</a></span><span class="normal"> </span><span class="symbol">();</span>
+<span class="normal"> </span><span class="comment">// ... Call the X function which may cause an error here ...</span>
+<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="gdk3-General.html#gdk-error-trap-pop">gdk_error_trap_pop</a></span><span class="normal"> </span><span class="symbol">())</span>
+<span class="normal"> </span><span class="cbracket">{</span>
+<span class="normal">   </span><span class="comment">// ... Handle the error here ...</span>
+<span class="normal"> </span><span class="cbracket">}</span></pre></td>
+      </tr>
+    </tbody>
+  </table>
+</div>
+</div>
+<p><br class="example-break">
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-error-trap-pop"></a><h3>gdk_error_trap_pop ()</h3>
+<pre class="programlisting"><span class="returnvalue">gint</span>                gdk_error_trap_pop                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Removes an error trap pushed with <a class="link" href="gdk3-General.html#gdk-error-trap-push" title="gdk_error_trap_push ()"><code class="function">gdk_error_trap_push()</code></a>.
+May block until an error has been definitively received
+or not received from the X server. <a class="link" href="gdk3-General.html#gdk-error-trap-pop-ignored" title="gdk_error_trap_pop_ignored ()"><code class="function">gdk_error_trap_pop_ignored()</code></a>
+is preferred if you don't need to know whether an error
+occurred, because it never has to block. If you don't
+need the return value of <a class="link" href="gdk3-General.html#gdk-error-trap-pop" title="gdk_error_trap_pop ()"><code class="function">gdk_error_trap_pop()</code></a>, use
+<a class="link" href="gdk3-General.html#gdk-error-trap-pop-ignored" title="gdk_error_trap_pop_ignored ()"><code class="function">gdk_error_trap_pop_ignored()</code></a>.
+</p>
+<p>
+Prior to GDK 3.0, this function would not automatically
+sync for you, so you had to <a class="link" href="gdk3-General.html#gdk-flush" title="gdk_flush ()"><code class="function">gdk_flush()</code></a> if your last
+call to Xlib was not a blocking round trip.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>X error code or 0 on success</td>
+</tr></tbody>
+</table></div>
+</div>
+<hr>
+<div class="refsect2">
+<a name="gdk-error-trap-pop-ignored"></a><h3>gdk_error_trap_pop_ignored ()</h3>
+<pre class="programlisting"><span class="returnvalue">void</span>                gdk_error_trap_pop_ignored          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Removes an error trap pushed with <a class="link" href="gdk3-General.html#gdk-error-trap-push" title="gdk_error_trap_push ()"><code class="function">gdk_error_trap_push()</code></a>, but
+without bothering to wait and see whether an error occurred.  If an
+error arrives later asynchronously that was triggered while the
+trap was pushed, that error will be ignored.
+</p>
+<p class="since">Since 3.0</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-WINDOWING-X11:CAPS"></a><h3>GDK_WINDOWING_X11</h3>
+<pre class="programlisting">#define GDK_WINDOWING_X11
+</pre>
+<p>
+The <a class="link" href="gdk3-General.html#GDK-WINDOWING-X11:CAPS" title="GDK_WINDOWING_X11"><span class="type">GDK_WINDOWING_X11</span></a> macro is defined if the X11 backend
+is supported.
+</p>
+<p>
+Use this macro to guard code that is specific to the X11 backend.
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-WINDOWING-WIN32:CAPS"></a><h3>GDK_WINDOWING_WIN32</h3>
+<pre class="programlisting">#define GDK_WINDOWING_WIN32
+</pre>
+<p>
+The <a class="link" href="gdk3-General.html#GDK-WINDOWING-WIN32:CAPS" title="GDK_WINDOWING_WIN32"><span class="type">GDK_WINDOWING_WIN32</span></a> macro is defined if the Win32 backend
+is supported.
+</p>
+<p>
+Use this macro to guard code that is specific to the Win32 backend.
+</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-VERSION-3-0:CAPS"></a><h3>GDK_VERSION_3_0</h3>
+<pre class="programlisting">#define GDK_VERSION_3_0         (G_ENCODE_VERSION (3, 0))
+</pre>
+<p>
+A macro that evaluates to the 3.0 version of GDK, in a format
+that can be used by the C pre-processor.
+</p>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-VERSION-3-2:CAPS"></a><h3>GDK_VERSION_3_2</h3>
+<pre class="programlisting">#define GDK_VERSION_3_2         (G_ENCODE_VERSION (3, 2))
+</pre>
+<p>
+A macro that evaluates to the 3.2 version of GDK, in a format
+that can be used by the C pre-processor.
+</p>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-VERSION-3-4:CAPS"></a><h3>GDK_VERSION_3_4</h3>
+<pre class="programlisting">#define GDK_VERSION_3_4         (G_ENCODE_VERSION (3, 4))
+</pre>
+<p>
+A macro that evaluates to the 3.4 version of GDK, in a format
+that can be used by the C pre-processor.
+</p>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-VERSION-MIN-REQUIRED:CAPS"></a><h3>GDK_VERSION_MIN_REQUIRED</h3>
+<pre class="programlisting"># define GDK_VERSION_MIN_REQUIRED      (GDK_VERSION_CUR_STABLE)
+</pre>
+<p>
+A macro that should be defined by the user prior to including
+the gdk.h header.
+The definition should be one of the predefined GDK version
+macros: <a class="link" href="gdk3-General.html#GDK-VERSION-3-0:CAPS" title="GDK_VERSION_3_0"><code class="literal">GDK_VERSION_3_0</code></a>, <a class="link" href="gdk3-General.html#GDK-VERSION-3-2:CAPS" title="GDK_VERSION_3_2"><code class="literal">GDK_VERSION_3_2</code></a>,...
+</p>
+<p>
+This macro defines the lower bound for the GDK API to use.
+</p>
+<p>
+If a function has been deprecated in a newer version of GDK,
+it is possible to use this symbol to avoid the compiler warnings
+without disabling warning for every deprecated function.
+</p>
+<p class="since">Since 3.4</p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GDK-VERSION-MAX-ALLOWED:CAPS"></a><h3>GDK_VERSION_MAX_ALLOWED</h3>
+<pre class="programlisting">#  define GDK_VERSION_MAX_ALLOWED      GDK_VERSION_MIN_REQUIRED
+</pre>
+<p>
+A macro that should be defined by the user prior to including
+the gdk.h header.
+The definition should be one of the predefined GDK version
+macros: <a class="link" href="gdk3-General.html#GDK-VERSION-3-0:CAPS" title="GDK_VERSION_3_0"><code class="literal">GDK_VERSION_3_0</code></a>, <a class="link" href="gdk3-General.html#GDK-VERSION-3-2:CAPS" title="GDK_VERSION_3_2"><code class="literal">GDK_VERSION_3_2</code></a>,...
+</p>
+<p>
+This macro defines the upper bound for the GDK API to use.
+</p>
+<p>
+If a function has been introduced in a newer version of GDK,
+it is possible to use this symbol to get compiler warnings when
+trying to use that function.
+</p>
+<p class="since">Since 3.4</p>
+</div>
+</div>
+</div>
+<div class="footer">
+<hr>
+          Generated by GTK-Doc V1.18.1</div>
+</body>
+</html>