Blob Blame History Raw
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Glade Utils: Glade User Interface Designer Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="index.html" title="Glade User Interface Designer Reference Manual">
<link rel="up" href="misc.html" title="Part IV. Miscellaneous utilities">
<link rel="prev" href="gladeui-glade-parameter.html" title="glade-parameter">
<link rel="next" href="ix01.html" title="Index">
<meta name="generator" content="GTK-Doc V1.28 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#gladeui-Glade-Utils.description" class="shortcut">Description</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="misc.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="gladeui-glade-parameter.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="ix01.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="gladeui-Glade-Utils"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="gladeui-Glade-Utils.top_of_page"></a>Glade Utils</span></h2>
<p>Glade Utils — Welcome to the zoo.</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="gladeui-Glade-Utils.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-get-type-from-name" title="glade_util_get_type_from_name ()">glade_util_get_type_from_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-utils-get-pspec-from-funcname" title="glade_utils_get_pspec_from_funcname ()">glade_utils_get_pspec_from_funcname</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-ui-message" title="glade_util_ui_message ()">glade_util_ui_message</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-flash-message" title="glade_util_flash_message ()">glade_util_flash_message</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-compare-stock-labels" title="glade_util_compare_stock_labels ()">glade_util_compare_stock_labels</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-file-dialog-new" title="glade_util_file_dialog_new ()">glade_util_file_dialog_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-replace" title="glade_util_replace ()">glade_util_replace</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-read-prop-name" title="glade_util_read_prop_name ()">glade_util_read_prop_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-duplicate-underscores" title="glade_util_duplicate_underscores ()">glade_util_duplicate_underscores</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-container-get-all-children" title="glade_util_container_get_all_children ()">glade_util_container_get_all_children</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-count-placeholders" title="glade_util_count_placeholders ()">glade_util_count_placeholders</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeIter-struct"><span class="returnvalue">GtkTreeIter</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-find-iter-by-widget" title="glade_util_find_iter_by_widget ()">glade_util_find_iter_by_widget</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-purify-list" title="glade_util_purify_list ()">glade_util_purify_list</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-added-in-list" title="glade_util_added_in_list ()">glade_util_added_in_list</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-removed-from-list" title="glade_util_removed_from_list ()">glade_util_removed_from_list</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-canonical-path" title="glade_util_canonical_path ()">glade_util_canonical_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="returnvalue">GModule</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-load-library" title="glade_util_load_library ()">glade_util_load_library</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-file-is-writeable" title="glade_util_file_is_writeable ()">glade_util_file_is_writeable</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-have-devhelp" title="glade_util_have_devhelp ()">glade_util_have_devhelp</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-get-devhelp-icon" title="glade_util_get_devhelp_icon ()">glade_util_get_devhelp_icon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-search-devhelp" title="glade_util_search_devhelp ()">glade_util_search_devhelp</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-get-placeholder-from-pointer" title="glade_util_get_placeholder_from_pointer ()">glade_util_get_placeholder_from_pointer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-object-is-loading" title="glade_util_object_is_loading ()">glade_util_object_is_loading</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-url-show" title="glade_util_url_show ()">glade_util_url_show</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">time_t</span>
</td>
<td class="function_name">
<a class="link" href="gladeui-Glade-Utils.html#glade-util-get-file-mtime" title="glade_util_get_file_mtime ()">glade_util_get_file_mtime</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gladeui-Glade-Utils.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="gladeui-Glade-Utils.html#GladeUtilFileDialogType" title="enum GladeUtilFileDialogType">GladeUtilFileDialogType</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="gladeui-Glade-Utils.html#GladeUIMessageType" title="enum GladeUIMessageType">GladeUIMessageType</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="gladeui-Glade-Utils.description"></a><h2>Description</h2>
<p>This is where all of that really usefull miscalanious stuff lands up.</p>
</div>
<div class="refsect1">
<a name="gladeui-Glade-Utils.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="glade-util-get-type-from-name"></a><h3>glade_util_get_type_from_name ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
glade_util_get_type_from_name (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
                               <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> have_func</code></em>);</pre>
<p>Returns the type using the "get type" function name based on <em class="parameter"><code>name</code></em>
.  
If the <em class="parameter"><code>have_func</code></em>
 flag is true,<em class="parameter"><code>name</code></em>
 is used directly, otherwise the get-type 
