← Back to branch summary

~canonical-dx-team/ubuntu/maverick/gtk+2.0/menuproxy

« back to all changes in this revision

Viewing changes to docs/reference/gdk/html/gdk-General.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2010-06-11 12:19:30 UTC
  • mfrom: (1.11.6 upstream)
  • mto: This revision was merged to the branch mainline in revision 175.
  • Revision ID: james.westby@ubuntu.com-20100611121930-n4pklvkoqdsg12vm
Tags: 2.21.2-1
* New upstream development release:
  + debian/rules,
    debian/libgtk2.0-0.symbols:
    - Update for new API symbols.
  + debian/patches/070_mandatory-relibtoolize.patch:
    - Regenerated for the new version.
  + debian/control.in:
    - Update GLib (build-) dependency to >= 2.25.8.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gdk/html/gdk-General.html
40
40
<pre class="synopsis">
41
41
#include &lt;gdk/gdk.h&gt;
42
42
 
43
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-init" title="gdk_init ()">gdk_init</a>                            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
44
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
45
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-General.html#gdk-init-check" title="gdk_init_check ()">gdk_init_check</a>                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
46
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
47
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-parse-args" title="gdk_parse_args ()">gdk_parse_args</a>                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
48
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
49
 
const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="gdk-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>);
50
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              <a class="link" href="gdk-General.html#gdk-set-locale" title="gdk_set_locale ()">gdk_set_locale</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
51
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-sm-client-id" title="gdk_set_sm_client_id ()">gdk_set_sm_client_id</a>                (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);
52
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-exit" title="gdk_exit ()">gdk_exit</a>                            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> error_code</code></em>);
 
43
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-init" title="gdk_init ()">gdk_init</a>                            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
44
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
 
45
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-General.html#gdk-init-check" title="gdk_init_check ()">gdk_init_check</a>                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
46
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
 
47
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-parse-args" title="gdk_parse_args ()">gdk_parse_args</a>                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
48
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);
 
49
const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        <a class="link" href="gdk-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>);
 
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              <a class="link" href="gdk-General.html#gdk-set-locale" title="gdk_set_locale ()">gdk_set_locale</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
 
51
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-sm-client-id" title="gdk_set_sm_client_id ()">gdk_set_sm_client_id</a>                (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);
 
52
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-exit" title="gdk_exit ()">gdk_exit</a>                            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> error_code</code></em>);
53
53
<span class="returnvalue">void</span>                <a class="link" href="gdk-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>);
54
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-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 <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);
 
54
<span class="returnvalue">void</span>                <a class="link" href="gdk-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 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);
55
55
 
56
56
const <span class="returnvalue">char</span> *        <a class="link" href="gdk-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>);
57
57
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-program-class" title="gdk_set_program_class ()">gdk_set_program_class</a>               (<em class="parameter"><code>const <span class="type">char</span> *program_class</code></em>);
58
58
 
59
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              <a class="link" href="gdk-General.html#gdk-get-display" title="gdk_get_display ()">gdk_get_display</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
 
59
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              <a class="link" href="gdk-General.html#gdk-get-display" title="gdk_get_display ()">gdk_get_display</a>                     (<em class="parameter"><code><span class="type">void</span></code></em>);
60
60
 
61
61
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-flush" title="gdk_flush ()">gdk_flush</a>                           (<em class="parameter"><code><span class="type">void</span></code></em>);
62
62
 
63
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-General.html#gdk-screen-width" title="gdk_screen_width ()">gdk_screen_width</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
64
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-General.html#gdk-screen-height" title="gdk_screen_height ()">gdk_screen_height</a>                   (<em class="parameter"><code><span class="type">void</span></code></em>);
65
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
66
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
 
63
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-General.html#gdk-screen-width" title="gdk_screen_width ()">gdk_screen_width</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
 
64
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-General.html#gdk-screen-height" title="gdk_screen_height ()">gdk_screen_height</a>                   (<em class="parameter"><code><span class="type">void</span></code></em>);
 
65
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
 
66
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
67
67
 
68
68
<a class="link" href="gdk-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       <a class="link" href="gdk-General.html#gdk-pointer-grab" title="gdk_pointer_grab ()">gdk_pointer_grab</a>                    (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
69
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
 
69
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
70
70
                                                         <em class="parameter"><code><a class="link" href="gdk-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>,
71
71
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *confine_to</code></em>,
72
72
                                                         <em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>,
