~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * <a class="link" href="gtk-General.html#gtk-set-locale" title="gtk_set_locale ()">gtk_set_locale</a> (<code>void</code>);

gchar * <a class="link" href="gtk-General.html#gtk-set-locale" title="gtk_set_locale ()">gtk_set_locale</a> (<code>void</code>);

void <a class="link" href="gtk-General.html#gtk-disable-setlocale" title="gtk_disable_setlocale ()">gtk_disable_setlocale</a> (<code>void</code>);

<a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> * <a class="link" href="gtk-General.html#gtk-get-default-language" title="gtk_get_default_language ()">gtk_get_default_language</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-parse-args" title="gtk_parse_args ()">gtk_parse_args</a> (<code>int *argc</code>,

<a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> * <a class="link" href="gtk-General.html#gtk-get-default-language" title="gtk_get_default_language ()">gtk_get_default_language</a> (<code>void</code>);

gboolean <a class="link" href="gtk-General.html#gtk-parse-args" title="gtk_parse_args ()">gtk_parse_args</a> (<code>int *argc</code>,

<code>char ***argv</code>);

void <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()">gtk_init</a> (<code>int *argc</code>,

<code>char ***argv</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()">gtk_init_check</a> (<code>int *argc</code>,

gboolean <a class="link" href="gtk-General.html#gtk-init-check" title="gtk_init_check ()">gtk_init_check</a> (<code>int *argc</code>,

<code>char ***argv</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()">gtk_init_with_args</a> (<code>int *argc</code>,

gboolean <a class="link" href="gtk-General.html#gtk-init-with-args" title="gtk_init_with_args ()">gtk_init_with_args</a> (<code>int *argc</code>,

<code>char ***argv</code>,

<code>const char *parameter_string</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry">GOptionEntry</a> *entries</code>,

<code>GOptionEntry *entries</code>,

<code>const char *translation_domain</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup">GOptionGroup</a> * <a class="link" href="gtk-General.html#gtk-get-option-group" title="gtk_get_option_group ()">gtk_get_option_group</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> open_default_display</code>);

void <a class="link" href="gtk-General.html#gtk-exit" title="gtk_exit ()">gtk_exit</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> error_code</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-events-pending" title="gtk_events_pending ()">gtk_events_pending</a> (<code>void</code>);

<code>GError **error</code>);

GOptionGroup * <a class="link" href="gtk-General.html#gtk-get-option-group" title="gtk_get_option_group ()">gtk_get_option_group</a> (<code>gboolean open_default_display</code>);

void <a class="link" href="gtk-General.html#gtk-exit" title="gtk_exit ()">gtk_exit</a> (<code>gint error_code</code>);

gboolean <a class="link" href="gtk-General.html#gtk-events-pending" title="gtk_events_pending ()">gtk_events_pending</a> (<code>void</code>);

void <a class="link" href="gtk-General.html#gtk-main" title="gtk_main ()">gtk_main</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-main-level" title="gtk_main_level ()">gtk_main_level</a> (<code>void</code>);

guint <a class="link" href="gtk-General.html#gtk-main-level" title="gtk_main_level ()">gtk_main_level</a> (<code>void</code>);

void <a class="link" href="gtk-General.html#gtk-main-quit" title="gtk_main_quit ()">gtk_main_quit</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-main-iteration" title="gtk_main_iteration ()">gtk_main_iteration</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-main-iteration-do" title="gtk_main_iteration_do ()">gtk_main_iteration_do</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> blocking</code>);

void <a class="link" href="gtk-General.html#gtk-main-do-event" title="gtk_main_do_event ()">gtk_main_do_event</a> (<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

void (<a class="link" href="gtk-General.html#GtkModuleInitFunc" title="GtkModuleInitFunc ()">*GtkModuleInitFunc</a>) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *argc</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> ***argv</code>);

void (<a class="link" href="gtk-General.html#GtkModuleDisplayInitFunc" title="GtkModuleDisplayInitFunc ()">*GtkModuleDisplayInitFunc</a>) (<code><a href="../gdk/GdkDisplay.html">GdkDisplay</a> *display</code>);

gboolean <a class="link" href="gtk-General.html#gtk-main-iteration" title="gtk_main_iteration ()">gtk_main_iteration</a> (<code>void</code>);

gboolean <a class="link" href="gtk-General.html#gtk-main-iteration-do" title="gtk_main_iteration_do ()">gtk_main_iteration_do</a> (<code>gboolean blocking</code>);

void <a class="link" href="gtk-General.html#gtk-main-do-event" title="gtk_main_do_event ()">gtk_main_do_event</a> (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

<code>gchar ***argv</code>);