function is contrived from <em class="parameter"><code>name</code></em>
 then used.</p>
<div class="refsect3">
<a name="glade-util-get-type-from-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the name of the <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a> - like 'GtkWidget' or a "get-type" function.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>have_func</p></td>
<td class="parameter_description"><p>function-name flag -- true if the name is a "get-type" function.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-get-type-from-name.returns"></a><h4>Returns</h4>
<p> the new <a href="/usr/share/gtk-doc/html/gobject/gobject-Type-Information.html#GType"><span class="type">GType</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-utils-get-pspec-from-funcname"></a><h3>glade_utils_get_pspec_from_funcname ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="returnvalue">GParamSpec</span></a> *
glade_utils_get_pspec_from_funcname (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *funcname</code></em>);</pre>
<div class="refsect3">
<a name="glade-utils-get-pspec-from-funcname.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>funcname</p></td>
<td class="parameter_description"><p>the symbol name of a function to generate a <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-utils-get-pspec-from-funcname.returns"></a><h4>Returns</h4>
<p> A <a href="/usr/share/gtk-doc/html/gobject/gobject-GParamSpec.html#GParamSpec"><span class="type">GParamSpec</span></a> created by the delagate function
specified by <em class="parameter"><code>funcname</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-ui-message"></a><h3>glade_util_ui_message ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
glade_util_ui_message (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *parent</code></em>,
                       <em class="parameter"><code><a class="link" href="gladeui-Glade-Utils.html#GladeUIMessageType" title="enum GladeUIMessageType"><span class="type">GladeUIMessageType</span></a> type</code></em>,
                       <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *widget</code></em>,
                       <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
                       <em class="parameter"><code>...</code></em>);</pre>
<p>Creates a new warning dialog window as a child of <em class="parameter"><code>parent</code></em>
 containing