73
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
73
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
74
74
enum                <a class="link" href="gdk-General.html#GdkGrabStatus" title="enum GdkGrabStatus">GdkGrabStatus</a>;
75
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-pointer-ungrab" title="gdk_pointer_ungrab ()">gdk_pointer_ungrab</a>                  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
76
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-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>);
77
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-double-click-time" title="gdk_set_double_click_time ()">gdk_set_double_click_time</a>           (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msec</code></em>);
 
75
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-pointer-ungrab" title="gdk_pointer_ungrab ()">gdk_pointer_ungrab</a>                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
76
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-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>);
 
77
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-double-click-time" title="gdk_set_double_click_time ()">gdk_set_double_click_time</a>           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msec</code></em>);
78
78
 
79
79
<a class="link" href="gdk-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       <a class="link" href="gdk-General.html#gdk-keyboard-grab" title="gdk_keyboard_grab ()">gdk_keyboard_grab</a>                   (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
80
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
81
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
82
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-keyboard-ungrab" title="gdk_keyboard_ungrab ()">gdk_keyboard_ungrab</a>                 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
80
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
 
81
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
 
82
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-keyboard-ungrab" title="gdk_keyboard_ungrab ()">gdk_keyboard_ungrab</a>                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);
83
83
 
84
84
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-beep" title="gdk_beep ()">gdk_beep</a>                            (<em class="parameter"><code><span class="type">void</span></code></em>);
85
85
 
86
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-General.html#gdk-get-use-xshm" title="gdk_get_use_xshm ()">gdk_get_use_xshm</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
87
 
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-use-xshm" title="gdk_set_use_xshm ()">gdk_set_use_xshm</a>                    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_xshm</code></em>);
 
86
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gdk-General.html#gdk-get-use-xshm" title="gdk_get_use_xshm ()">gdk_get_use_xshm</a>                    (<em class="parameter"><code><span class="type">void</span></code></em>);
 
87
<span class="returnvalue">void</span>                <a class="link" href="gdk-General.html#gdk-set-use-xshm" title="gdk_set_use_xshm ()">gdk_set_use_xshm</a>                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_xshm</code></em>);
88
88
 
89
89
<span class="returnvalue">void</span>                <a class="link" href="gdk-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>);
90
 
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
 
90
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="gdk-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>);
91
91
 
92
92
#define             <a class="link" href="gdk-General.html#GDK-WINDOWING-X11:CAPS" title="GDK_WINDOWING_X11">GDK_WINDOWING_X11</a>
93
93
#define             <a class="link" href="gdk-General.html#GDK-WINDOWING-WIN32:CAPS" title="GDK_WINDOWING_WIN32">GDK_WINDOWING_WIN32</a>
104
104
<a name="gdk-General.details"></a><h2>Details</h2>
105
105
<div class="refsect2" title="gdk_init ()">
106
106
<a name="gdk-init"></a><h3>gdk_init ()</h3>
107
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_init                            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
108
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
 
107
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_init                            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
108
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
109
109
<p>
110
110
Initializes the GDK library and connects to the X server.
111
111
If initialization fails, a warning message is output and the application
116
116
updated accordingly.
117
117
</p>
118
118
<p>
119
 
GTK+ initializes GDK in <a href="/usr/share/gtk-doc/html/gtk3/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually needed
 
119
GTK+ initializes GDK in <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually needed
120
120
by GTK+ applications.
121
121
</p>
122
122
<div class="variablelist"><table border="0">
138
138
<hr>
139
139
<div class="refsect2" title="gdk_init_check ()">
140
140
<a name="gdk-init-check"></a><h3>gdk_init_check ()</h3>
141
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_init_check                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
142
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
 
141
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_init_check                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
142
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
143
143
<p>
144
144
Initialize the library for use.
145
145
</p>
163
163
--------------------------------------------------------------
164
164
</p>
165
165
<p>
166
 
Initializes the GDK library and connects to the X server, returning <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on
 
166
Initializes the GDK library and connects to the X server, returning <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> on
167
167
success.
168
168
</p>
169
169
<p>
171
171
updated accordingly.
172
172
</p>
173
173
<p>
174
 
GTK+ initializes GDK in <a href="/usr/share/gtk-doc/html/gtk3/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually needed
 
