← Back to branch summary

~ubuntu-branches/ubuntu/precise/gtk+2.0/precise-updates

« back to all changes in this revision

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

  • Committer: Package Import Robot
  • Author(s): Ken VanDine
  • Date: 2011-12-01 11:40:06 UTC
  • mfrom: (1.14.11)
  • Revision ID: package-import@ubuntu.com-20111201114006-nrmf6qu3pg512veo
Tags: 2.24.8-0ubuntu1
https://launchpad.net/bugs/189494
https://launchpad.net/bugs/889019
* New upstream release 
  - gtkfilechooser should be more robust to malformed URIs
    in .gtk-bookmarks (LP: #189494)
* debian/patches/010_make_bg_changes_queue_repaint.patch
  - dropped it introduces performance regressions in some gtk2 
    apps (LP: #889019)
* 101_filechooser.patch, 000git_file_chooser.patch: dropped, upstream

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gtk/html/gtk-General.html
8
8
<link rel="up" href="gtkbase.html" title="Part II. GTK+ Core Reference">
9
9
<link rel="prev" href="gtkbase.html" title="Part II. GTK+ Core Reference">
10
10
<link rel="next" href="gtk-Keyboard-Accelerators.html" title="Accelerator Groups">
11
 
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
 
11
<meta name="generator" content="GTK-Doc V1.17 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
</head>
14
14
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
40
40
<pre class="synopsis">
41
41
#include &lt;gtk/gtk.h&gt;
42
42
 
43
 
<span class="returnvalue">gchar</span> *             <a class="link" href="gtk-General.html#gtk-set-locale" title="gtk_set_locale ()">gtk_set_locale</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
 
43
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gtk-General.html#gtk-set-locale" title="gtk_set_locale ()">gtk_set_locale</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
44
44
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-disable-setlocale" title="gtk_disable_setlocale ()">gtk_disable_setlocale</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
45
 
<span class="returnvalue">PangoLanguage</span> *     <a class="link" href="gtk-General.html#gtk-get-default-language" title="gtk_get_default_language ()">gtk_get_default_language</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
46
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-parse-args" title="gtk_parse_args ()">gtk_parse_args</a>                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
45
<a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *     <a class="link" href="gtk-General.html#gtk-get-default-language" title="gtk_get_default_language ()">gtk_get_default_language</a>            (<em class="parameter"><code><span class="type">void</span></code></em>);
 
46
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-parse-args" title="gtk_parse_args ()">gtk_parse_args</a>                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
47
47
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
48
48
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()">gtk_init</a>                            (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
49
49
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
50
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()">gtk_init_check</a>                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
50
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()">gtk_init_check</a>                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
51
51
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);
52
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()">gtk_init_with_args</a>                  (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
52
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()">gtk_init_with_args</a>                  (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
53
53
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
54
54
                                                         <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
55
 
                                                         <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
 
55
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>,
56
56
                                                         <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
57
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);
58
 
<span class="returnvalue">GOptionGroup</span> *      <a class="link" href="gtk-General.html#gtk-get-option-group" title="gtk_get_option_group ()">gtk_get_option_group</a>                (<em class="parameter"><code><span class="type">gboolean</span> open_default_display</code></em>);
59
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-exit" title="gtk_exit ()">gtk_exit</a>                            (<em class="parameter"><code><span class="type">gint</span> error_code</code></em>);
60
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-events-pending" title="gtk_events_pending ()">gtk_events_pending</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
 
57
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);
 
58
<a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> *      <a class="link" href="gtk-General.html#gtk-get-option-group" title="gtk_get_option_group ()">gtk_get_option_group</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> open_default_display</code></em>);
 
59
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-exit" title="gtk_exit ()">gtk_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>);
 
60
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-events-pending" title="gtk_events_pending ()">gtk_events_pending</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
61
61
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-main" title="gtk_main ()">gtk_main</a>                            (<em class="parameter"><code><span class="type">void</span></code></em>);
62
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-main-level" title="gtk_main_level ()">gtk_main_level</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
 
62
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-main-level" title="gtk_main_level ()">gtk_main_level</a>                      (<em class="parameter"><code><span class="type">void</span></code></em>);
63
63
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()">gtk_main_quit</a>                       (<em class="parameter"><code><span class="type">void</span></code></em>);
64
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-main-iteration" title="gtk_main_iteration ()">gtk_main_iteration</a>                  (<em class="parameter"><code><span class="type">void</span></code></em>);
65
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-main-iteration-do" title="gtk_main_iteration_do ()">gtk_main_iteration_do</a>               (<em class="parameter"><code><span class="type">gboolean</span> blocking</code></em>);
66
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-main-do-event" title="gtk_main_do_event ()">gtk_main_do_event</a>                   (<em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
67
 
<span class="returnvalue">void</span>                (<a class="link" href="gtk-General.html#GtkModuleInitFunc" title="GtkModuleInitFunc ()">*GtkModuleInitFunc</a>)                (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
68
 
                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);
69
 
<span class="returnvalue">void</span>                (<a class="link" href="gtk-General.html#GtkModuleDisplayInitFunc" title="GtkModuleDisplayInitFunc ()">*GtkModuleDisplayInitFunc</a>)         (<em class="parameter"><code><a href="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);
 
64
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-main-iteration" title="gtk_main_iteration ()">gtk_main_iteration</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#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-main-iteration-do" title="gtk_main_iteration_do ()">gtk_main_iteration_do</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> blocking</code></em>);
 
66
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-main-do-event" title="gtk_main_do_event ()">gtk_main_do_event</a>                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
 
67
<span class="returnvalue">void</span>                (<a class="link" href="gtk-General.html#GtkModuleInitFunc" title="GtkModuleInitFunc ()">*GtkModuleInitFunc</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>,
 
68
                                                         <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>);
 
69
<span class="returnvalue">void</span>                (<a class="link" href="gtk-General.html#GtkModuleDisplayInitFunc" title="GtkModuleDisplayInitFunc ()">*GtkModuleDisplayInitFunc</a>)         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);
70
70
 
71
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-true" title="gtk_true ()">gtk_true</a>                            (<em class="parameter"><code><span class="type">void</span></code></em>);
72
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-false" title="gtk_false ()">gtk_false</a>                           (<em class="parameter"><code><span class="type">void</span></code></em>);
 
71
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-true" title="gtk_true ()">gtk_true</a>                            (<em class="parameter"><code><span class="type">void</span></code></em>);
 
72
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-false" title="gtk_false ()">gtk_false</a>                           (<em class="parameter"><code><span class="type">void</span></code></em>);
73
73
 
74
74
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-grab-add" title="gtk_grab_add ()">gtk_grab_add</a>                        (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
75
75
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk-General.html#gtk-grab-get-current" title="gtk_grab_get_current ()">gtk_grab_get_current</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
76
76
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-grab-remove" title="gtk_grab_remove ()">gtk_grab_remove</a>                     (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>);
77
77
 
78
78
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-init-add" title="gtk_init_add ()">gtk_init_add</a>                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
79
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
80
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-add-destroy" title="gtk_quit_add_destroy ()">gtk_quit_add_destroy</a>                (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
 
79
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
80
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-add-destroy" title="gtk_quit_add_destroy ()">gtk_quit_add_destroy</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> main_level</code></em>,
81
81
                                                         <em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);