void (<a class="link" href="gtk-General.html#GtkModuleDisplayInitFunc" title="GtkModuleDisplayInitFunc ()">*GtkModuleDisplayInitFunc</a>) (<code><a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html">GdkDisplay</a> *display</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-true" title="gtk_true ()">gtk_true</a> (<code>void</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> <a class="link" href="gtk-General.html#gtk-false" title="gtk_false ()">gtk_false</a> (<code>void</code>);

gboolean <a class="link" href="gtk-General.html#gtk-true" title="gtk_true ()">gtk_true</a> (<code>void</code>);

gboolean <a class="link" href="gtk-General.html#gtk-false" title="gtk_false ()">gtk_false</a> (<code>void</code>);

void <a class="link" href="gtk-General.html#gtk-grab-add" title="gtk_grab_add ()">gtk_grab_add</a> (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>);

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="gtk-General.html#gtk-grab-get-current" title="gtk_grab_get_current ()">gtk_grab_get_current</a> (<code>void</code>);

void <a class="link" href="gtk-General.html#gtk-grab-remove" title="gtk_grab_remove ()">gtk_grab_remove</a> (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>);

void <a class="link" href="gtk-General.html#gtk-init-add" title="gtk_init_add ()">gtk_init_add</a> (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

void <a class="link" href="gtk-General.html#gtk-quit-add-destroy" title="gtk_quit_add_destroy ()">gtk_quit_add_destroy</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

<code>gpointer data</code>);

void <a class="link" href="gtk-General.html#gtk-quit-add-destroy" title="gtk_quit_add_destroy ()">gtk_quit_add_destroy</a> (<code>guint main_level</code>,

<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()">gtk_quit_add</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-quit-add-full" title="gtk_quit_add_full ()">gtk_quit_add_full</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

void <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()">gtk_quit_remove</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> quit_handler_id</code>);

void <a class="link" href="gtk-General.html#gtk-quit-remove-by-data" title="gtk_quit_remove_by_data ()">gtk_quit_remove_by_data</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-timeout-add-full" title="gtk_timeout_add_full ()">gtk_timeout_add_full</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> interval</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-timeout-add" title="gtk_timeout_add ()">gtk_timeout_add</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> interval</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

100

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

101

void <a class="link" href="gtk-General.html#gtk-timeout-remove" title="gtk_timeout_remove ()">gtk_timeout_remove</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> timeout_handler_id</code>);

102

103

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()">gtk_idle_add</a> (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

104

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

105

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-idle-add-priority" title="gtk_idle_add_priority ()">gtk_idle_add_priority</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> priority</code>,

106

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

108

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-idle-add-full" title="gtk_idle_add_full ()">gtk_idle_add_full</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> priority</code>,

109

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

110

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

111

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

112

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

113

void <a class="link" href="gtk-General.html#gtk-idle-remove" title="gtk_idle_remove ()">gtk_idle_remove</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> idle_handler_id</code>);

114

void <a class="link" href="gtk-General.html#gtk-idle-remove-by-data" title="gtk_idle_remove_by_data ()">gtk_idle_remove_by_data</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);

115

116

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-input-add-full" title="gtk_input_add_full ()">gtk_input_add_full</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> source</code>,

117

<code><a href="../gdk/gdk-Input.html#GdkInputCondition">GdkInputCondition</a> condition</code>,

118

<code><a href="../gdk/gdk-Input.html#GdkInputFunction">GdkInputFunction</a> function</code>,

119

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

120

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

121

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);

122

void <a class="link" href="gtk-General.html#gtk-input-remove" title="gtk_input_remove ()">gtk_input_remove</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> input_handler_id</code>);

guint <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()">gtk_quit_add</a> (<code>guint main_level</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code>gpointer data</code>);

guint <a class="link" href="gtk-General.html#gtk-quit-add-full" title="gtk_quit_add_full ()">gtk_quit_add_full</a> (<code>guint main_level</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

<code>gpointer data</code>,

<code>GDestroyNotify destroy</code>);

void <a class="link" href="gtk-General.html#gtk-quit-remove" title="gtk_quit_remove ()">gtk_quit_remove</a> (<code>guint quit_handler_id</code>);

void <a class="link" href="gtk-General.html#gtk-quit-remove-by-data" title="gtk_quit_remove_by_data ()">gtk_quit_remove_by_data</a> (<code>gpointer data</code>);

guint <a class="link" href="gtk-General.html#gtk-timeout-add-full" title="gtk_timeout_add_full ()">gtk_timeout_add_full</a> (<code>guint32 interval</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

<code>gpointer data</code>,

<code>GDestroyNotify destroy</code>);

guint <a class="link" href="gtk-General.html#gtk-timeout-add" title="gtk_timeout_add ()">gtk_timeout_add</a> (<code>guint32 interval</code>,

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

100

<code>gpointer data</code>);

101

void <a class="link" href="gtk-General.html#gtk-timeout-remove" title="gtk_timeout_remove ()">gtk_timeout_remove</a> (<code>guint timeout_handler_id</code>);

102

103

guint <a class="link" href="gtk-General.html#gtk-idle-add" title="gtk_idle_add ()">gtk_idle_add</a> (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

104

<code>gpointer data</code>);

105

guint <a class="link" href="gtk-General.html#gtk-idle-add-priority" title="gtk_idle_add_priority ()">gtk_idle_add_priority</a> (<code>gint priority</code>,

106

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

107

<code>gpointer data</code>);

108

guint <a class="link" href="gtk-General.html#gtk-idle-add-full" title="gtk_idle_add_full ()">gtk_idle_add_full</a> (<code>gint priority</code>,

109

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

110

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

111

<code>gpointer data</code>,

112

<code>GDestroyNotify destroy</code>);

113

void <a class="link" href="gtk-General.html#gtk-idle-remove" title="gtk_idle_remove ()">gtk_idle_remove</a> (<code>guint idle_handler_id</code>);

114

void <a class="link" href="gtk-General.html#gtk-idle-remove-by-data" title="gtk_idle_remove_by_data ()">gtk_idle_remove_by_data</a> (<code>gpointer data</code>);

115

116

guint <a class="link" href="gtk-General.html#gtk-input-add-full" title="gtk_input_add_full ()">gtk_input_add_full</a> (<code>gint source</code>,

117

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputCondition">GdkInputCondition</a> condition</code>,

118

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputFunction">GdkInputFunction</a> function</code>,

119

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

120

<code>gpointer data</code>,

121

<code>GDestroyNotify destroy</code>);

122

void <a class="link" href="gtk-General.html#gtk-input-remove" title="gtk_input_remove ()">gtk_input_remove</a> (<code>guint input_handler_id</code>);

123

124

#define <a class="link" href="gtk-General.html#GTK-PRIORITY-REDRAW:CAPS" title="GTK_PRIORITY_REDRAW">GTK_PRIORITY_REDRAW</a>

125

#define <a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE">GTK_PRIORITY_RESIZE</a>

128

#define <a class="link" href="gtk-General.html#GTK-PRIORITY-DEFAULT:CAPS" title="GTK_PRIORITY_DEFAULT">GTK_PRIORITY_DEFAULT</a>