174
GTK+ initializes GDK in <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a> and so this function is not usually needed
175
175
by GTK+ applications.
176
176
</p>
177
177
<div class="variablelist"><table border="0">
190
190
<tr>
191
191
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
192
192
<td>
193
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if initialization succeeded.
 
193
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if initialization succeeded.
194
194
</td>
195
195
</tr>
196
196
</tbody>
199
199
<hr>
200
200
<div class="refsect2" title="gdk_parse_args ()">
201
201
<a name="gdk-parse-args"></a><h3>gdk_parse_args ()</h3>
202
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_parse_args                      (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
203
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
 
202
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_parse_args                      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *argc</code></em>,
 
203
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> ***argv</code></em>);</pre>
204
204
<p>
205
205
Parse command line arguments, and store for future
206
206
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>.
211
211
</p>
212
212
<p>
213
213
You shouldn't call this function explicitely if you are using
214
 
<a href="/usr/share/gtk-doc/html/gtk3/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>, <a href="/usr/share/gtk-doc/html/gtk3/gtk3-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a>, <a class="link" href="gdk-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a>, or <a class="link" href="gdk-General.html#gdk-init-check" title="gdk_init_check ()"><code class="function">gdk_init_check()</code></a>.
 
214
<a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-init"><code class="function">gtk_init()</code></a>, <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-init-check"><code class="function">gtk_init_check()</code></a>, <a class="link" href="gdk-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a>, or <a class="link" href="gdk-General.html#gdk-init-check" title="gdk_init_check ()"><code class="function">gdk_init_check()</code></a>.
215
215
</p>
216
216
<div class="variablelist"><table border="0">
217
217
<col align="left" valign="top">
233
233
<hr>
234
234
<div class="refsect2" title="gdk_get_display_arg_name ()">
235
235
<a name="gdk-get-display-arg-name"></a><h3>gdk_get_display_arg_name ()</h3>
236
 
<pre class="programlisting">const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gdk_get_display_arg_name            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
236
<pre class="programlisting">const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*        gdk_get_display_arg_name            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
237
237
<p>
238
238
Gets the display name specified in the command line arguments passed
239
239
to <a class="link" href="gdk-General.html#gdk-init" title="gdk_init ()"><code class="function">gdk_init()</code></a> or <a class="link" href="gdk-General.html#gdk-parse-args" title="gdk_parse_args ()"><code class="function">gdk_parse_args()</code></a>, if any.
242
242
<col align="left" valign="top">
243
243
<tbody><tr>
244
244
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
245
 
<td> the display name, if specified explicitely, otherwise <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
 
245
<td> the display name, if specified explicitely, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
246
246
  this string is owned by GTK+ and must not be modified or freed.
247
247
 
248
248
</td>
253
253
<hr>
254
254
<div class="refsect2" title="gdk_set_locale ()">
255
255
<a name="gdk-set-locale"></a><h3>gdk_set_locale ()</h3>
256
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              gdk_set_locale                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
256
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              gdk_set_locale                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
257
257
<p>
258
 
Initializes the support for internationalization by calling the <code class="function"><a href="/usr/share/gtk-doc/html/glib/glib-running.html#setlocale"><code class="function">setlocale()</code></a></code>
259
 
system call. This function is called by <a href="/usr/share/gtk-doc/html/gtk3/gtk3-General.html#gtk-set-locale"><code class="function">gtk_set_locale()</code></a> and so GTK+
 
258
Initializes the support for internationalization by calling the <code class="function"><a href="http://library.gnome.org/devel/glib/unstable/glib-running.html#setlocale"><code class="function">setlocale()</code></a></code>
 
259
system call. This function is called by <a href="http://library.gnome.org/devel/gtk/unstable/gtk3-General.html#gtk-set-locale"><code class="function">gtk_set_locale()</code></a> and so GTK+
260
260
applications should use that instead.
261
261
</p>
262
262
<p>
269
269
      <tr>
270
270
        <td class="listing_lines" align="right"><pre>1
271
271
2</pre></td>
272
 
        <td class="listing_code"><pre class="programlisting"><span class="normal">export LANG</span><span class="symbol">=</span><span class="string">"fr"</span>
273
 
<span class="symbol">...</span><span class="normal"> run application </span><span class="symbol">...</span></pre></td>
 
272
        <td class="listing_code"><pre class="programlisting"><span class="usertype">export</span><span class="normal"> LANG</span><span class="symbol">=</span><span class="string">"fr"</span>
 