82
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()">gtk_quit_add</a>                        (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
83
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
84
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
85
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-quit-add-full" title="gtk_quit_add_full ()">gtk_quit_add_full</a>                   (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
86
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
87
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
88
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
89
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
90
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()">gtk_quit_remove</a>                     (<em class="parameter"><code><span class="type">guint</span> quit_handler_id</code></em>);
91
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-remove-by-data" title="gtk_quit_remove_by_data ()">gtk_quit_remove_by_data</a>             (<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
92
 
 
93
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-timeout-add-full" title="gtk_timeout_add_full ()">gtk_timeout_add_full</a>                (<em class="parameter"><code><span class="type">guint32</span> interval</code></em>,
94
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
95
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
96
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
97
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
98
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-timeout-add" title="gtk_timeout_add ()">gtk_timeout_add</a>                     (<em class="parameter"><code><span class="type">guint32</span> interval</code></em>,
99
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
100
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
101
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-timeout-remove" title="gtk_timeout_remove ()">gtk_timeout_remove</a>                  (<em class="parameter"><code><span class="type">guint</span> timeout_handler_id</code></em>);
102
 
 
103
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()">gtk_idle_add</a>                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
104
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
105
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-idle-add-priority" title="gtk_idle_add_priority ()">gtk_idle_add_priority</a>               (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
106
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
107
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
108
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-idle-add-full" title="gtk_idle_add_full ()">gtk_idle_add_full</a>                   (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
109
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
110
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
111
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
112
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
113
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-idle-remove" title="gtk_idle_remove ()">gtk_idle_remove</a>                     (<em class="parameter"><code><span class="type">guint</span> idle_handler_id</code></em>);
114
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-idle-remove-by-data" title="gtk_idle_remove_by_data ()">gtk_idle_remove_by_data</a>             (<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);
115
 
 
116
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-input-add-full" title="gtk_input_add_full ()">gtk_input_add_full</a>                  (<em class="parameter"><code><span class="type">gint</span> source</code></em>,
117
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Input.html#GdkInputCondition"><span class="type">GdkInputCondition</span></a> condition</code></em>,
118
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Input.html#GdkInputFunction"><span class="type">GdkInputFunction</span></a> function</code></em>,
119
 
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
120
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
121
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);
122
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-input-remove" title="gtk_input_remove ()">gtk_input_remove</a>                    (<em class="parameter"><code><span class="type">guint</span> input_handler_id</code></em>);
 
82
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()">gtk_quit_add</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> main_level</code></em>,
 
83
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
84
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
85
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-quit-add-full" title="gtk_quit_add_full ()">gtk_quit_add_full</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> main_level</code></em>,
 
86
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
87
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
 
88
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
89
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
90
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()">gtk_quit_remove</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> quit_handler_id</code></em>);
 
91
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-quit-remove-by-data" title="gtk_quit_remove_by_data ()">gtk_quit_remove_by_data</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
92
 
 
93
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-timeout-add-full" title="gtk_timeout_add_full ()">gtk_timeout_add_full</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> interval</code></em>,
 
94
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
95
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
 
96
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
97
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
98
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-timeout-add" title="gtk_timeout_add ()">gtk_timeout_add</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> interval</code></em>,
 
99
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
100
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
101
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-timeout-remove" title="gtk_timeout_remove ()">gtk_timeout_remove</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> timeout_handler_id</code></em>);
 
102
 
 
103
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()">gtk_idle_add</a>                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
104
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
105
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-idle-add-priority" title="gtk_idle_add_priority ()">gtk_idle_add_priority</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> priority</code></em>,
 
106
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
107
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
108
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-idle-add-full" title="gtk_idle_add_full ()">gtk_idle_add_full</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> priority</code></em>,
 
109
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
110
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
 
111
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
112
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
113
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-idle-remove" title="gtk_idle_remove ()">gtk_idle_remove</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> idle_handler_id</code></em>);
 
114
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-idle-remove-by-data" title="gtk_idle_remove_by_data ()">gtk_idle_remove_by_data</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);
 
115
 
 
116
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-input-add-full" title="gtk_input_add_full ()">gtk_input_add_full</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> source</code></em>,
 
117
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputCondition"><span class="type">GdkInputCondition</span></a> condition</code></em>,
 
118
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputFunction"><span class="type">GdkInputFunction</span></a> function</code></em>,
 
119
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
 
120
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
121
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);
 
122
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-input-remove" title="gtk_input_remove ()">gtk_input_remove</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> input_handler_id</code></em>);
123
123
 
124
124
#define             <a class="link" href="gtk-General.html#GTK-PRIORITY-REDRAW:CAPS" title="GTK_PRIORITY_REDRAW">GTK_PRIORITY_REDRAW</a>
125
125
#define             <a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE">GTK_PRIORITY_RESIZE</a>
128
128
#define             <a class="link" href="gtk-General.html#GTK-PRIORITY-DEFAULT:CAPS" title="GTK_PRIORITY_DEFAULT">GTK_PRIORITY_DEFAULT</a>
129
129
#define             <a class="link" href="gtk-General.html#GTK-PRIORITY-LOW:CAPS" title="GTK_PRIORITY_LOW">GTK_PRIORITY_LOW</a>
130
130
 
131
 
<span class="returnvalue">guint</span>               <a class="link" href="gtk-General.html#gtk-key-snooper-install" title="gtk_key_snooper_install ()">gtk_key_snooper_install</a>             (<em class="parameter"><code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()"><span class="type">GtkKeySnoopFunc</span></a> snooper</code></em>,
132
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> func_data</code></em>);
133
 
<span class="returnvalue">gint</span>                (<a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">*GtkKeySnoopFunc</a>)                  (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *grab_widget</code></em>,
134
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>,
135
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> func_data</code></em>);
136
 
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-key-snooper-remove" title="gtk_key_snooper_remove ()">gtk_key_snooper_remove</a>              (<em class="parameter"><code><span class="type">guint</span> snooper_handler_id</code></em>);
 
131
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="gtk-General.html#gtk-key-snooper-install" title="gtk_key_snooper_install ()">gtk_key_snooper_install</a>             (<em class="parameter"><code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()"><span class="type">GtkKeySnoopFunc</span></a> snooper</code></em>,
 
132
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>);
 
133
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                (<a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">*GtkKeySnoopFunc</a>)                  (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *grab_widget</code></em>,
 
134
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>,
 
135
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>);
 
136
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-key-snooper-remove" title="gtk_key_snooper_remove ()">gtk_key_snooper_remove</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> snooper_handler_id</code></em>);
137
137
 
138
 
<a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *          <a class="link" href="gtk-General.html#gtk-get-current-event" title="gtk_get_current_event ()">gtk_get_current_event</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
139
 
<span class="returnvalue">guint32</span>             <a class="link" href="gtk-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()">gtk_get_current_event_time</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
140
 