129

#define <a class="link" href="gtk-General.html#GTK-PRIORITY-LOW:CAPS" title="GTK_PRIORITY_LOW">GTK_PRIORITY_LOW</a>

130

131

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> <a class="link" href="gtk-General.html#gtk-key-snooper-install" title="gtk_key_snooper_install ()">gtk_key_snooper_install</a> (<code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">GtkKeySnoopFunc</a> snooper</code>,

132

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> func_data</code>);

133

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> (<a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">*GtkKeySnoopFunc</a>) (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *grab_widget</code>,

134

<code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>,

135

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> func_data</code>);

136

void <a class="link" href="gtk-General.html#gtk-key-snooper-remove" title="gtk_key_snooper_remove ()">gtk_key_snooper_remove</a> (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> snooper_handler_id</code>);

131

guint <a class="link" href="gtk-General.html#gtk-key-snooper-install" title="gtk_key_snooper_install ()">gtk_key_snooper_install</a> (<code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">GtkKeySnoopFunc</a> snooper</code>,

132

<code>gpointer func_data</code>);

133

gint (<a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">*GtkKeySnoopFunc</a>) (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *grab_widget</code>,

134

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>,

135

<code>gpointer func_data</code>);

136

void <a class="link" href="gtk-General.html#gtk-key-snooper-remove" title="gtk_key_snooper_remove ()">gtk_key_snooper_remove</a> (<code>guint snooper_handler_id</code>);

137

138

<a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> * <a class="link" href="gtk-General.html#gtk-get-current-event" title="gtk_get_current_event ()">gtk_get_current_event</a> (<code>void</code>);

139

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</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> (<code>void</code>);

140

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</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> (<code><a href="../gdk/gdk-Windows.html#GdkModifierType">GdkModifierType</a> *state</code>);