273
<span class="symbol">...</span><span class="normal"> </span><span class="usertype">run</span><span class="normal"> application </span><span class="symbol">...</span></pre></td>
274
274
      </tr>
275
275
    </tbody>
276
276
  </table>
294
294
<hr>
295
295
<div class="refsect2" title="gdk_set_sm_client_id ()">
296
296
<a name="gdk-set-sm-client-id"></a><h3>gdk_set_sm_client_id ()</h3>
297
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_sm_client_id                (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);</pre>
 
297
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_sm_client_id                (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *sm_client_id</code></em>);</pre>
298
298
<p>
299
299
Sets the <code class="literal">SM_CLIENT_ID</code> property on the application's leader window so that
300
300
the window manager can save the application's state using the X11R6 ICCCM
311
311
<tbody><tr>
312
312
<td><p><span class="term"><em class="parameter"><code>sm_client_id</code></em> :</span></p></td>
313
313
<td>the client id assigned by the session manager when the
314
 
   connection was opened, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove the property.
 
314
   connection was opened, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to remove the property.
315
315
</td>
316
316
</tr></tbody>
317
317
</table></div>
319
319
<hr>
320
320
<div class="refsect2" title="gdk_exit ()">
321
321
<a name="gdk-exit"></a><h3>gdk_exit ()</h3>
322
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_exit                            (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> error_code</code></em>);</pre>
 