<span class="returnvalue">gboolean</span>            <a class="link" href="gtk-General.html#gtk-get-current-event-state" title="gtk_get_current_event_state ()">gtk_get_current_event_state</a>         (<em class="parameter"><code><a href="../gdk/gdk-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> *state</code></em>);
141
 
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk-General.html#gtk-get-event-widget" title="gtk_get_event_widget ()">gtk_get_event_widget</a>                (<em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
 
138
<a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *          <a class="link" href="gtk-General.html#gtk-get-current-event" title="gtk_get_current_event ()">gtk_get_current_event</a>               (<em class="parameter"><code><span class="type">void</span></code></em>);
 
139
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             <a class="link" href="gtk-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()">gtk_get_current_event_time</a>          (<em class="parameter"><code><span class="type">void</span></code></em>);
 
140
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gtk-General.html#gtk-get-current-event-state" title="gtk_get_current_event_state ()">gtk_get_current_event_state</a>         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> *state</code></em>);
 
141
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="gtk-General.html#gtk-get-event-widget" title="gtk_get_event_widget ()">gtk_get_event_widget</a>                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
142
142
<span class="returnvalue">void</span>                <a class="link" href="gtk-General.html#gtk-propagate-event" title="gtk_propagate_event ()">gtk_propagate_event</a>                 (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
143
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
 
143
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);
144
144
</pre>
145
145
</div>
146
146
<div class="refsect1">
165
165
When widgets receive an event, they frequently emit one or more
166
166
<em class="firstterm">signals</em>. Signals notify your program that
167
167
"something interesting happened" by invoking functions you've
168
 
connected to the signal with <code class="function">g_signal_connect()</code>. Functions connected
 
168
connected to the signal with <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect"><code class="function">g_signal_connect()</code></a>. Functions connected
169
169
to a signal are often termed <em class="firstterm">callbacks</em>.
170
170
</p>
171
171
<p>
175
175
to the main loop and await more user input.
176
176
</p>
177
177
<div class="example">
178
 
<a name="id564473"></a><p class="title"><b>Example 2. Typical <code class="function">main</code> function for a GTK+ application</b></p>
 
178
<a name="id614975"></a><p class="title"><b>Example 2. Typical <code class="function">main</code> function for a GTK+ application</b></p>
179
179
<div class="example-contents">
180
180
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
181
181
    <tbody>
224
224
</div>
225
225
<br class="example-break"><p>
226
226
It's OK to use the GLib main loop directly instead of <a class="link" href="gtk-General.html#gtk-main" title="gtk_main ()"><code class="function">gtk_main()</code></a>,
227
 
though it involves slightly more typing. See <span class="type">GMainLoop</span> in the GLib
 
227
though it involves slightly more typing. See <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> in the GLib
228
228
documentation.
229
229
</p>
230
230
</div>
232
232
<a name="gtk-General.details"></a><h2>Details</h2>
233
233
<div class="refsect2">
234
234
<a name="gtk-set-locale"></a><h3>gtk_set_locale ()</h3>
235
 
<pre class="programlisting"><span class="returnvalue">gchar</span> *             gtk_set_locale                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
235
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gtk_set_locale                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
236
236
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
237
237
<h3 class="title">Warning</h3>
238
 
<p><code class="literal">gtk_set_locale</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <code class="function">setlocale()</code> directly</p>
 
238
<p><code class="literal">gtk_set_locale</code> has been deprecated since version 2.24 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-running.html#setlocale"><code class="function">setlocale()</code></a> directly</p>
239
239
</div>
240
240
<p>
241
241
Initializes internationalization support for GTK+. <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>
262
262
<td>a string corresponding to the locale set, typically in the
263
263
form lang_COUNTRY, where lang is an ISO-639 language code, and
264
264
COUNTRY is an ISO-3166 country code. On Unix, this form matches the
265
 
result of the <code class="function">setlocale()</code>; it is also used on other machines, such as
 
265
result of the <a href="http://library.gnome.org/devel/glib/unstable/glib-running.html#setlocale"><code class="function">setlocale()</code></a>; it is also used on other machines, such as
266
266
Windows, where the C library returns a different result. The string is
267
267
owned by GTK+ and should not be modified or freed.</td>
268
268
</tr></tbody>
287
287
<hr>
288
288
<div class="refsect2">
289
289
<a name="gtk-get-default-language"></a><h3>gtk_get_default_language ()</h3>
290
 
<pre class="programlisting"><span class="returnvalue">PangoLanguage</span> *     gtk_get_default_language            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
290
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage"><span class="returnvalue">PangoLanguage</span></a> *     gtk_get_default_language            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
291
291
<p>
292
 
Returns the <span class="type">PangoLanguage</span> for the default language currently in
 
292
Returns the <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a> for the default language currently in
293
293
effect. (Note that this can change over the life of an
294
294
application.)  The default language is derived from the current
295
295
locale. It determines, for example, whether GTK+ uses the
296
296
right-to-left or left-to-right text direction.
297
297
</p>
298
298
<p>
299
 
This function is equivalent to <code class="function">pango_language_get_default()</code>.  See
 
299
This function is equivalent to <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#pango-language-get-default"><code class="function">pango_language_get_default()</code></a>.  See
300
300
that function for details.
301
301
</p>
302
302
<div class="variablelist"><table border="0">
303
303
<col align="left" valign="top">
304
304
<tbody><tr>
305
305
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
306
 
<td>the default language as a <span class="type">PangoLanguage</span>, must not be
 
306
<td>the default language as a <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage"><span class="type">PangoLanguage</span></a>, must not be
307
307
freed</td>
308
308
</tr></tbody>
309
309
</table></div>
311
311
<hr>
312
312
<div class="refsect2">
313
313
<a name="gtk-parse-args"></a><h3>gtk_parse_args ()</h3>
314
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_parse_args                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
314
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_parse_args                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
315
315
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
316
316
<p>
317
317
Parses command line arguments, and initializes global
318
318
attributes of GTK+, but does not actually open a connection
319
 
to a display. (See <a href="../gdk/GdkDisplay.html#gdk-display-open"><code class="function">gdk_display_open()</code></a>, <a href="../gdk/gdk-General.html#gdk-get-display-arg-name"><code class="function">gdk_get_display_arg_name()</code></a>)
 
319
to a display. (See <a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html#gdk-display-open"><code class="function">gdk_display_open()</code></a>, <a href="http://library.gnome.org/devel/gdk3/gdk-General.html#gdk-get-display-arg-name"><code class="function">gdk_get_display_arg_name()</code></a>)
320
320
</p>
321
321
<p>
322
322
Any arguments used by GTK+ or GDK are removed from the array and
343
343
<tr>
344
344
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
345
345
<td>
346
 
<code class="literal">TRUE</code> if initialization succeeded, otherwise <code class="literal">FALSE</code>.</td>
 
346
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if initialization succeeded, otherwise <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</td>
347
347
</tr>
348
348
</tbody>
349
349
</table></div>
365
365
<p>
366
366
Note that there are some alternative ways to initialize GTK+:
367
367
if you are calling <a class="link" href="gtk-General.html#gtk-parse-args" title="gtk_parse_args ()"><code class="function">gtk_parse_args()</code></a>, <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()"><code class="function">gtk_init_check()</code></a>,
368
 
<a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()"><code class="function">gtk_init_with_args()</code></a> or <code class="function">g_option_context_parse()</code> with
 
368
<a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()"><code class="function">gtk_init_with_args()</code></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#g-option-context-parse"><code class="function">g_option_context_parse()</code></a> with
369
369
the option group returned by <a class="link" href="gtk-General.html#gtk-get-option-group" title="gtk_get_option_group ()"><code class="function">gtk_get_option_group()</code></a>,
370
370
you <span class="emphasis"><em>don't</em></span> have to call <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>.
371
371
</p>
426
426
<hr>
427
427
<div class="refsect2">
428
428
<a name="gtk-init-check"></a><h3>gtk_init_check ()</h3>
429
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_init_check                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
429
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_init_check                      (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
430
430
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>);</pre>
431
431
<p>
432
432
This function does the same work as <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a> with only
433
433
a single change: It does not terminate the program if the GUI can't be
434
 
initialized. Instead it returns <code class="literal">FALSE</code> on failure.
 
434
initialized. Instead it returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> on failure.
435
435
</p>
436
436
<p>
437
437
This way the application can fall back to some other means of communication 
455
455
<tr>
456
456
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
457
457
<td>
458
 
<code class="literal">TRUE</code> if the GUI has been successfully initialized,
459
 
<code class="literal">FALSE</code> otherwise.</td>
 
458
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the GUI has been successfully initialized,
 
459
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
460
460
</tr>
461
461
</tbody>
462
462
</table></div>
464
464
<hr>
465
465
<div class="refsect2">
466
466
<a name="gtk-init-with-args"></a><h3>gtk_init_with_args ()</h3>
467
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_init_with_args                  (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
 
467
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_init_with_args                  (<em class="parameter"><code><span class="type">int</span> *argc</code></em>,
468
468
                                                         <em class="parameter"><code><span class="type">char</span> ***argv</code></em>,
469
469
                                                         <em class="parameter"><code>const <span class="type">char</span> *parameter_string</code></em>,
470
 
                                                         <em class="parameter"><code><span class="type">GOptionEntry</span> *entries</code></em>,
 
470
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry"><span class="type">GOptionEntry</span></a> *entries</code></em>,
471
471
                                                         <em class="parameter"><code>const <span class="type">char</span> *translation_domain</code></em>,
472
 
                                                         <em class="parameter"><code><span class="type">GError</span> **error</code></em>);</pre>
 
472
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
473
473
<p>
474
474
This function does the same work as <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()"><code class="function">gtk_init_check()</code></a>. 
475
475
Additionally, it allows you to add your own commandline options, 
499
499
</tr>
500
500
<tr>
501
501
<td><p><span class="term"><em class="parameter"><code>entries</code></em> :</span></p></td>
502
 
<td>a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>-terminated array
503
 
of <span class="type">GOptionEntry</span>s describing the options of your program. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
 
502
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array
 
503
of <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry"><span class="type">GOptionEntry</span></a>s describing the options of your program. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1]</span>
504
504
</td>
505
505
</tr>
506
506
<tr>
507
507
<td><p><span class="term"><em class="parameter"><code>translation_domain</code></em> :</span></p></td>
508
508
<td>a translation domain to use for translating
509
509
the <code class="option">--help</code> output for the options in <em class="parameter"><code>entries</code></em>
510
 
with <code class="function">gettext()</code>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>
 
510
with <code class="function">gettext()</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>
511
511
</td>
512
512
</tr>
513
513
<tr>
517
517
<tr>
518
518
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
519
519
<td>
520
 
<code class="literal">TRUE</code> if the GUI has been successfully initialized,
521
 
<code class="literal">FALSE</code> otherwise.</td>
 
520
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the GUI has been successfully initialized,
 
521
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
522
522
</tr>
523
523
</tbody>
524
524
</table></div>
527
527
<hr>
528
528
<div class="refsect2">
529
529
<a name="gtk-get-option-group"></a><h3>gtk_get_option_group ()</h3>
530
 
<pre class="programlisting"><span class="returnvalue">GOptionGroup</span> *      gtk_get_option_group                (<em class="parameter"><code><span class="type">gboolean</span> open_default_display</code></em>);</pre>
 
530
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup"><span class="returnvalue">GOptionGroup</span></a> *      gtk_get_option_group                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> open_default_display</code></em>);</pre>
531
531
<p>
532
 
Returns a <span class="type">GOptionGroup</span> for the commandline arguments recognized
533
 
by GTK+ and GDK. You should add this group to your <span class="type">GOptionContext</span> 
534
 
with <code class="function">g_option_context_add_group()</code>, if you are using 
535
 
<code class="function">g_option_context_parse()</code> to parse your commandline arguments.
 
532
Returns a <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup"><span class="type">GOptionGroup</span></a> for the commandline arguments recognized
 
533
by GTK+ and GDK. You should add this group to your <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionContext"><span class="type">GOptionContext</span></a> 
 
534
with <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#g-option-context-add-group"><code class="function">g_option_context_add_group()</code></a>, if you are using 
 
535
<a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#g-option-context-parse"><code class="function">g_option_context_parse()</code></a> to parse your commandline arguments.
536
536
</p>
537
537
<div class="variablelist"><table border="0">
538
538
<col align="left" valign="top">
544
544
</tr>
545
545
<tr>
546
546
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
547
 
<td>a <span class="type">GOptionGroup</span> for the commandline arguments recognized
 
547
<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup"><span class="type">GOptionGroup</span></a> for the commandline arguments recognized
548
548
by GTK+</td>
549
549
</tr>
550
550
</tbody>
554
554
<hr>
555
555
<div class="refsect2">
556
556
<a name="gtk-exit"></a><h3>gtk_exit ()</h3>
557
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_exit                            (<em class="parameter"><code><span class="type">gint</span> error_code</code></em>);</pre>
 
557
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_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>
558
558
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
559
559
<h3 class="title">Warning</h3>
560
560
<p><code class="literal">gtk_exit</code> is deprecated and should not be used in newly-written code. Use the standard <code class="function">exit()</code> function instead.</p>
576
576
<hr>
577
577
<div class="refsect2">
578
578
<a name="gtk-events-pending"></a><h3>gtk_events_pending ()</h3>
579
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_events_pending                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
579
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_events_pending                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
580
580
<p>
581
581
Checks if any events are pending. This can be used to update the GUI
582
582
and invoke timeouts etc. while doing some time intensive computation.
583
583
</p>
584
584
<div class="example">
585
 
<a name="id582143"></a><p class="title"><b>Example 3. Updating the GUI during a long computation.</b></p>
 
585
<a name="id632732"></a><p class="title"><b>Example 3. Updating the GUI during a long computation.</b></p>
586
586
<div class="example-contents">
587
587
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
588
588
    <tbody>
610
610
<tbody><tr>
611
611
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
612
612
<td>
613
 
<code class="literal">TRUE</code> if any events are pending, <code class="literal">FALSE</code> otherwise.</td>
 
613
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if any events are pending, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>
614
614
</tr></tbody>
615
615
</table></div>
616
616
</div>
627
627
<hr>
628
628
<div class="refsect2">
629
629
<a name="gtk-main-level"></a><h3>gtk_main_level ()</h3>
630
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_main_level                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
630
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_main_level                      (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
631
631
<p>
632
632
Asks for the current nesting level of the main loop. This can be useful
633
633
when calling <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()"><code class="function">gtk_quit_add()</code></a>.
652
652
<hr>
653
653
<div class="refsect2">
654
654
<a name="gtk-main-iteration"></a><h3>gtk_main_iteration ()</h3>
655
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_main_iteration                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
655
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_main_iteration                  (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
656
656
<p>
657
657
Runs a single iteration of the mainloop. If no events are waiting to be
658
658
processed GTK+ will block until the next event is noticed. If you don't
664
664
<tbody><tr>
665
665
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
666
666
<td>
667
 
<code class="literal">TRUE</code> if <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()"><code class="function">gtk_main_quit()</code></a> has been called for the innermost mainloop.</td>
 
667
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()"><code class="function">gtk_main_quit()</code></a> has been called for the innermost mainloop.</td>
668
668
</tr></tbody>
669
669
</table></div>
670
670
</div>
671
671
<hr>
672
672
<div class="refsect2">
673
673
<a name="gtk-main-iteration-do"></a><h3>gtk_main_iteration_do ()</h3>
674
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_main_iteration_do               (<em class="parameter"><code><span class="type">gboolean</span> blocking</code></em>);</pre>
 
674
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_main_iteration_do               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> blocking</code></em>);</pre>
675
675
<p>
676
676
Runs a single iteration of the mainloop. If no events are available either
677
677
return or block dependent on the value of <em class="parameter"><code>blocking</code></em>.
682
682
<tr>
683
683
<td><p><span class="term"><em class="parameter"><code>blocking</code></em> :</span></p></td>
684
684
<td>
685
 
<code class="literal">TRUE</code> if you want GTK+ to block if no events are pending.</td>
 
685
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if you want GTK+ to block if no events are pending.</td>
686
686
</tr>
687
687
<tr>
688
688
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
689
689
<td>
690
 
<code class="literal">TRUE</code> if <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()"><code class="function">gtk_main_quit()</code></a> has been called for the innermost mainloop.</td>
 
690
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()"><code class="function">gtk_main_quit()</code></a> has been called for the innermost mainloop.</td>
691
691
</tr>
692
692
</tbody>
693
693
</table></div>
695
695
<hr>
696
696
<div class="refsect2">
697
697
<a name="gtk-main-do-event"></a><h3>gtk_main_do_event ()</h3>
698
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_main_do_event                   (<em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
 
698
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_main_do_event                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
699
699
<p>
700
700
Processes a single GDK event. This is public only to allow filtering of events
701
701
between GDK and GTK+. You will not usually need to call this function directly.
766
766
<hr>
767
767
<div class="refsect2">
768
768
<a name="GtkModuleInitFunc"></a><h3>GtkModuleInitFunc ()</h3>
769
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkModuleInitFunc)                (<em class="parameter"><code><span class="type">gint</span> *argc</code></em>,
770
 
                                                         <em class="parameter"><code><span class="type">gchar</span> ***argv</code></em>);</pre>
 
769
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkModuleInitFunc)                (<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>,
 
770
                                                         <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>
771
771
<p>
772
772
Each GTK+ module must have a function <code class="function">gtk_module_init()</code> with this prototype.
773
773
This function is called after loading the module with the <em class="parameter"><code>argc</code></em> and <em class="parameter"><code>argv</code></em>
790
790
<hr>
791
791
<div class="refsect2">
792
792
<a name="GtkModuleDisplayInitFunc"></a><h3>GtkModuleDisplayInitFunc ()</h3>
793
 
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkModuleDisplayInitFunc)         (<em class="parameter"><code><a href="../gdk/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
 
793
<pre class="programlisting"><span class="returnvalue">void</span>                (*GtkModuleDisplayInitFunc)         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html"><span class="type">GdkDisplay</span></a> *display</code></em>);</pre>
794
794
<p>
795
795
</p>
796
796
<p class="since">Since 2.2</p>
798
798
<hr>
799
799
<div class="refsect2">
800
800
<a name="gtk-true"></a><h3>gtk_true ()</h3>
801
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_true                            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
801
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_true                            (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
802
802
<p>
803
 
All this function does it to return <code class="literal">TRUE</code>. This can be useful for example
 
803
All this function does it to return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>. This can be useful for example
804
804
if you want to inhibit the deletion of a window. Of course you should
805
805
not do this as the user expects a reaction from clicking the close
806
806
icon of the window...
807
807
</p>
808
808
<div class="example">
809
 
<a name="id583070"></a><p class="title"><b>Example 4. A persistent window</b></p>
 
809
<a name="id633659"></a><p class="title"><b>Example 4. A persistent window</b></p>
810
810
<div class="example-contents">
811
811
  <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
812
812
    <tbody>
837
837
<span class="normal">  </span><span class="usertype">GtkWidget</span><span class="normal">     </span><span class="symbol">*</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">but</span><span class="symbol">;</span>
838
838
<span class="normal">  </span><span class="function"><a href="gtk-General.html#gtk-init">gtk_init</a></span><span class="symbol">(</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argc</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">argv </span><span class="symbol">);</span>
839
839
<span class="normal">  win </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkWindow.html#gtk-window-new">gtk_window_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-Standard-Enumerations.html#GTK-WINDOW-TOPLEVEL:CAPS">GTK_WINDOW_TOPLEVEL</a></span><span class="symbol">);</span>
840
 
<span class="normal">  </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"delete-event"</span><span class="symbol">,</span>
841
 
<span class="normal">                    </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-General.html#gtk-true">gtk_true</a></span><span class="symbol">),</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">);</span>
842
 
<span class="normal">  </span><span class="function">g_signal_connect</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"destroy"</span><span class="symbol">,</span>
843
 
<span class="normal">            </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-General.html#gtk-main-quit">gtk_main_quit</a></span><span class="symbol">),</span><span class="normal"> <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a></span><span class="symbol">);</span>
 
840
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"delete-event"</span><span class="symbol">,</span>
 
841
<span class="normal">                    </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-General.html#gtk-true">gtk_true</a></span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
 
842
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"destroy"</span><span class="symbol">,</span>
 
843
<span class="normal">            </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="gtk-General.html#gtk-main-quit">gtk_main_quit</a></span><span class="symbol">),</span><span class="normal"> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
844
844
<span class="normal">  but </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="GtkButton.html#gtk-button-new-with-label">gtk_button_new_with_label</a></span><span class="normal"> </span><span class="symbol">(</span><span class="string">"Close yourself. I mean it!"</span><span class="symbol">);</span>
845
 
<span class="normal">  </span><span class="function">g_signal_connect_swapped</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">but</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"clicked"</span><span class="symbol">,</span>
846
 
<span class="normal">          </span><span class="function">G_CALLBACK</span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkObject.html#gtk-object-destroy">gtk_object_destroy</a></span><span class="symbol">),</span><span class="normal"> win</span><span class="symbol">);</span>
 
845
<span class="normal">  </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">but</span><span class="symbol">,</span><span class="normal"> </span><span class="string">"clicked"</span><span class="symbol">,</span>
 
846
<span class="normal">          </span><span class="function"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="GtkObject.html#gtk-object-destroy">gtk_object_destroy</a></span><span class="symbol">),</span><span class="normal"> win</span><span class="symbol">);</span>
847
847
<span class="normal">  </span><span class="function"><a href="GtkContainer.html#gtk-container-add">gtk_container_add</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function">GTK_CONTAINER</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">),</span><span class="normal"> but</span><span class="symbol">);</span>
848
848
<span class="normal">  </span><span class="function"><a href="GtkWidget.html#gtk-widget-show-all">gtk_widget_show_all</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">win</span><span class="symbol">);</span>
849
849
<span class="normal">  </span><span class="function"><a href="gtk-General.html#gtk-main">gtk_main</a></span><span class="normal"> </span><span class="symbol">();</span>
859
859
<col align="left" valign="top">
860
860
<tbody><tr>
861
861
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
862
 
<td><code class="literal">TRUE</code></td>
 
862
<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a></td>
863
863
</tr></tbody>
864
864
</table></div>
865
865
</div>
866
866
<hr>
867
867
<div class="refsect2">
868
868
<a name="gtk-false"></a><h3>gtk_false ()</h3>
869
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_false                           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
869
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_false                           (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
870
870
<p>
871
871
Analogical to <a class="link" href="gtk-General.html#gtk-true" title="gtk_true ()"><code class="function">gtk_true()</code></a> this function does nothing
872
 
but always returns <code class="literal">FALSE</code>.
 
872
but always returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
873
873
</p>
874
874
<div class="variablelist"><table border="0">
875
875
<col align="left" valign="top">
876
876
<tbody><tr>
877
877
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
878
 
<td><code class="literal">FALSE</code></td>
 
878
<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></td>
879
879
</tr></tbody>
880
880
</table></div>
881
881
</div>
915
915
<tbody><tr>
916
916
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
917
917
<td>The widget which currently
918
 
has the grab or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no grab is active. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
918
has the grab or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no grab is active. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
919
919
</td>
920
920
</tr></tbody>
921
921
</table></div>
943
943
<div class="refsect2">
944
944
<a name="gtk-init-add"></a><h3>gtk_init_add ()</h3>
945
945
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_init_add                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
946
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
946
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
947
947
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
948
948
<h3 class="title">Warning</h3>
949
949
<p><code class="literal">gtk_init_add</code> is deprecated and should not be used in newly-written code. This function is going to be removed in GTK+ 3.0</p>
968
968
<hr>
969
969
<div class="refsect2">
970
970
<a name="gtk-quit-add-destroy"></a><h3>gtk_quit_add_destroy ()</h3>
971
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_add_destroy                (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
 
971
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_add_destroy                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> main_level</code></em>,
972
972
                                                         <em class="parameter"><code><a class="link" href="GtkObject.html" title="GtkObject"><span class="type">GtkObject</span></a> *object</code></em>);</pre>
973
973
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
974
974
<h3 class="title">Warning</h3>
995
995
<hr>
996
996
<div class="refsect2">
997
997
<a name="gtk-quit-add"></a><h3>gtk_quit_add ()</h3>
998
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_quit_add                        (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
 
998
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_quit_add                        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> main_level</code></em>,
999
999
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1000
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1000
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1001
1001
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1002
1002
<h3 class="title">Warning</h3>
1003
1003
<p><code class="literal">gtk_quit_add</code> is deprecated and should not be used in newly-written code. This function is going to be removed in GTK+ 3.0</p>
1026
1026
<tr>
1027
1027
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1028
1028
<td>A handle for this quit handler (you need this for <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()"><code class="function">gtk_quit_remove()</code></a>)
1029
 
or 0 if you passed a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>function</code></em>.</td>
 
1029
or 0 if you passed a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>function</code></em>.</td>
1030
1030
</tr>
1031
1031
</tbody>
1032
1032
</table></div>
1034
1034
<hr>
1035
1035
<div class="refsect2">
1036
1036
<a name="gtk-quit-add-full"></a><h3>gtk_quit_add_full ()</h3>
1037
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_quit_add_full                   (<em class="parameter"><code><span class="type">guint</span> main_level</code></em>,
 
1037
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_quit_add_full                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> main_level</code></em>,
1038
1038
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1039
1039
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
1040
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1041
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
1040
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1041
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1042
1042
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1043
1043
<h3 class="title">Warning</h3>
1044
1044
<p><code class="literal">gtk_quit_add_full</code> is deprecated and should not be used in newly-written code. This function is going to be removed in GTK+ 3.0</p>
1070
1070
</tr>
1071
1071
<tr>
1072
1072
<td><p><span class="term"><em class="parameter"><code>marshal</code></em> :</span></p></td>
1073
 
<td>The marshaller to be used. If this is non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>function</code></em> is
 
1073
<td>The marshaller to be used. If this is non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <em class="parameter"><code>function</code></em> is
1074
1074
ignored.</td>
1075
1075
</tr>
1076
1076
<tr>
1084
1084
<tr>
1085
1085
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1086
1086
<td>A handle for this quit handler (you need this for <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()"><code class="function">gtk_quit_remove()</code></a>)
1087
 
or 0 if you passed a <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>function</code></em>.</td>
 
1087
or 0 if you passed a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> pointer in <em class="parameter"><code>function</code></em>.</td>
1088
1088
</tr>
1089
1089
</tbody>
1090
1090
</table></div>
1092
1092
<hr>
1093
1093
<div class="refsect2">
1094
1094
<a name="gtk-quit-remove"></a><h3>gtk_quit_remove ()</h3>
1095
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_remove                     (<em class="parameter"><code><span class="type">guint</span> quit_handler_id</code></em>);</pre>
 
1095
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_remove                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> quit_handler_id</code></em>);</pre>
1096
1096
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1097
1097
<h3 class="title">Warning</h3>
1098
1098
<p><code class="literal">gtk_quit_remove</code> is deprecated and should not be used in newly-written code. This function is going to be removed in GTK+ 3.0</p>
1111
1111
<hr>
1112
1112
<div class="refsect2">
1113
1113
<a name="gtk-quit-remove-by-data"></a><h3>gtk_quit_remove_by_data ()</h3>
1114
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_remove_by_data             (<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1114
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_quit_remove_by_data             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1115
1115
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1116
1116
<h3 class="title">Warning</h3>
1117
1117
<p><code class="literal">gtk_quit_remove_by_data</code> is deprecated and should not be used in newly-written code. This function is going to be removed in GTK+ 3.0</p>
1130
1130
<hr>
1131
1131
<div class="refsect2">
1132
1132
<a name="gtk-timeout-add-full"></a><h3>gtk_timeout_add_full ()</h3>
1133
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_timeout_add_full                (<em class="parameter"><code><span class="type">guint32</span> interval</code></em>,
 
1133
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_timeout_add_full                (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> interval</code></em>,
1134
1134
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1135
1135
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
1136
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1137
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
1136
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1137
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1138
1138
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1139
1139
<h3 class="title">Warning</h3>
1140
 
<p><code class="literal">gtk_timeout_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_timeout_add_full()</code> instead.</p>
 
1140
<p><code class="literal">gtk_timeout_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-timeout-add-full"><code class="function">g_timeout_add_full()</code></a> instead.</p>
1141
1141
</div>
1142
1142
<p>
1143
1143
Registers a function to be called periodically. The function will be called
1144
 
repeatedly after <em class="parameter"><code>interval</code></em> milliseconds until it returns <code class="literal">FALSE</code> at which
 
1144
repeatedly after <em class="parameter"><code>interval</code></em> milliseconds until it returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> at which
1145
1145
point the timeout is destroyed and will not be called again.
1146
1146
</p>
1147
1147
<div class="variablelist"><table border="0">
1158
1158
</tr>
1159
1159
<tr>
1160
1160
<td><p><span class="term"><em class="parameter"><code>marshal</code></em> :</span></p></td>
1161
 
<td>The marshaller to use instead of the function (if non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>).</td>
 
1161
<td>The marshaller to use instead of the function (if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>
1162
1162
</tr>
1163
1163
<tr>
1164
1164
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1166
1166
</tr>
1167
1167
<tr>
1168
1168
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1169
 
<td>Function to call when the timeout is destroyed or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
 
1169
<td>Function to call when the timeout is destroyed or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1170
1170
</tr>
1171
1171
<tr>
1172
1172
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1178
1178
<hr>
1179
1179
<div class="refsect2">
1180
1180
<a name="gtk-timeout-add"></a><h3>gtk_timeout_add ()</h3>
1181
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_timeout_add                     (<em class="parameter"><code><span class="type">guint32</span> interval</code></em>,
 
1181
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_timeout_add                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="type">guint32</span></a> interval</code></em>,
1182
1182
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1183
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1183
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1184
1184
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1185
1185
<h3 class="title">Warning</h3>
1186
 
<p><code class="literal">gtk_timeout_add</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_timeout_add()</code> instead.</p>
 
1186
<p><code class="literal">gtk_timeout_add</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-timeout-add"><code class="function">g_timeout_add()</code></a> instead.</p>
1187
1187
</div>
1188
1188
<p>
1189
1189
Registers a function to be called periodically. The function will be called
1190
 
repeatedly after <em class="parameter"><code>interval</code></em> milliseconds until it returns <code class="literal">FALSE</code> at which
 
1190
repeatedly after <em class="parameter"><code>interval</code></em> milliseconds until it returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> at which
1191
1191
point the timeout is destroyed and will not be called again.
1192
1192
</p>
1193
1193
<div class="variablelist"><table border="0">
1216
1216
<hr>
1217
1217
<div class="refsect2">
1218
1218
<a name="gtk-timeout-remove"></a><h3>gtk_timeout_remove ()</h3>
1219
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_timeout_remove                  (<em class="parameter"><code><span class="type">guint</span> timeout_handler_id</code></em>);</pre>
 
1219
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_timeout_remove                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> timeout_handler_id</code></em>);</pre>
1220
1220
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1221
1221
<h3 class="title">Warning</h3>
1222
 
<p><code class="literal">gtk_timeout_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_source_remove()</code> instead.</p>
 
1222
<p><code class="literal">gtk_timeout_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-source-remove"><code class="function">g_source_remove()</code></a> instead.</p>
1223
1223
</div>
1224
1224
<p>
1225
1225
Removes the given timeout destroying all information about it.
1235
1235
<hr>
1236
1236
<div class="refsect2">
1237
1237
<a name="gtk-idle-add"></a><h3>gtk_idle_add ()</h3>
1238
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_idle_add                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1239
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1238
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_idle_add                        (<em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
 
1239
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1240
1240
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1241
1241
<h3 class="title">Warning</h3>
1242
 
<p><code class="literal">gtk_idle_add</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_idle_add()</code> instead.</p>
 
1242
<p><code class="literal">gtk_idle_add</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-idle-add"><code class="function">g_idle_add()</code></a> instead.</p>
1243
1243
</div>
1244
1244
<p>
1245
1245
Causes the mainloop to call the given function whenever no events with
1267
1267
<hr>
1268
1268
<div class="refsect2">
1269
1269
<a name="gtk-idle-add-priority"></a><h3>gtk_idle_add_priority ()</h3>
1270
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_idle_add_priority               (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
 
1270
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_idle_add_priority               (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> priority</code></em>,
1271
1271
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1272
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1272
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1273
1273
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1274
1274
<h3 class="title">Warning</h3>
1275
 
<p><code class="literal">gtk_idle_add_priority</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_idle_add_full()</code> instead.</p>
 
1275
<p><code class="literal">gtk_idle_add_priority</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-idle-add-full"><code class="function">g_idle_add_full()</code></a> instead.</p>
1276
1276
</div>
1277
1277
<p>
1278
1278
Like <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()"><code class="function">gtk_idle_add()</code></a> this function allows you to have a function called
1284
1284
<tbody>
1285
1285
<tr>
1286
1286
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
1287
 
<td>The priority which should not be above <code class="literal">G_PRIORITY_HIGH_IDLE</code>.
 
1287
<td>The priority which should not be above <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#G-PRIORITY-HIGH-IDLE:CAPS"><code class="literal">G_PRIORITY_HIGH_IDLE</code></a>.
1288
1288
Note that you will interfere with GTK+ if you use a priority above
1289
1289
<a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE"><code class="literal">GTK_PRIORITY_RESIZE</code></a>.</td>
1290
1290
</tr>
1306
1306
<hr>
1307
1307
<div class="refsect2">
1308
1308
<a name="gtk-idle-add-full"></a><h3>gtk_idle_add_full ()</h3>
1309
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_idle_add_full                   (<em class="parameter"><code><span class="type">gint</span> priority</code></em>,
 
1309
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_idle_add_full                   (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> priority</code></em>,
1310
1310
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()"><span class="type">GtkFunction</span></a> function</code></em>,
1311
1311
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
1312
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1313
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
1312
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1313
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1314
1314
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1315
1315
<h3 class="title">Warning</h3>
1316
 
<p><code class="literal">gtk_idle_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_idle_add_full()</code> instead.</p>
 
1316
<p><code class="literal">gtk_idle_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-idle-add-full"><code class="function">g_idle_add_full()</code></a> instead.</p>
1317
1317
</div>
1318
1318
<p>
1319
1319
Like <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()"><code class="function">gtk_idle_add()</code></a> this function allows you to have a function called
1325
1325
<tbody>
1326
1326
<tr>
1327
1327
<td><p><span class="term"><em class="parameter"><code>priority</code></em> :</span></p></td>
1328
 
<td>The priority which should not be above <code class="literal">G_PRIORITY_HIGH_IDLE</code>.
 
1328
<td>The priority which should not be above <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#G-PRIORITY-HIGH-IDLE:CAPS"><code class="literal">G_PRIORITY_HIGH_IDLE</code></a>.
1329
1329
Note that you will interfere with GTK+ if you use a priority above
1330
1330
<a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE"><code class="literal">GTK_PRIORITY_RESIZE</code></a>.</td>
1331
1331
</tr>
1335
1335
</tr>
1336
1336
<tr>
1337
1337
<td><p><span class="term"><em class="parameter"><code>marshal</code></em> :</span></p></td>
1338
 
<td>The marshaller to use instead of the function (if non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>).</td>
 
1338
<td>The marshaller to use instead of the function (if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>
1339
1339
</tr>
1340
1340
<tr>
1341
1341
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1343
1343
</tr>
1344
1344
<tr>
1345
1345
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1346
 
<td>Function to call when the timeout is destroyed or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
 
1346
<td>Function to call when the timeout is destroyed or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1347
1347
</tr>
1348
1348
<tr>
1349
1349
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1355
1355
<hr>
1356
1356
<div class="refsect2">
1357
1357
<a name="gtk-idle-remove"></a><h3>gtk_idle_remove ()</h3>
1358
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_idle_remove                     (<em class="parameter"><code><span class="type">guint</span> idle_handler_id</code></em>);</pre>
 
1358
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_idle_remove                     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> idle_handler_id</code></em>);</pre>
1359
1359
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1360
1360
<h3 class="title">Warning</h3>
1361
 
<p><code class="literal">gtk_idle_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_source_remove()</code> instead.</p>
 
1361
<p><code class="literal">gtk_idle_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-source-remove"><code class="function">g_source_remove()</code></a> instead.</p>
1362
1362
</div>
1363
1363
<p>
1364
1364
Removes the idle function with the given id.
1374
1374
<hr>
1375
1375
<div class="refsect2">
1376
1376
<a name="gtk-idle-remove-by-data"></a><h3>gtk_idle_remove_by_data ()</h3>
1377
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_idle_remove_by_data             (<em class="parameter"><code><span class="type">gpointer</span> data</code></em>);</pre>
 
1377
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_idle_remove_by_data             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>);</pre>
1378
1378
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1379
1379
<h3 class="title">Warning</h3>
1380
 
<p><code class="literal">gtk_idle_remove_by_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_idle_remove_by_data()</code> instead.</p>
 
1380
<p><code class="literal">gtk_idle_remove_by_data</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-idle-remove-by-data"><code class="function">g_idle_remove_by_data()</code></a> instead.</p>
1381
1381
</div>
1382
1382
<p>
1383
1383
Removes the idle function identified by the user data.
1393
1393
<hr>
1394
1394
<div class="refsect2">
1395
1395
<a name="gtk-input-add-full"></a><h3>gtk_input_add_full ()</h3>
1396
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_input_add_full                  (<em class="parameter"><code><span class="type">gint</span> source</code></em>,
1397
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Input.html#GdkInputCondition"><span class="type">GdkInputCondition</span></a> condition</code></em>,
1398
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Input.html#GdkInputFunction"><span class="type">GdkInputFunction</span></a> function</code></em>,
 
1396
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_input_add_full                  (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> source</code></em>,
 
1397
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputCondition"><span class="type">GdkInputCondition</span></a> condition</code></em>,
 
1398
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputFunction"><span class="type">GdkInputFunction</span></a> function</code></em>,
1399
1399
                                                         <em class="parameter"><code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()"><span class="type">GtkCallbackMarshal</span></a> marshal</code></em>,
1400
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> data</code></em>,
1401
 
                                                         <em class="parameter"><code><span class="type">GDestroyNotify</span> destroy</code></em>);</pre>
 
1400
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> data</code></em>,
 
1401
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> destroy</code></em>);</pre>
1402
1402
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1403
1403
<h3 class="title">Warning</h3>
1404
 
<p><code class="literal">gtk_input_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_io_add_watch_full()</code> instead.</p>
 
1404
<p><code class="literal">gtk_input_add_full</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-IO-Channels.html#g-io-add-watch-full"><code class="function">g_io_add_watch_full()</code></a> instead.</p>
1405
1405
</div>
1406
1406
<p>
1407
1407
Registers a function to be called when a condition becomes true
1424
1424
</tr>
1425
1425
<tr>
1426
1426
<td><p><span class="term"><em class="parameter"><code>marshal</code></em> :</span></p></td>
1427
 
<td>The marshaller to use instead of the function (if non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>).</td>
 
1427
<td>The marshaller to use instead of the function (if non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>).</td>
1428
1428
</tr>
1429
1429
<tr>
1430
1430
<td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
1433
1433
<tr>
1434
1434
<td><p><span class="term"><em class="parameter"><code>destroy</code></em> :</span></p></td>
1435
1435
<td>callback function to call with <em class="parameter"><code>data</code></em> when the input
1436
 
handler is removed, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.</td>
 
1436
handler is removed, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</td>
1437
1437
</tr>
1438
1438
<tr>
1439
1439
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1445
1445
<hr>
1446
1446
<div class="refsect2">
1447
1447
<a name="gtk-input-remove"></a><h3>gtk_input_remove ()</h3>
1448
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_input_remove                    (<em class="parameter"><code><span class="type">guint</span> input_handler_id</code></em>);</pre>
 
1448
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_input_remove                    (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> input_handler_id</code></em>);</pre>
1449
1449
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1450
1450
<h3 class="title">Warning</h3>
1451
 
<p><code class="literal">gtk_input_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <code class="function">g_source_remove()</code> instead.</p>
 
1451
<p><code class="literal">gtk_input_remove</code> has been deprecated since version 2.4 and should not be used in newly-written code. Use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#g-source-remove"><code class="function">g_source_remove()</code></a> instead.</p>
1452
1452
</div>
1453
1453
<p>
1454
1454
Removes the function with the given id.
1468
1468
</pre>
1469
1469
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1470
1470
<h3 class="title">Warning</h3>
1471
 
<p><code class="literal">GTK_PRIORITY_REDRAW</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <a href="../gdk/gdk-Events.html#GDK-PRIORITY-REDRAW:CAPS"><code class="literal">GDK_PRIORITY_REDRAW</code></a> instead.</p>
 
1471
<p><code class="literal">GTK_PRIORITY_REDRAW</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <a href="http://library.gnome.org/devel/gdk3/gdk-Events.html#GDK-PRIORITY-REDRAW:CAPS"><code class="literal">GDK_PRIORITY_REDRAW</code></a> instead.</p>
1472
1472
</div>
1473
1473
<p>
1474
1474
Use this priority for redrawing related stuff. It is used internally by
1495
1495
</pre>
1496
1496
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1497
1497
<h3 class="title">Warning</h3>
1498
 
<p><code class="literal">GTK_PRIORITY_HIGH</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <code class="literal">G_PRIORITY_HIGH</code> instead.</p>
 
1498
<p><code class="literal">GTK_PRIORITY_HIGH</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#G-PRIORITY-HIGH:CAPS"><code class="literal">G_PRIORITY_HIGH</code></a> instead.</p>
1499
1499
</div>
1500
1500
<p>
1501
1501
Use this for high priority timeouts. This priority is never used inside
1523
1523
</pre>
1524
1524
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1525
1525
<h3 class="title">Warning</h3>
1526
 
<p><code class="literal">GTK_PRIORITY_DEFAULT</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <code class="literal">G_PRIORITY_DEFAULT_IDLE</code> instead.</p>
 
1526
<p><code class="literal">GTK_PRIORITY_DEFAULT</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#G-PRIORITY-DEFAULT-IDLE:CAPS"><code class="literal">G_PRIORITY_DEFAULT_IDLE</code></a> instead.</p>
1527
1527
</div>
1528
1528
<p>
1529
1529
Default priority for idle functions.
1536
1536
</pre>
1537
1537
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1538
1538
<h3 class="title">Warning</h3>
1539
 
<p><code class="literal">GTK_PRIORITY_LOW</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <code class="literal">G_PRIORITY_LOW</code> instead.</p>
 
1539
<p><code class="literal">GTK_PRIORITY_LOW</code> has been deprecated since version 2.4 and should not be used in newly-written code. This macro is deprecated. You should use <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#G-PRIORITY-LOW:CAPS"><code class="literal">G_PRIORITY_LOW</code></a> instead.</p>
1540
1540
</div>
1541
1541
<p>
1542
1542
Priority for very unimportant background tasks.
1545
1545
<hr>
1546
1546
<div class="refsect2">
1547
1547
<a name="gtk-key-snooper-install"></a><h3>gtk_key_snooper_install ()</h3>
1548
 
<pre class="programlisting"><span class="returnvalue">guint</span>               gtk_key_snooper_install             (<em class="parameter"><code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()"><span class="type">GtkKeySnoopFunc</span></a> snooper</code></em>,
1549
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> func_data</code></em>);</pre>
 
1548
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_key_snooper_install             (<em class="parameter"><code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()"><span class="type">GtkKeySnoopFunc</span></a> snooper</code></em>,
 
1549
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>);</pre>
1550
1550
<p>
1551
1551
Installs a key snooper function, which will get called on all key events
1552
1552
before delivering them normally.
1572
1572
<hr>
1573
1573
<div class="refsect2">
1574
1574
<a name="GtkKeySnoopFunc"></a><h3>GtkKeySnoopFunc ()</h3>
1575
 
<pre class="programlisting"><span class="returnvalue">gint</span>                (*GtkKeySnoopFunc)                  (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *grab_widget</code></em>,
1576
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>,
1577
 
                                                         <em class="parameter"><code><span class="type">gpointer</span> func_data</code></em>);</pre>
 
1575
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                (*GtkKeySnoopFunc)                  (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *grab_widget</code></em>,
 
1576
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey"><span class="type">GdkEventKey</span></a> *event</code></em>,
 
1577
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> func_data</code></em>);</pre>
1578
1578
<p>
1579
1579
Key snooper functions are called before normal event delivery.
1580
1580
They can be used to implement custom key event handling.
1597
1597
<tr>
1598
1598
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1599
1599
<td>
1600
 
<code class="literal">TRUE</code> to stop further processing of <em class="parameter"><code>event</code></em>, <code class="literal">FALSE</code> to continue.</td>
 
1600
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop further processing of <em class="parameter"><code>event</code></em>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to continue.</td>
1601
1601
</tr>
1602
1602
</tbody>
1603
1603
</table></div>
1605
1605
<hr>
1606
1606
<div class="refsect2">
1607
1607
<a name="gtk-key-snooper-remove"></a><h3>gtk_key_snooper_remove ()</h3>
1608
 
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_key_snooper_remove              (<em class="parameter"><code><span class="type">guint</span> snooper_handler_id</code></em>);</pre>
 
1608
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_key_snooper_remove              (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> snooper_handler_id</code></em>);</pre>
1609
1609
<p>
1610
1610
Removes the key snooper function with the given id.
1611
1611
</p>
1620
1620
<hr>
1621
1621
<div class="refsect2">
1622
1622
<a name="gtk-get-current-event"></a><h3>gtk_get_current_event ()</h3>
1623
 
<pre class="programlisting"><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *          gtk_get_current_event               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
1623
<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="returnvalue">GdkEvent</span></a> *          gtk_get_current_event               (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1624
1624
<p>
1625
1625
Obtains a copy of the event currently being processed by GTK+.  For
1626
1626
example, if you get a "clicked" signal from <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a>, the current
1627
 
event will be the <a href="../gdk/gdk-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> that triggered the "clicked"
1628
 
signal. The returned event must be freed with <a href="../gdk/gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.
1629
 
If there is no current event, the function returns <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>.
 
1627
event will be the <a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventButton"><span class="type">GdkEventButton</span></a> that triggered the "clicked"
 
1628
signal. The returned event must be freed with <a href="http://library.gnome.org/devel/gdk3/gdk-Events.html#gdk-event-free"><code class="function">gdk_event_free()</code></a>.
 
1629
If there is no current event, the function returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1630
1630
</p>
1631
1631
<div class="variablelist"><table border="0">
1632
1632
<col align="left" valign="top">
1633
1633
<tbody><tr>
1634
1634
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1635
 
<td>a copy of the current event, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> if no
 
1635
<td>a copy of the current event, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no
1636
1636
current event. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
1637
1637
</td>
1638
1638
</tr></tbody>
1641
1641
<hr>
1642
1642
<div class="refsect2">
1643
1643
<a name="gtk-get-current-event-time"></a><h3>gtk_get_current_event_time ()</h3>
1644
 
<pre class="programlisting"><span class="returnvalue">guint32</span>             gtk_get_current_event_time          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 
1644
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32"><span class="returnvalue">guint32</span></a>             gtk_get_current_event_time          (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
1645
1645
<p>
1646
1646
If there is a current event and it has a timestamp, return that
1647
 
timestamp, otherwise return <a href="../gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.
 
1647
timestamp, otherwise return <a href="http://library.gnome.org/devel/gdk3/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.
1648
1648
</p>
1649
1649
<div class="variablelist"><table border="0">
1650
1650
<col align="left" valign="top">
1651
1651
<tbody><tr>
1652
1652
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1653
 
<td>the timestamp from the current event, or <a href="../gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.</td>
 
1653
<td>the timestamp from the current event, or <a href="http://library.gnome.org/devel/gdk3/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.</td>
1654
1654
</tr></tbody>
1655
1655
</table></div>
1656
1656
</div>
1657
1657
<hr>
1658
1658
<div class="refsect2">
1659
1659
<a name="gtk-get-current-event-state"></a><h3>gtk_get_current_event_state ()</h3>
1660
 
<pre class="programlisting"><span class="returnvalue">gboolean</span>            gtk_get_current_event_state         (<em class="parameter"><code><a href="../gdk/gdk-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> *state</code></em>);</pre>
 
1660
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_get_current_event_state         (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkModifierType"><span class="type">GdkModifierType</span></a> *state</code></em>);</pre>
1661
1661
<p>
1662
1662
If there is a current event and it has a state field, place
1663
 
that state field in <em class="parameter"><code>state</code></em> and return <code class="literal">TRUE</code>, otherwise return
1664
 
<code class="literal">FALSE</code>.
 
1663
that state field in <em class="parameter"><code>state</code></em> and return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, otherwise return
 
1664
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.
1665
1665
</p>
1666
1666
<div class="variablelist"><table border="0">
1667
1667
<col align="left" valign="top">
1674
1674
<tr>
1675
1675
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1676
1676
<td>
1677
 
<code class="literal">TRUE</code> if there was a current event and it had a state field</td>
 
1677
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if there was a current event and it had a state field</td>
1678
1678
</tr>
1679
1679
</tbody>
1680
1680
</table></div>
1682
1682
<hr>
1683
1683
<div class="refsect2">
1684
1684
<a name="gtk-get-event-widget"></a><h3>gtk_get_event_widget ()</h3>
1685
 
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_get_event_widget                (<em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
 
1685
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_get_event_widget                (<em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
1686
1686
<p>
1687
 
If <em class="parameter"><code>event</code></em> is <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> or the event was not associated with any widget,
1688
 
returns <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>, otherwise returns the widget that received the event
 
1687
If <em class="parameter"><code>event</code></em> is <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> or the event was not associated with any widget,
 
1688
returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, otherwise returns the widget that received the event
1689
1689
originally.
1690
1690
</p>
1691
1691
<div class="variablelist"><table border="0">
1693
1693
<tbody>
1694
1694
<tr>
1695
1695
<td><p><span class="term"><em class="parameter"><code>event</code></em> :</span></p></td>
1696
 
<td>a <a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>
 
1696
<td>a <a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a>
1697
1697
</td>
1698
1698
</tr>
1699
1699
<tr>
1700
1700
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1701
1701
<td>the widget that originally
1702
 
received <em class="parameter"><code>event</code></em>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
 
1702
received <em class="parameter"><code>event</code></em>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
1703
1703
</td>
1704
1704
</tr>
1705
1705
</tbody>
1709
1709
<div class="refsect2">
1710
1710
<a name="gtk-propagate-event"></a><h3>gtk_propagate_event ()</h3>
1711
1711
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_propagate_event                 (<em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
1712
 
                                                         <em class="parameter"><code><a href="../gdk/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
 
1712
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent"><span class="type">GdkEvent</span></a> *event</code></em>);</pre>
1713
1713
<p>
1714
1714
Sends an event to a widget, propagating the event to parent widgets
1715
1715
if the event remains unhandled. Events received by GTK+ from GDK
1726
1726
All that said, you most likely don't want to use any of these
1727
1727
functions; synthesizing events is rarely needed. Consider asking on
1728
1728
the mailing list for better ways to achieve your goals. For
1729
 
example, use <a href="../gdk/gdk-Windows.html#gdk-window-invalidate-rect"><code class="function">gdk_window_invalidate_rect()</code></a> or
 
1729
example, use <a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#gdk-window-invalidate-rect"><code class="function">gdk_window_invalidate_rect()</code></a> or
1730
1730
<a class="link" href="GtkWidget.html#gtk-widget-queue-draw" title="gtk_widget_queue_draw ()"><code class="function">gtk_widget_queue_draw()</code></a> instead of making up expose events.
1731
1731
</p>
1732
1732
<div class="variablelist"><table border="0">
1748
1748
<div class="refsect1">
1749
1749
<a name="gtk-General.see-also"></a><h2>See Also</h2>
1750
1750
<p>
1751
 
See the GLib manual, especially <span class="type">GMainLoop</span> and signal-related
1752
 
functions such as <code class="function">g_signal_connect()</code>.
 
1751
See the GLib manual, especially <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop"><span class="type">GMainLoop</span></a> and signal-related
 
1752
functions such as <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect"><code class="function">g_signal_connect()</code></a>.
1753
1753
</p>
1754
1754
</div>
1755
1755
</div>
1756
1756
<div class="footer">
1757
1757
<hr>
1758
 
          Generated by GTK-Doc V1.17.1</div>
 
1758
          Generated by GTK-Doc V1.17</div>
1759
1759
</body>
1760
1760
</html>
 
 
b'\\ No newline at end of file'