141

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="gtk-General.html#gtk-get-event-widget" title="gtk_get_event_widget ()">gtk_get_event_widget</a> (<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

138

<a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> * <a class="link" href="gtk-General.html#gtk-get-current-event" title="gtk_get_current_event ()">gtk_get_current_event</a> (<code>void</code>);

139

guint32 <a class="link" href="gtk-General.html#gtk-get-current-event-time" title="gtk_get_current_event_time ()">gtk_get_current_event_time</a> (<code>void</code>);

140

gboolean <a class="link" href="gtk-General.html#gtk-get-current-event-state" title="gtk_get_current_event_state ()">gtk_get_current_event_state</a> (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkModifierType">GdkModifierType</a> *state</code>);

141

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="gtk-General.html#gtk-get-event-widget" title="gtk_get_event_widget ()">gtk_get_event_widget</a> (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

142

void <a class="link" href="gtk-General.html#gtk-propagate-event" title="gtk_propagate_event ()">gtk_propagate_event</a> (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>,

143

<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

143

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);

144

</pre>

145

</div>

146

175

to the main loop and await more user input.

176

177

178

<a name="id398712"></a>Example 2. Typical <code class="function">main</code> function for a GTK+ application

178

<a name="id538524"></a>Example 2. Typical <code class="function">main</code> function for a GTK+ application

179

180

181

<tbody>

224

</div>

225

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 <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> in the GLib

227

though it involves slightly more typing. See GMainLoop in the GLib

228

documentation.

229

230

</div>

232

<a name="gtk-General.details"></a><h2>Details</h2>

233

234

<a name="gtk-set-locale"></a><h3>gtk_set_locale ()</h3>

235

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> * gtk_set_locale (<code>void</code>);</pre>

235

<pre class="programlisting">gchar * gtk_set_locale (<code>void</code>);</pre>

236

237

<h3 class="title">Warning</h3>

238

<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

238

<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

239

</div>

240

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>

265

<td>a string corresponding to the locale set, typically in the

266

form lang_COUNTRY, where lang is an ISO-639 language code, and

267

COUNTRY is an ISO-3166 country code. On Unix, this form matches the

268

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

268

result of the <code class="function">setlocale()</code>; it is also used on other machines, such as

269

Windows, where the C library returns a different result. The string is

270

owned by GTK+ and should not be modified or freed.</td>

271

</tr></tbody>

290

<hr>

291

292

<a name="gtk-get-default-language"></a><h3>gtk_get_default_language ()</h3>

293

<pre class="programlisting"><a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> * gtk_get_default_language (<code>void</code>);</pre>

293

<pre class="programlisting"><a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> * gtk_get_default_language (<code>void</code>);</pre>

294

295

Returns the <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> for the default language currently in

295

Returns the <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a> for the default language currently in

296

effect. (Note that this can change over the life of an

297

application.) The default language is derived from the current

298

locale. It determines, for example, whether GTK+ uses the

299

right-to-left or left-to-right text direction.

300

301

302

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

302

This function is equivalent to <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#pango-language-get-default"><code class="function">pango_language_get_default()</code></a>. See

303

that function for details.

304

305

309

</colgroup>

310

311

<td>Returns :</td>

312

<td>the default language as a <a href="/usr/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a>, must not be

312

<td>the default language as a <a href="/home/mclasen/gnome/share/gtk-doc/html/pango/pango-Scripts-and-Languages.html#PangoLanguage">PangoLanguage</a>, must not be

313

freed</td>

314

</tr></tbody>

315

</table></div>

317

<hr>

318

319

<a name="gtk-parse-args"></a><h3>gtk_parse_args ()</h3>

320

<pre class="programlisting">gboolean gtk_parse_args (<code>int *argc</code>,

321

322

323

Parses command line arguments, and initializes global

324

attributes of GTK+, but does not actually open a connection

325

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>)

325

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>)

326

327

328

Any arguments used by GTK+ or GDK are removed from the array and

352

<tr>

353

<td>Returns :</td>

354

<td>

355

<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>

355

<code class="literal">TRUE</code> if initialization succeeded, otherwise <code class="literal">FALSE</code>.</td>

356

</tr>

357

</tbody>

358

</table></div>

374

375

Note that there are some alternative ways to initialize GTK+:

376

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>,

377

<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

377

<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

378

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>,

379

you don't have to call <a class="link" href="gtk-General.html#gtk-init" title="gtk_init ()"><code class="function">gtk_init()</code></a>.

380

438

<hr>

439

440

<a name="gtk-init-check"></a><h3>gtk_init_check ()</h3>

441

<pre class="programlisting">gboolean gtk_init_check (<code>int *argc</code>,

442

443

444

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

445

a single change: It does not terminate the program if the GUI can't be

446

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.

446

initialized. Instead it returns <code class="literal">FALSE</code> on failure.

447

448

449

This way the application can fall back to some other means of communication

470

<tr>

471

<td>Returns :</td>

472

<td>

473

<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,

474

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>

473

<code class="literal">TRUE</code> if the GUI has been successfully initialized,

474

<code class="literal">FALSE</code> otherwise.</td>

475

</tr>

476

</tbody>

477

</table></div>

479

<hr>

480

481

482

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_init_with_args (<code>int *argc</code>,

482

<pre class="programlisting">gboolean gtk_init_with_args (<code>int *argc</code>,

483

<code>char ***argv</code>,

484

<code>const char *parameter_string</code>,

485

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry">GOptionEntry</a> *entries</code>,

485

<code>GOptionEntry *entries</code>,

486

<code>const char *translation_domain</code>,

487

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError">GError</a> **error</code>);</pre>

487

<code>GError **error</code>);</pre>

488

489

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>.

490

Additionally, it allows you to add your own commandline options,

517

</tr>

518

<tr>

519

<td><code>entries</code> :</td>

520

<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

521

of <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionEntry">GOptionEntry</a>s describing the options of your program. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

520

<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

521

of GOptionEntrys describing the options of your program. [<acronym title="Parameter points to an array of items.">array</acronym> zero-terminated=1]

522

</td>

523

</tr>

524

<tr>

525

<td><code>translation_domain</code> :</td>

526

<td>a translation domain to use for translating

527

the <code class="option">--help</code> output for the options in <code>entries</code>

528

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>

528

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>

529

</td>

530

</tr>

531

<tr>

535

<tr>

536

<td>Returns :</td>

537

<td>

538

<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,

539

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.</td>

538

<code class="literal">TRUE</code> if the GUI has been successfully initialized,

539

<code class="literal">FALSE</code> otherwise.</td>

540

</tr>

541

</tbody>

542

</table></div>

545

<hr>

546

547

<a name="gtk-get-option-group"></a><h3>gtk_get_option_group ()</h3>

548

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup">GOptionGroup</a> * gtk_get_option_group (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> open_default_display</code>);</pre>

548

<pre class="programlisting">GOptionGroup * gtk_get_option_group (<code>gboolean open_default_display</code>);</pre>

549

550

Returns a <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup">GOptionGroup</a> for the commandline arguments recognized

551

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">GOptionContext</a>

552

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

553

<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.

550

Returns a GOptionGroup for the commandline arguments recognized

551

by GTK+ and GDK. You should add this group to your GOptionContext

552

with <code class="function">g_option_context_add_group()</code>, if you are using

553

<code class="function">g_option_context_parse()</code> to parse your commandline arguments.

554

555

556

565

</tr>

566

<tr>

567

<td>Returns :</td>

568

<td>a <a href="http://library.gnome.org/devel/glib/unstable/glib-Commandline-option-parser.html#GOptionGroup">GOptionGroup</a> for the commandline arguments recognized

568

<td>a GOptionGroup for the commandline arguments recognized

569

by GTK+</td>

570

</tr>

571

</tbody>

575

<hr>

576

577

578

<pre class="programlisting">void gtk_exit (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> error_code</code>);</pre>

578

<pre class="programlisting">void gtk_exit (<code>gint error_code</code>);</pre>

579

580

<h3 class="title">Warning</h3>

581

<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.

600

<hr>

601

602

<a name="gtk-events-pending"></a><h3>gtk_events_pending ()</h3>

603

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_events_pending (<code>void</code>);</pre>

603

<pre class="programlisting">gboolean gtk_events_pending (<code>void</code>);</pre>

604

605

Checks if any events are pending. This can be used to update the GUI

606

and invoke timeouts etc. while doing some time intensive computation.

607

608

609

<a name="id414549"></a>Example 3. Updating the GUI during a long computation.

609

<a name="id552231"></a>Example 3. Updating the GUI during a long computation.

610

611

612

<tbody>

637

638

<td>Returns :</td>

639

<td>

640

<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>

640

<code class="literal">TRUE</code> if any events are pending, <code class="literal">FALSE</code> otherwise.</td>

641

</tr></tbody>

642

</table></div>

643

</div>

654

<hr>

655

656

<a name="gtk-main-level"></a><h3>gtk_main_level ()</h3>

657

<pre class="programlisting">guint gtk_main_level (<code>void</code>);</pre>

658

659

Asks for the current nesting level of the main loop. This can be useful

660

when calling <a class="link" href="gtk-General.html#gtk-quit-add" title="gtk_quit_add ()"><code class="function">gtk_quit_add()</code></a>.

682

<hr>

683

684

<a name="gtk-main-iteration"></a><h3>gtk_main_iteration ()</h3>

685

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_main_iteration (<code>void</code>);</pre>

685

<pre class="programlisting">gboolean gtk_main_iteration (<code>void</code>);</pre>

686

687

Runs a single iteration of the mainloop. If no events are waiting to be

688

processed GTK+ will block until the next event is noticed. If you don't

697

698

<td>Returns :</td>

699

<td>

700

<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>

700

<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>

701

</tr></tbody>

702

</table></div>

703

</div>

704

<hr>

705

706

<a name="gtk-main-iteration-do"></a><h3>gtk_main_iteration_do ()</h3>

707

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_main_iteration_do (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> blocking</code>);</pre>

707

<pre class="programlisting">gboolean gtk_main_iteration_do (<code>gboolean blocking</code>);</pre>

708

709

Runs a single iteration of the mainloop. If no events are available either

710

return or block dependent on the value of <code>blocking</code>.

718

<tr>

719

<td><code>blocking</code> :</td>

720

<td>

721

<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>

721

<code class="literal">TRUE</code> if you want GTK+ to block if no events are pending.</td>

722

</tr>

723

<tr>

724

<td>Returns :</td>

725

<td>

726

727

</tr>

728

</tbody>

729

</table></div>

731

<hr>

732

733

<a name="gtk-main-do-event"></a><h3>gtk_main_do_event ()</h3>

734

<pre class="programlisting">void gtk_main_do_event (<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

734

<pre class="programlisting">void gtk_main_do_event (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

735

736

Processes a single GDK event. This is public only to allow filtering of events

737

between GDK and GTK+. You will not usually need to call this function directly.

805

<hr>

806

807

<a name="GtkModuleInitFunc"></a><h3>GtkModuleInitFunc ()</h3>

808

<pre class="programlisting">void (*GtkModuleInitFunc) (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> *argc</code>,

809

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar">gchar</a> ***argv</code>);</pre>

808

<pre class="programlisting">void (*GtkModuleInitFunc) (<code>gint *argc</code>,

809

<code>gchar ***argv</code>);</pre>

810

811

Each GTK+ module must have a function <code class="function">gtk_module_init()</code> with this prototype.

812

This function is called after loading the module with the <code>argc</code> and <code>argv</code>

832

<hr>

833

834

<a name="GtkModuleDisplayInitFunc"></a><h3>GtkModuleDisplayInitFunc ()</h3>

835

<pre class="programlisting">void (*GtkModuleDisplayInitFunc) (<code><a href="../gdk/GdkDisplay.html">GdkDisplay</a> *display</code>);</pre>

835

<pre class="programlisting">void (*GtkModuleDisplayInitFunc) (<code><a href="http://library.gnome.org/devel/gdk3/GdkDisplay.html">GdkDisplay</a> *display</code>);</pre>

836

837

838

Since 2.2

840

<hr>

841

842

843

<pre class="programlisting">gboolean gtk_true (<code>void</code>);</pre>

844

845

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

845

All this function does it to return <code class="literal">TRUE</code>. This can be useful for example

846

if you want to inhibit the deletion of a window. Of course you should

847

not do this as the user expects a reaction from clicking the close

848

icon of the window...

849

850

851

<a name="id415470"></a>Example 4. A persistent window

851

<a name="id553171"></a>Example 4. A persistent window

852

853

854

<tbody>

880

<a href="gtk-General.html#gtk-init">gtk_init</a>( &argc, &argv );

881

win = <a href="GtkWindow.html#gtk-window-new">gtk_window_new</a> (<a href="gtk-Standard-Enumerations.html#GTK-WINDOW-TOPLEVEL:CAPS">GTK_WINDOW_TOPLEVEL</a>);

882

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect">g_signal_connect</a> (win, "delete-event",

883

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="gtk-General.html#gtk-true">gtk_true</a>), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

883

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="gtk-General.html#gtk-true">gtk_true</a>), <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a>);

884

885

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="gtk-General.html#gtk-main-quit">gtk_main_quit</a>), <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS">NULL</a>);

885

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="gtk-General.html#gtk-main-quit">gtk_main_quit</a>), <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS">NULL</a>);

886

but = <a href="GtkButton.html#gtk-button-new-with-label">gtk_button_new_with_label</a> ("Close yourself. I mean it!");

887

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#g-signal-connect-swapped">g_signal_connect_swapped</a> (but, "clicked",

888

<a href="http://library.gnome.org/devel/gobject/unstable/gobject-Closures.html#G-CALLBACK:CAPS">G_CALLBACK</a> (<a href="GtkObject.html#gtk-object-destroy">gtk_object_destroy</a>), win);

904

</colgroup>

905

906

<td>Returns :</td>

907

907

908

</tr></tbody>

909

</table></div>

910

</div>

911

<hr>

912

913

<a name="gtk-false"></a><h3>gtk_false ()</h3>

914

<pre class="programlisting">gboolean gtk_false (<code>void</code>);</pre>

915

916

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

917

but always returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

917

but always returns <code class="literal">FALSE</code>.

918

919

920

923

</colgroup>

924

925

<td>Returns :</td>

926

<td><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></td>

926

<td><code class="literal">FALSE</code></td>

927

</tr></tbody>

928

</table></div>

929

</div>

969

970

<td>Returns :</td>

971

<td>The widget which currently

972

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. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

972

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. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

973

</td>

974

</tr></tbody>

975

</table></div>

1000

1001

1002

<pre class="programlisting">void gtk_init_add (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1003

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1003

<code>gpointer data</code>);</pre>

1004

1005

<h3 class="title">Warning</h3>

1006

<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

1028

<hr>

1029

1030

<a name="gtk-quit-add-destroy"></a><h3>gtk_quit_add_destroy ()</h3>

1031

<pre class="programlisting">void gtk_quit_add_destroy (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

1031

<pre class="programlisting">void gtk_quit_add_destroy (<code>guint main_level</code>,

1032

<code><a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a> *object</code>);</pre>

1033

1034

<h3 class="title">Warning</h3>

1058

<hr>

1059

1060

1061

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_quit_add (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

1061

<pre class="programlisting">guint gtk_quit_add (<code>guint main_level</code>,

1062

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1063

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1063

<code>gpointer data</code>);</pre>

1064

1065

<h3 class="title">Warning</h3>

1066

<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

1092

<tr>

1093

<td>Returns :</td>

1094

<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>)

1095

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 <code>function</code>.</td>

1095

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 <code>function</code>.</td>

1096

</tr>

1097

</tbody>

1098

</table></div>

1100

<hr>

1101

1102

1103

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_quit_add_full (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> main_level</code>,

1103

<pre class="programlisting">guint gtk_quit_add_full (<code>guint main_level</code>,

1104

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1105

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

1106

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1107

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

1106

<code>gpointer data</code>,

1107

<code>GDestroyNotify destroy</code>);</pre>

1108

1109

<h3 class="title">Warning</h3>

1110

<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

1139

</tr>

1140

<tr>

1141

<td><code>marshal</code> :</td>

1142

<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>, <code>function</code> is

1142

<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>, <code>function</code> is

1143

ignored.</td>

1144

</tr>

1145

<tr>

1153

<tr>

1154

<td>Returns :</td>

1155

<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>)

1156

1157

</tr>

1158

</tbody>

1159

</table></div>

1161

<hr>

1162

1163

<a name="gtk-quit-remove"></a><h3>gtk_quit_remove ()</h3>

1164

<pre class="programlisting">void gtk_quit_remove (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> quit_handler_id</code>);</pre>

1164

<pre class="programlisting">void gtk_quit_remove (<code>guint quit_handler_id</code>);</pre>

1165

1166

<h3 class="title">Warning</h3>

1167

<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

1183

<hr>

1184

1185

<a name="gtk-quit-remove-by-data"></a><h3>gtk_quit_remove_by_data ()</h3>

1186

<pre class="programlisting">void gtk_quit_remove_by_data (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1186

<pre class="programlisting">void gtk_quit_remove_by_data (<code>gpointer data</code>);</pre>

1187

1188

<h3 class="title">Warning</h3>

1189

<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

1205

<hr>

1206

1207

<a name="gtk-timeout-add-full"></a><h3>gtk_timeout_add_full ()</h3>

1208

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_timeout_add_full (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> interval</code>,

1208

<pre class="programlisting">guint gtk_timeout_add_full (<code>guint32 interval</code>,

1209

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1210

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

1211

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1212

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

1211

<code>gpointer data</code>,

1212

<code>GDestroyNotify destroy</code>);</pre>

1213

1214

<h3 class="title">Warning</h3>

1215

<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.

1215

<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.

1216

</div>

1217

1218

Registers a function to be called periodically. The function will be called

1219

repeatedly after <code>interval</code> 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

1219

repeatedly after <code>interval</code> milliseconds until it returns <code class="literal">FALSE</code> at which

1220

point the timeout is destroyed and will not be called again.

1221

1222

1236

</tr>

1237

<tr>

1238

<td><code>marshal</code> :</td>

1239

<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>

1239

<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>

1240

</tr>

1241

<tr>

1242

1244

</tr>

1245

<tr>

1246

<td><code>destroy</code> :</td>

1247

<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>

1247

<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>

1248

</tr>

1249

<tr>

1250

<td>Returns :</td>

1256

<hr>

1257

1258

<a name="gtk-timeout-add"></a><h3>gtk_timeout_add ()</h3>

1259

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_timeout_add (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> interval</code>,

1259

<pre class="programlisting">guint gtk_timeout_add (<code>guint32 interval</code>,

1260

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1261

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1261

<code>gpointer data</code>);</pre>

1262

1263

<h3 class="title">Warning</h3>

1264

<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.

1264

<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.

1265

</div>

1266

1267

Registers a function to be called periodically. The function will be called

1268

repeatedly after <code>interval</code> milliseconds until it returns <code class="literal">FALSE</code> at which

1269

point the timeout is destroyed and will not be called again.

1270

1271

1297

<hr>

1298

1299

<a name="gtk-timeout-remove"></a><h3>gtk_timeout_remove ()</h3>

1300

<pre class="programlisting">void gtk_timeout_remove (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> timeout_handler_id</code>);</pre>

1300

<pre class="programlisting">void gtk_timeout_remove (<code>guint timeout_handler_id</code>);</pre>

1301

1302

<h3 class="title">Warning</h3>

1303

<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.

1303

<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.

1304

</div>

1305

1306

Removes the given timeout destroying all information about it.

1319

<hr>

1320

1321

1322

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_idle_add (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1323

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1322

<pre class="programlisting">guint gtk_idle_add (<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1323

<code>gpointer data</code>);</pre>

1324

1325

<h3 class="title">Warning</h3>

1326

<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.

1326

<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.

1327

</div>

1328

1329

Causes the mainloop to call the given function whenever no events with

1354

<hr>

1355

1356

<a name="gtk-idle-add-priority"></a><h3>gtk_idle_add_priority ()</h3>

1357

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_idle_add_priority (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> priority</code>,

1357

<pre class="programlisting">guint gtk_idle_add_priority (<code>gint priority</code>,

1358

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1359

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1359

<code>gpointer data</code>);</pre>

1360

1361

<h3 class="title">Warning</h3>

1362

<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.

1362

<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.

1363

</div>

1364

1365

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

1374

<tbody>

1375

<tr>

1376

<td><code>priority</code> :</td>

1377

<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>.

1377

<td>The priority which should not be above <code class="literal">G_PRIORITY_HIGH_IDLE</code>.

1378

Note that you will interfere with GTK+ if you use a priority above

1379

<a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE"><code class="literal">GTK_PRIORITY_RESIZE</code></a>.</td>

1380

</tr>

1396

<hr>

1397

1398

1399

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_idle_add_full (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> priority</code>,

1399

<pre class="programlisting">guint gtk_idle_add_full (<code>gint priority</code>,

1400

<code><a class="link" href="gtk-Types.html#GtkFunction" title="GtkFunction ()">GtkFunction</a> function</code>,

1401

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

1402

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1403

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

1402

<code>gpointer data</code>,

1403

<code>GDestroyNotify destroy</code>);</pre>

1404

1405

<h3 class="title">Warning</h3>

1406

<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.

1406

<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.

1407

</div>

1408

1409

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

1418

<tbody>

1419

<tr>

1420

<td><code>priority</code> :</td>

1421

<td>The priority which should not be above <code class="literal">G_PRIORITY_HIGH_IDLE</code>.

1422

Note that you will interfere with GTK+ if you use a priority above

1423

<a class="link" href="gtk-General.html#GTK-PRIORITY-RESIZE:CAPS" title="GTK_PRIORITY_RESIZE"><code class="literal">GTK_PRIORITY_RESIZE</code></a>.</td>

1424

</tr>

1428

</tr>

1429

<tr>

1430

<td><code>marshal</code> :</td>

1431

<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>

1431

<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>

1432

</tr>

1433

<tr>

1434

1436

</tr>

1437

<tr>

1438

<td><code>destroy</code> :</td>

1439

<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>

1439

<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>

1440

</tr>

1441

<tr>

1442

<td>Returns :</td>

1448

<hr>

1449

1450

<a name="gtk-idle-remove"></a><h3>gtk_idle_remove ()</h3>

1451

<pre class="programlisting">void gtk_idle_remove (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> idle_handler_id</code>);</pre>

1451

<pre class="programlisting">void gtk_idle_remove (<code>guint idle_handler_id</code>);</pre>

1452

1453

<h3 class="title">Warning</h3>

1454

<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.

1454

<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.

1455

</div>

1456

1457

Removes the idle function with the given id.

1470

<hr>

1471

1472

<a name="gtk-idle-remove-by-data"></a><h3>gtk_idle_remove_by_data ()</h3>

1473

<pre class="programlisting">void gtk_idle_remove_by_data (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>);</pre>

1473

<pre class="programlisting">void gtk_idle_remove_by_data (<code>gpointer data</code>);</pre>

1474

1475

<h3 class="title">Warning</h3>

1476

<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.

1476

<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.

1477

</div>

1478

1479

Removes the idle function identified by the user data.

1492

<hr>

1493

1494

<a name="gtk-input-add-full"></a><h3>gtk_input_add_full ()</h3>

1495

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_input_add_full (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> source</code>,

1496

<code><a href="../gdk/gdk-Input.html#GdkInputCondition">GdkInputCondition</a> condition</code>,

1497

<code><a href="../gdk/gdk-Input.html#GdkInputFunction">GdkInputFunction</a> function</code>,

1495

<pre class="programlisting">guint gtk_input_add_full (<code>gint source</code>,

1496

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputCondition">GdkInputCondition</a> condition</code>,

1497

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Input.html#GdkInputFunction">GdkInputFunction</a> function</code>,

1498

<code><a class="link" href="gtk-Types.html#GtkCallbackMarshal" title="GtkCallbackMarshal ()">GtkCallbackMarshal</a> marshal</code>,

1499

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> data</code>,

1500

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> destroy</code>);</pre>

1499

<code>gpointer data</code>,

1500

<code>GDestroyNotify destroy</code>);</pre>

1501

1502

<h3 class="title">Warning</h3>

1503

<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.

1503

<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.

1504

</div>

1505

1506

Registers a function to be called when a condition becomes true

1526

</tr>

1527

<tr>

1528

<td><code>marshal</code> :</td>

1529

<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>

1529

<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>

1530

</tr>

1531

<tr>

1532

1535

<tr>

1536

<td><code>destroy</code> :</td>

1537

<td>callback function to call with <code>data</code> when the input

1538

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>

1538

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>

1539

</tr>

1540

<tr>

1541

<td>Returns :</td>

1547

<hr>

1548

1549

<a name="gtk-input-remove"></a><h3>gtk_input_remove ()</h3>

1550

<pre class="programlisting">void gtk_input_remove (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> input_handler_id</code>);</pre>

1550

<pre class="programlisting">void gtk_input_remove (<code>guint input_handler_id</code>);</pre>

1551

1552

<h3 class="title">Warning</h3>

1553

<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.

1553

<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.

1554

</div>

1555

1556

Removes the function with the given id.

1573

</pre>

1574

1575

<h3 class="title">Warning</h3>

1576

<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.

1576

<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.

1577

</div>

1578

1579

Use this priority for redrawing related stuff. It is used internally by

1600

</pre>

1601

1602

<h3 class="title">Warning</h3>

1603

<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.

1603

1604

</div>

1605

1606

Use this for high priority timeouts. This priority is never used inside

1628

</pre>

1629

1630

<h3 class="title">Warning</h3>

1631

<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.

1631

1632

</div>

1633

1634

Default priority for idle functions.

1641

</pre>

1642

1643

<h3 class="title">Warning</h3>

1644

<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.

1644

1645

</div>

1646

1647

Priority for very unimportant background tasks.

1650

<hr>

1651

1652

<a name="gtk-key-snooper-install"></a><h3>gtk_key_snooper_install ()</h3>

1653

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> gtk_key_snooper_install (<code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">GtkKeySnoopFunc</a> snooper</code>,

1654

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> func_data</code>);</pre>

1653

<pre class="programlisting">guint gtk_key_snooper_install (<code><a class="link" href="gtk-General.html#GtkKeySnoopFunc" title="GtkKeySnoopFunc ()">GtkKeySnoopFunc</a> snooper</code>,

1654

<code>gpointer func_data</code>);</pre>

1655

1656

Installs a key snooper function, which will get called on all key events

1657

before delivering them normally.

1680

<hr>

1681

1682

<a name="GtkKeySnoopFunc"></a><h3>GtkKeySnoopFunc ()</h3>

1683

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint">gint</a> (*GtkKeySnoopFunc) (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *grab_widget</code>,

1684

<code><a href="../gdk/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>,

1685

<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> func_data</code>);</pre>

1683

<pre class="programlisting">gint (*GtkKeySnoopFunc) (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *grab_widget</code>,

1684

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventKey">GdkEventKey</a> *event</code>,

1685

<code>gpointer func_data</code>);</pre>

1686

1687

Key snooper functions are called before normal event delivery.

1688

They can be used to implement custom key event handling.

1708

<tr>

1709

<td>Returns :</td>

1710

<td>

1711

<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 <code>event</code>, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> to continue.</td>

1711

<code class="literal">TRUE</code> to stop further processing of <code>event</code>, <code class="literal">FALSE</code> to continue.</td>

1712

</tr>

1713

</tbody>

1714

</table></div>

1716

<hr>

1717

1718

<a name="gtk-key-snooper-remove"></a><h3>gtk_key_snooper_remove ()</h3>

1719

<pre class="programlisting">void gtk_key_snooper_remove (<code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint">guint</a> snooper_handler_id</code>);</pre>

1719

<pre class="programlisting">void gtk_key_snooper_remove (<code>guint snooper_handler_id</code>);</pre>

1720

1721

Removes the key snooper function with the given id.

1722

1734

<hr>

1735

1736

<a name="gtk-get-current-event"></a><h3>gtk_get_current_event ()</h3>

1737

<pre class="programlisting"><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> * gtk_get_current_event (<code>void</code>);</pre>

1737

<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> * gtk_get_current_event (<code>void</code>);</pre>

1738

1739

Obtains a copy of the event currently being processed by GTK+. For

1740

example, if you get a "clicked" signal from <a class="link" href="GtkButton.html" title="GtkButton">GtkButton</a>, the current

1741

event will be the <a href="../gdk/gdk-Event-Structures.html#GdkEventButton">GdkEventButton</a> that triggered the "clicked"

1742

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>.

1743

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>.

1741

event will be the <a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEventButton">GdkEventButton</a> that triggered the "clicked"

1742

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>.

1743

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>.

1744

1745

1746

1749

</colgroup>

1750

1751

<td>Returns :</td>

1752

<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

1752

<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

1753

current event. [<acronym title="Free data after the code is done.">transfer full</acronym>]

1754

</td>

1755

</tr></tbody>

1758

<hr>

1759

1760

<a name="gtk-get-current-event-time"></a><h3>gtk_get_current_event_time ()</h3>

1761

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint32">guint32</a> gtk_get_current_event_time (<code>void</code>);</pre>

1761

<pre class="programlisting">guint32 gtk_get_current_event_time (<code>void</code>);</pre>

1762

1763

If there is a current event and it has a timestamp, return that

1764

timestamp, otherwise return <a href="../gdk/gdk-Events.html#GDK-CURRENT-TIME:CAPS"><code class="literal">GDK_CURRENT_TIME</code></a>.

1764

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>.

1765

1766

1767

1770

</colgroup>

1771

1772

<td>Returns :</td>

1773

<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>

1773

<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>

1774

</tr></tbody>

1775

</table></div>

1776

</div>

1777

<hr>

1778

1779

<a name="gtk-get-current-event-state"></a><h3>gtk_get_current_event_state ()</h3>

1780

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> gtk_get_current_event_state (<code><a href="../gdk/gdk-Windows.html#GdkModifierType">GdkModifierType</a> *state</code>);</pre>

1780

<pre class="programlisting">gboolean gtk_get_current_event_state (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkModifierType">GdkModifierType</a> *state</code>);</pre>

1781

1782

If there is a current event and it has a state field, place

1783

that state field in <code>state</code> 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

1784

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.

1783

that state field in <code>state</code> and return <code class="literal">TRUE</code>, otherwise return

1784

<code class="literal">FALSE</code>.

1785

1786

1787

1797

<tr>

1798

<td>Returns :</td>

1799

<td>

1800

<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>

1800

<code class="literal">TRUE</code> if there was a current event and it had a state field</td>

1801

</tr>

1802

</tbody>

1803

</table></div>

1805

<hr>

1806

1807

<a name="gtk-get-event-widget"></a><h3>gtk_get_event_widget ()</h3>

1808

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_get_event_widget (<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

1808

<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * gtk_get_event_widget (<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

1809

1810

If <code>event</code> 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,

1811

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

1810

If <code>event</code> 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,

1811

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

1812

originally.

1813

1814

1819

<tbody>

1820

<tr>

1821

<td><code>event</code> :</td>

1822

<td>a <a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a>

1822

<td>a <a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a>

1823

</td>

1824

</tr>

1825

<tr>

1826

<td>Returns :</td>

1827

<td>the widget that originally

1828

received <code>event</code>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1828

received <code>event</code>, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

1829

</td>

1830

</tr>

1831

</tbody>

1835

1836

<a name="gtk-propagate-event"></a><h3>gtk_propagate_event ()</h3>

1837

<pre class="programlisting">void gtk_propagate_event (<code><a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> *widget</code>,

1838

<code><a href="../gdk/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

1838

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkEvent">GdkEvent</a> *event</code>);</pre>

1839

1840

Sends an event to a widget, propagating the event to parent widgets

1841

if the event remains unhandled. Events received by GTK+ from GDK

1852

All that said, you most likely don't want to use any of these

1853

functions; synthesizing events is rarely needed. Consider asking on

1854

the mailing list for better ways to achieve your goals. For

1855

example, use <a href="../gdk/gdk-Windows.html#gdk-window-invalidate-rect"><code class="function">gdk_window_invalidate_rect()</code></a> or

1855

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

1856

<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.

1857

1858

1877

1878

1879

1880

See the GLib manual, especially <a href="http://library.gnome.org/devel/glib/unstable/glib-The-Main-Event-Loop.html#GMainLoop">GMainLoop</a> and signal-related

1880

See the GLib manual, especially GMainLoop and signal-related

1881

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>.

1882

1883

</div>

1884

</div>

1885

1886

<hr>

1887

Generated by GTK-Doc V1.18</div>

1887

Generated by GTK-Doc V1.18.1</div>

1888

</body>

1889

</html>

b'\\ No newline at end of file'

Older »