322
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_exit                            (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> error_code</code></em>);</pre>
323
323
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
324
324
<h3 class="title">Warning</h3>
325
325
<p><code class="literal">gdk_exit</code> is deprecated and should not be used in newly-written code.</p>
331
331
This routine is provided mainly for backwards compatibility, since it used to
332
332
perform tasks necessary to exit the application cleanly. Those tasks are now
333
333
performed in a function which is automatically called on exit (via the use
334
 
of <a href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-atexit"><code class="function">g_atexit()</code></a>).
 
334
of <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-atexit"><code class="function">g_atexit()</code></a>).
335
335
</p>
336
336
<div class="variablelist"><table border="0">
337
337
<col align="left" valign="top">
354
354
</p>
355
355
<p>
356
356
GTK+ will call this function automatically after opening the first
357
 
<a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> unless <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called 
 
357
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="type">GtkWindow</span></a> unless <a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called 
358
358
to disable that feature.
359
359
</p>
360
360
<p class="since">Since 2.2</p>
362
362
<hr>
363
363
<div class="refsect2" title="gdk_notify_startup_complete_with_id ()">
364
364
<a name="gdk-notify-startup-complete-with-id"></a><h3>gdk_notify_startup_complete_with_id ()</h3>
365
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_notify_startup_complete_with_id (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);</pre>
 
365
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_notify_startup_complete_with_id (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *startup_id</code></em>);</pre>
366
366
<p>
367
367
Indicates to the GUI environment that the application has finished
368
368
loading, using a given identifier.
369
369
</p>
370
370
<p>
371
 
GTK+ will call this function automatically for <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> with custom
 
371
GTK+ will call this function automatically for <a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="type">GtkWindow</span></a> with custom
372
372
startup-notification identifier unless
373
 
<a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called to disable
 
373
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html#gtk-window-set-auto-startup-notification"><code class="function">gtk_window_set_auto_startup_notification()</code></a> is called to disable
374
374
that feature.
375
375
</p>
376
376
<div class="variablelist"><table border="0">
392
392
Gets the program class. Unless the program class has explicitly
393
393
been set with <a class="link" href="gdk-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>
394
394
commandline option, the default value is the program name (determined
395
 
with <a href="/usr/share/gtk-doc/html/glib/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"><code class="function">g_get_prgname()</code></a>) with the first character converted to uppercase.
 
395
with <a href="http://library.gnome.org/devel/glib/unstable/glib-Miscellaneous-Utility-Functions.html#g-get-prgname"><code class="function">g_get_prgname()</code></a>) with the first character converted to uppercase.
396
396
</p>
397
397
<div class="variablelist"><table border="0">
398
398
<col align="left" valign="top">
424
424
<hr>
425
425
<div class="refsect2" title="gdk_get_display ()">
426
426
<a name="gdk-get-display"></a><h3>gdk_get_display ()</h3>
427
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              gdk_get_display                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
427
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a>*              gdk_get_display                     (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
428
428
<p>
429
429
Gets the name of the display, which usually comes from the <code class="envar">DISPLAY</code>
430
430
environment variable or the <code class="option">--display</code> command line option.
451
451
<hr>
452
452
<div class="refsect2" title="gdk_screen_width ()">
453
453
<a name="gdk-screen-width"></a><h3>gdk_screen_width ()</h3>
454
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_width                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
454
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_width                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
455
455
<p>
456
456
Returns the width of the default screen in pixels.
457
457
</p>
467
467
<hr>
468
468
<div class="refsect2" title="gdk_screen_height ()">
469
469
<a name="gdk-screen-height"></a><h3>gdk_screen_height ()</h3>
470
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_height                   (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
470
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_height                   (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
471
471
<p>
472
472
Returns the height of the default screen in pixels.
473
473
</p>
483
483
<hr>
484
484
<div class="refsect2" title="gdk_screen_width_mm ()">
485
485
<a name="gdk-screen-width-mm"></a><h3>gdk_screen_width_mm ()</h3>
486
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_width_mm                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
486
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_width_mm                 (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
487
487
<p>
488
488
Returns the width of the default screen in millimeters.
489
489
Note that on many X servers this value will not be correct.
501
501
<hr>
502
502
<div class="refsect2" title="gdk_screen_height_mm ()">
503
503
<a name="gdk-screen-height-mm"></a><h3>gdk_screen_height_mm ()</h3>
504
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_height_mm                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
504
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_screen_height_mm                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
505
505
<p>
506
506
Returns the height of the default screen in millimeters.
507
507
Note that on many X servers this value will not be correct.
520
520
<div class="refsect2" title="gdk_pointer_grab ()">
521
521
<a name="gdk-pointer-grab"></a><h3>gdk_pointer_grab ()</h3>
522
522
<pre class="programlisting"><a class="link" href="gdk-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       gdk_pointer_grab                    (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
523
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
 
523
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
524
524
                                                         <em class="parameter"><code><a class="link" href="gdk-Events.html#GdkEventMask" title="enum GdkEventMask"><span class="type">GdkEventMask</span></a> event_mask</code></em>,
525
525
                                                         <em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *confine_to</code></em>,
526
526
                                                         <em class="parameter"><code><a class="link" href="gdk-Cursors.html#GdkCursor" title="GdkCursor"><span class="type">GdkCursor</span></a> *cursor</code></em>,
527
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
527
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
528
528
<p>
529
529
Grabs the pointer (usually a mouse) so that all events are passed to this
530
530
application until the pointer is ungrabbed with <a class="link" href="gdk-General.html#gdk-pointer-ungrab" title="gdk_pointer_ungrab ()"><code class="function">gdk_pointer_ungrab()</code></a>, or
535
535
Pointer grabs are used for operations which need complete control over mouse
536
536
events, even if the mouse leaves the application.
537
537
For example in GTK+ it is used for Drag and Drop, for dragging the handle in
538
 
the <a href="/usr/share/gtk-doc/html/gtk3/GtkHPaned.html"><span class="type">GtkHPaned</span></a> and <a href="/usr/share/gtk-doc/html/gtk3/GtkVPaned.html"><span class="type">GtkVPaned</span></a> widgets, and for resizing columns in <a href="/usr/share/gtk-doc/html/gtk/GtkCList.html"><span class="type">GtkCList</span></a>
 
538
the <a href="http://library.gnome.org/devel/gtk/unstable/GtkHPaned.html"><span class="type">GtkHPaned</span></a> and <a href="http://library.gnome.org/devel/gtk/unstable/GtkVPaned.html"><span class="type">GtkVPaned</span></a> widgets, and for resizing columns in <a href="http://library.gnome.org/devel/gtk/unstable/GtkCList.html"><span class="type">GtkCList</span></a>
539
539
widgets.
540
540
</p>
541
541
<p>
545
545
X does this automatically since most applications expect to receive button
546
546
press and release events in pairs.
547
547
It is equivalent to a pointer grab on the window with <em class="parameter"><code>owner_events</code></em> set to
548
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
 
548
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.
549
549
</p>
550
550
<p>
551
551
If you set up anything at the time you take the grab that needs to be cleaned
562
562
</tr>
563
563
<tr>
564
564
<td><p><span class="term"><em class="parameter"><code>owner_events</code></em> :</span></p></td>
565
 
<td>if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then all pointer events are reported with respect to
566
 
<em class="parameter"><code>window</code></em> and are only reported if selected by <em class="parameter"><code>event_mask</code></em>. If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then pointer
 
565
<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then all pointer events are reported with respect to
 
566
<em class="parameter"><code>window</code></em> and are only reported if selected by <em class="parameter"><code>event_mask</code></em>. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then pointer
567
567
events for this application are reported as normal, but pointer events outside
568
568
this application are reported with respect to <em class="parameter"><code>window</code></em> and only if selected by
569
569
<em class="parameter"><code>event_mask</code></em>. In either mode, unreported events are discarded.
578
578
</tr>
579
579
<tr>
580
580
<td><p><span class="term"><em class="parameter"><code>confine_to</code></em> :</span></p></td>
581
 
<td>If non-<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the pointer will be confined to this
 
581
<td>If non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, the pointer will be confined to this
582
582
window during the grab. If the pointer is outside <em class="parameter"><code>confine_to</code></em>, it will
583
583
automatically be moved to the closest edge of <em class="parameter"><code>confine_to</code></em> and enter
584
584
and leave events will be generated as necessary.
586
586
</tr>
587
587
<tr>
588
588
<td><p><span class="term"><em class="parameter"><code>cursor</code></em> :</span></p></td>
589
 
<td>the cursor to display while the grab is active. If this is <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then
 
589
<td>the cursor to display while the grab is active. If this is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> then
590
590
the normal cursors are used for <em class="parameter"><code>window</code></em> and its descendants, and the cursor
591
591
for <em class="parameter"><code>window</code></em> is used for all other windows.
592
592
</td>
659
659
<hr>
660
660
<div class="refsect2" title="gdk_pointer_ungrab ()">
661
661
<a name="gdk-pointer-ungrab"></a><h3>gdk_pointer_ungrab ()</h3>
662
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_pointer_ungrab                  (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
662
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_pointer_ungrab                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
663
663
<p>
664
664
Ungrabs the pointer on the default display, if it is grabbed by this 
665
665
application.
677
677
<hr>
678
678
<div class="refsect2" title="gdk_pointer_is_grabbed ()">
679
679
<a name="gdk-pointer-is-grabbed"></a><h3>gdk_pointer_is_grabbed ()</h3>
680
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_pointer_is_grabbed              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
680
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_pointer_is_grabbed              (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
681
681
<p>
682
 
Returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pointer on the default display is currently 
 
682
Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pointer on the default display is currently 
683
683
grabbed by this application.
684
684
</p>
685
685
<p>
690
690
<col align="left" valign="top">
691
691
<tbody><tr>
692
692
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
693
 
<td> <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pointer is currently grabbed by this application.* 
 
693
<td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pointer is currently grabbed by this application.* 
694
694
</td>
695
695
</tr></tbody>
696
696
</table></div>
698
698
<hr>
699
699
<div class="refsect2" title="gdk_set_double_click_time ()">
700
700
<a name="gdk-set-double-click-time"></a><h3>gdk_set_double_click_time ()</h3>
701
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_double_click_time           (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msec</code></em>);</pre>
 
701
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_double_click_time           (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> msec</code></em>);</pre>
702
702
<p>
703
703
Set the double click time for the default display. See
704
704
<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>. 
719
719
<div class="refsect2" title="gdk_keyboard_grab ()">
720
720
<a name="gdk-keyboard-grab"></a><h3>gdk_keyboard_grab ()</h3>
721
721
<pre class="programlisting"><a class="link" href="gdk-General.html#GdkGrabStatus" title="enum GdkGrabStatus"><span class="returnvalue">GdkGrabStatus</span></a>       gdk_keyboard_grab                   (<em class="parameter"><code><a class="link" href="gdk-Windows.html#GdkWindow"><span class="type">GdkWindow</span></a> *window</code></em>,
722
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
723
 
                                                         <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
722
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> owner_events</code></em>,
 
723
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
724
724
<p>
725
725
Grabs the keyboard so that all events are passed to this
726
726
application until the keyboard is ungrabbed with <a class="link" href="gdk-General.html#gdk-keyboard-ungrab" title="gdk_keyboard_ungrab ()"><code class="function">gdk_keyboard_ungrab()</code></a>.
741
741
</tr>
742
742
<tr>
743
743
<td><p><span class="term"><em class="parameter"><code>owner_events</code></em> :</span></p></td>
744
 
<td>if <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then all keyboard events are reported with respect to
745
 
<em class="parameter"><code>window</code></em>. If <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then keyboard events for this application are reported as
 
744
<td>if <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> then all keyboard events are reported with respect to
 
745
<em class="parameter"><code>window</code></em>. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> then keyboard events for this application are reported as
746
746
normal, but keyboard events outside this application are reported with respect
747
747
to <em class="parameter"><code>window</code></em>. Both key press and key release events are always reported,
748
748
independant of the event mask set by the application.
766
766
<hr>
767
767
<div class="refsect2" title="gdk_keyboard_ungrab ()">
768
768
<a name="gdk-keyboard-ungrab"></a><h3>gdk_keyboard_ungrab ()</h3>
769
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_keyboard_ungrab                 (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
 
769
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_keyboard_ungrab                 (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> time_</code></em>);</pre>
770
770
<p>
771
771
Ungrabs the keyboard on the default display, if it is grabbed by this 
772
772
application.
792
792
<hr>
793
793
<div class="refsect2" title="gdk_get_use_xshm ()">
794
794
<a name="gdk-get-use-xshm"></a><h3>gdk_get_use_xshm ()</h3>
795
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_get_use_xshm                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
795
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gdk_get_use_xshm                    (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
796
796
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
797
797
<h3 class="title">Warning</h3>
798
798
<p><code class="literal">gdk_get_use_xshm</code> is deprecated and should not be used in newly-written code.</p>
799
799
</div>
800
800
<p>
801
 
Returns <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if GDK will attempt to use the MIT-SHM shared memory extension.
 
801
Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if GDK will attempt to use the MIT-SHM shared memory extension.
802
802
</p>
803
803
<p>
804
804
The shared memory extension is used for <a class="link" href="gdk-Images.html#GdkImage" title="GdkImage"><span class="type">GdkImage</span></a>, and consequently for
812
812
<tbody><tr>
813
813
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
814
814
<td>
815
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if use of the MIT shared memory extension will be attempted.
 
815
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if use of the MIT shared memory extension will be attempted.
816
816
</td>
817
817
</tr></tbody>
818
818
</table></div>
820
820
<hr>
821
821
<div class="refsect2" title="gdk_set_use_xshm ()">
822
822
<a name="gdk-set-use-xshm"></a><h3>gdk_set_use_xshm ()</h3>
823
 
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_use_xshm                    (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_xshm</code></em>);</pre>
 
823
<pre class="programlisting"><span class="returnvalue">void</span>                gdk_set_use_xshm                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> use_xshm</code></em>);</pre>
824
824
<div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
825
825
<h3 class="title">Warning</h3>
826
826
<p><code class="literal">gdk_set_use_xshm</code> is deprecated and should not be used in newly-written code.</p>
828
828
<p>
829
829
Sets whether the use of the MIT shared memory extension should be attempted.
830
830
This function is mainly for internal use. It is only safe for an application
831
 
to set this to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, since if it is set to <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and the server does not
 
831
to set this to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>, since if it is set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> and the server does not
832
832
support the extension it may cause warning messages to be output.
833
833
</p>
834
834
<div class="variablelist"><table border="0">
836
836
<tbody><tr>
837
837
<td><p><span class="term"><em class="parameter"><code>use_xshm</code></em> :</span></p></td>
838
838
<td>
839
 
<a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if use of the MIT shared memory extension should be attempted.
 
839
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if use of the MIT shared memory extension should be attempted.
840
840
</td>
841
841
</tr></tbody>
842
842
</table></div>
851
851
avoid the X error in any other way.
852
852
</p>
853
853
<div class="example">
854
 
<a name="id523683"></a><p class="title"><b>Example 1. Trapping an X error</b></p>
 
854
<a name="id588400"></a><p class="title"><b>Example 1. Trapping an X error</b></p>
855
855
<div class="example-contents">
856
856
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
857
857
    <tbody>
883
883
<hr>
884
884
<div class="refsect2" title="gdk_error_trap_pop ()">
885
885
<a name="gdk-error-trap-pop"></a><h3>gdk_error_trap_pop ()</h3>
886
 
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_error_trap_pop                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
886
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                gdk_error_trap_pop                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
887
887
<p>
888
888
Removes the X error trap installed with <a class="link" href="gdk-General.html#gdk-error-trap-push" title="gdk_error_trap_push ()"><code class="function">gdk_error_trap_push()</code></a>.
889
889
</p>