the text of <em class="parameter"><code>format</code></em>
, runs it, then destroys it on close. Depending
on <em class="parameter"><code>type</code></em>
, a cancel button may apear or the icon may change.</p>
<div class="refsect3">
<a name="glade-util-ui-message.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> cast as a <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>a <a class="link" href="gladeui-Glade-Utils.html#GladeUIMessageType" title="enum GladeUIMessageType"><span class="type">GladeUIMessageType</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>widget</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> to append to the dialog vbox</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>format</p></td>
<td class="parameter_description"><p>a printf style format string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>args for the format.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-ui-message.returns"></a><h4>Returns</h4>
<p> True if the <em class="parameter"><code>type</code></em>
was GLADE_UI_ARE_YOU_SURE and the user
selected "OK", True if the <em class="parameter"><code>type</code></em>
was GLADE_UI_YES_OR_NO and
the user selected "YES"; False otherwise.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-flash-message"></a><h3>glade_util_flash_message ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
glade_util_flash_message (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="type">GtkWidget</span></a> *statusbar</code></em>,
                          <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#guint"><span class="type">guint</span></a> context_id</code></em>,
                          <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *format</code></em>,
                          <em class="parameter"><code>...</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-compare-stock-labels"></a><h3>glade_util_compare_stock_labels ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
glade_util_compare_stock_labels (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> a</code></em>,
                                 <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> b</code></em>);</pre>
<p>This is a <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GCompareFunc"><span class="type">GCompareFunc</span></a> that compares the labels of two stock items, 
ignoring any '_' characters. It isn't particularly efficient.</p>
<div class="refsect3">
<a name="glade-util-compare-stock-labels.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>a</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> to a <a href="/usr/share/gtk-doc/html/gtk3/gtk3-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>b</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gconstpointer"><span class="type">gconstpointer</span></a> to a <a href="/usr/share/gtk-doc/html/gtk3/gtk3-Stock-Items.html#GtkStockItem"><span class="type">GtkStockItem</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-compare-stock-labels.returns"></a><h4>Returns</h4>
<p> negative value if <em class="parameter"><code>a</code></em>
&lt; <em class="parameter"><code>b</code></em>
; zero if <em class="parameter"><code>a</code></em>
= <em class="parameter"><code>b</code></em>
;
positive value if <em class="parameter"><code>a</code></em>
&gt; <em class="parameter"><code>b</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-file-dialog-new"></a><h3>glade_util_file_dialog_new ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
glade_util_file_dialog_new (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *title</code></em>,
                            <em class="parameter"><code><a class="link" href="GladeProject.html" title="GladeProject"><span class="type">GladeProject</span></a> *project</code></em>,
                            <em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> *parent</code></em>,
                            <em class="parameter"><code><a class="link" href="gladeui-Glade-Utils.html#GladeUtilFileDialogType" title="enum GladeUtilFileDialogType"><span class="type">GladeUtilFileDialogType</span></a> action</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-file-dialog-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>title</p></td>
<td class="parameter_description"><p>dialog title</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>project</p></td>
<td class="parameter_description"><p>a <a class="link" href="GladeProject.html" title="GladeProject"><span class="type">GladeProject</span></a> used when saving</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>a parent <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html#GtkWindow-struct"><span class="type">GtkWindow</span></a> for the dialog</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="gladeui-Glade-Utils.html#GladeUtilFileDialogType" title="enum GladeUtilFileDialogType"><span class="type">GladeUtilFileDialogType</span></a> to say if the dialog will open or save</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-file-dialog-new.returns"></a><h4>Returns</h4>
<p> a "glade file" file chooser dialog. The caller is responsible
for showing the dialog</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-replace"></a><h3>glade_util_replace ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
glade_util_replace (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>,
                    <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> a</code></em>,
                    <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> b</code></em>);</pre>
<p>Replaces each occurance of the character <em class="parameter"><code>a</code></em>
 in <em class="parameter"><code>str</code></em>
 to <em class="parameter"><code>b</code></em>
.</p>
<div class="refsect3">
<a name="glade-util-replace.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>str</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>a</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>b</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-read-prop-name"></a><h3>glade_util_read_prop_name ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
glade_util_read_prop_name (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
<p>Return a usable version of a property identifier as found
in a freshly parserd <span class="type">GladeInterface</span></p>
<div class="refsect3">
<a name="glade-util-read-prop-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>str</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-duplicate-underscores"></a><h3>glade_util_duplicate_underscores ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
glade_util_duplicate_underscores (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>);</pre>
<p>Duplicates <em class="parameter"><code>name</code></em>
, but the copy has two underscores in place of any single
underscore in the original.</p>
<div class="refsect3">
<a name="glade-util-duplicate-underscores.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>a string</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-duplicate-underscores.returns"></a><h4>Returns</h4>
<p> a newly allocated string</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-container-get-all-children"></a><h3>glade_util_container_get_all_children ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
glade_util_container_get_all_children (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkContainer.html#GtkContainer-struct"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
<p>Use this to itterate over all children in a GtkContainer,
as it used <code class="function">_forall()</code> instead of <code class="function">_foreach()</code> (and the GTK+ version
of this function is simply not exposed).</p>
<p>Note that <code class="function">glade_widget_class_get_children()</code> is the high-level
abstraction and will usually end up calling this function.</p>
<div class="refsect3">
<a name="glade-util-container-get-all-children.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>container</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gtk3/GtkContainer.html#GtkContainer-struct"><span class="type">GtkContainer</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-container-get-all-children.returns"></a><h4>Returns</h4>
<p> a <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> giving the contents of <em class="parameter"><code>container</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-count-placeholders"></a><h3>glade_util_count_placeholders ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
glade_util_count_placeholders (<em class="parameter"><code><a class="link" href="GladeWidget.html" title="GladeWidget"><span class="type">GladeWidget</span></a> *parent</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-count-placeholders.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>parent</p></td>
<td class="parameter_description"><p>a <a class="link" href="GladeWidget.html" title="GladeWidget"><span class="type">GladeWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-count-placeholders.returns"></a><h4>Returns</h4>
<p> the amount of <a href="GladePlaceholder.html#GladePlaceholder-struct"><span class="type">GladePlaceholders</span></a> parented by <em class="parameter"><code>parent</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-find-iter-by-widget"></a><h3>glade_util_find_iter_by_widget ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeIter-struct"><span class="returnvalue">GtkTreeIter</span></a> *
glade_util_find_iter_by_widget (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeModel-struct"><span class="type">GtkTreeModel</span></a> *model</code></em>,
                                <em class="parameter"><code><a class="link" href="GladeWidget.html" title="GladeWidget"><span class="type">GladeWidget</span></a> *findme</code></em>,
                                <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a> column</code></em>);</pre>
<p>Looks through <em class="parameter"><code>model</code></em>
 for the <a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeIter-struct"><span class="type">GtkTreeIter</span></a> corresponding to 
<em class="parameter"><code>findme</code></em>
 under <em class="parameter"><code>column</code></em>
.</p>
<div class="refsect3">
<a name="glade-util-find-iter-by-widget.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>model</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeModel-struct"><span class="type">GtkTreeModel</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>findme</p></td>
<td class="parameter_description"><p>a <a class="link" href="GladeWidget.html" title="GladeWidget"><span class="type">GladeWidget</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>column</p></td>
<td class="parameter_description"><p>a <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-find-iter-by-widget.returns"></a><h4>Returns</h4>
<p> a newly allocated <a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#GtkTreeIter-struct"><span class="type">GtkTreeIter</span></a> from <em class="parameter"><code>model</code></em>
corresponding
to <em class="parameter"><code>findme</code></em>
which should be freed with <a href="/usr/share/gtk-doc/html/gtk3/GtkTreeModel.html#gtk-tree-iter-free"><code class="function">gtk_tree_iter_free()</code></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-purify-list"></a><h3>glade_util_purify_list ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
glade_util_purify_list (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *list</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-purify-list.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>A <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-purify-list.returns"></a><h4>Returns</h4>
<p> A newly allocated version of <em class="parameter"><code>list</code></em>
with no
duplicate data entries</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-added-in-list"></a><h3>glade_util_added_in_list ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
glade_util_added_in_list (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *old_list</code></em>,
                          <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *new_list</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-added-in-list.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>old_list</p></td>
<td class="parameter_description"><p>the old <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>new_list</p></td>
<td class="parameter_description"><p>the new <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-added-in-list.returns"></a><h4>Returns</h4>
<p> A newly allocated <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of elements that
are in <em class="parameter"><code>new</code></em>
but not in <em class="parameter"><code>old</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-removed-from-list"></a><h3>glade_util_removed_from_list ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="returnvalue">GList</span></a> *
glade_util_removed_from_list (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *old_list</code></em>,
                              <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *new_list</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-removed-from-list.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>old_list</p></td>
<td class="parameter_description"><p>the old <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>new_list</p></td>
<td class="parameter_description"><p>the new <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-removed-from-list.returns"></a><h4>Returns</h4>
<p> A newly allocated <a href="/usr/share/gtk-doc/html/glib/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of elements that
are in <em class="parameter"><code>old</code></em>
no longer in <em class="parameter"><code>new</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-canonical-path"></a><h3>glade_util_canonical_path ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
glade_util_canonical_path (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-canonical-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>any path that may contain ".." or "." components</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-canonical-path.returns"></a><h4>Returns</h4>
<p> an absolute path to the specified file or directory
that contains no ".." or "." components (this does
not call readlink like <code class="function">realpath()</code> does).</p>
<p>Note: on some systems; I think its possible that we dont have
permission to execute in the directory in which the glade
file resides; I decided finally to do it this way anyway
since libc's <code class="function">realpath()</code> does exactly the same.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-load-library"></a><h3>glade_util_load_library ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="returnvalue">GModule</span></a> *
glade_util_load_library (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *library_name</code></em>);</pre>
<p>Loads the named library from the Glade modules and lib directory or failing that
from the standard platform specific directories. (Including /usr/local/lib for unices)</p>
<p>The <em class="parameter"><code>library_name</code></em>
 should not include any platform specifix prefix or suffix,
those are automatically added, if needed, by <a href="/usr/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#g-module-build-path"><code class="function">g_module_build_path()</code></a></p>
<div class="refsect3">
<a name="glade-util-load-library.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>library_name</p></td>
<td class="parameter_description"><p>name of the library</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-load-library.returns"></a><h4>Returns</h4>
<p> a <a href="/usr/share/gtk-doc/html/glib/glib-Dynamic-Loading-of-Modules.html#GModule"><span class="type">GModule</span></a> on success, or <a href="/usr/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on failure.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-file-is-writeable"></a><h3>glade_util_file_is_writeable ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
glade_util_file_is_writeable (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *path</code></em>);</pre>
<p>Checks whether the file at <em class="parameter"><code>path</code></em>
 is writeable</p>
<div class="refsect3">
<a name="glade-util-file-is-writeable.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>path</p></td>
<td class="parameter_description"><p>the path to the file</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-file-is-writeable.returns"></a><h4>Returns</h4>
<p> TRUE if file is writeable</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-have-devhelp"></a><h3>glade_util_have_devhelp ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
glade_util_have_devhelp (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<div class="refsect3">
<a name="glade-util-have-devhelp.returns"></a><h4>Returns</h4>
<p> whether the devhelp module is loaded</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-get-devhelp-icon"></a><h3>glade_util_get_devhelp_icon ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
glade_util_get_devhelp_icon (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/gtk3-Themeable-Stock-Images.html#GtkIconSize"><span class="type">GtkIconSize</span></a> size</code></em>);</pre>
<p>Creates an image displaying the devhelp icon.</p>
<div class="refsect3">
<a name="glade-util-get-devhelp-icon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>size</p></td>
<td class="parameter_description"><p>the preferred icon size</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-get-devhelp-icon.returns"></a><h4>Returns</h4>
<p> a <a href="/usr/share/gtk-doc/html/gtk3/GtkImage.html#GtkImage-struct"><span class="type">GtkImage</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-search-devhelp"></a><h3>glade_util_search_devhelp ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
glade_util_search_devhelp (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *book</code></em>,
                           <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *page</code></em>,
                           <em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *search</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-get-placeholder-from-pointer"></a><h3>glade_util_get_placeholder_from_pointer ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html#GtkWidget-struct"><span class="returnvalue">GtkWidget</span></a> *
glade_util_get_placeholder_from_pointer
                               (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkContainer.html#GtkContainer-struct"><span class="type">GtkContainer</span></a> *container</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-object-is-loading"></a><h3>glade_util_object_is_loading ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
glade_util_object_is_loading (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a> *object</code></em>);</pre>
<div class="refsect3">
<a name="glade-util-object-is-loading.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>object</p></td>
<td class="parameter_description"><p>A <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct"><span class="type">GObject</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-object-is-loading.returns"></a><h4>Returns</h4>
<p> Whether the object's project is being loaded or not.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-url-show"></a><h3>glade_util_url_show ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
glade_util_url_show (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *url</code></em>);</pre>
<p>Portable function for showing an URL <em class="parameter"><code>url</code></em>
 in a web browser.</p>
<div class="refsect3">
<a name="glade-util-url-show.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>url</p></td>
<td class="parameter_description"><p>An URL to display</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-url-show.returns"></a><h4>Returns</h4>
<p> TRUE if a web browser was successfully launched, or FALSE</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="glade-util-get-file-mtime"></a><h3>glade_util_get_file_mtime ()</h3>
<pre class="programlisting"><span class="returnvalue">time_t</span>
glade_util_get_file_mtime (<em class="parameter"><code>const <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *filename</code></em>,
                           <em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> **error</code></em>);</pre>
<p>Gets the UTC modification time of file <em class="parameter"><code>filename</code></em>
.</p>
<div class="refsect3">
<a name="glade-util-get-file-mtime.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>filename</p></td>
<td class="parameter_description"><p>A filename</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>error</p></td>
<td class="parameter_description"><p>return location for errors</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="glade-util-get-file-mtime.returns"></a><h4>Returns</h4>
<p> The mtime of the file, or <code class="literal">0</code> if the file attributes
could not be read.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="gladeui-Glade-Utils.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GladeUtilFileDialogType"></a><h3>enum GladeUtilFileDialogType</h3>
<div class="refsect3">
<a name="GladeUtilFileDialogType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GLADE-FILE-DIALOG-ACTION-OPEN:CAPS"></a>GLADE_FILE_DIALOG_ACTION_OPEN</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GLADE-FILE-DIALOG-ACTION-SAVE:CAPS"></a>GLADE_FILE_DIALOG_ACTION_SAVE</p></td>
<td> </td>
<td> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GladeUIMessageType"></a><h3>enum GladeUIMessageType</h3>
<div class="refsect3">
<a name="GladeUIMessageType.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GLADE-UI-INFO:CAPS"></a>GLADE_UI_INFO</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GLADE-UI-WARN:CAPS"></a>GLADE_UI_WARN</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GLADE-UI-ERROR:CAPS"></a>GLADE_UI_ERROR</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GLADE-UI-ARE-YOU-SURE:CAPS"></a>GLADE_UI_ARE_YOU_SURE</p></td>
<td> </td>
<td> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GLADE-UI-YES-OR-NO:CAPS"></a>GLADE_UI_YES_OR_NO</p></td>
<td> </td>
<td> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.28</div>
</body>
</html>