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

gdk3 1.2.0-x86-mingw32

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>