1
<refentry id="libglade-Libglade-Initialisation">
3
<refentrytitle>Libglade Initialisation</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>LIBGLADE Library</refmiscinfo>
9
<refname>Libglade Initialisation</refname><refpurpose></refpurpose>
12
<refsynopsisdiv><title>Synopsis</title>
15
#include <glade/glade-init.h>
18
void <link linkend="glade-init">glade_init</link> (void);
19
void <link linkend="glade-require">glade_require</link> (const <link linkend="gchar">gchar</link> *library);
20
void <link linkend="glade-provide">glade_provide</link> (const <link linkend="gchar">gchar</link> *library);
30
<title>Description</title>
37
<title>Details</title>
39
<title><anchor id="glade-init">glade_init ()</title>
40
<programlisting>void glade_init (void);</programlisting>
42
It used to be necessary to call <link linkend="glade-init">glade_init</link>() before creating
43
GladeXML objects. This is now no longer the case, as libglade will
44
be initialised on demand now. Calling <link linkend="glade-init">glade_init</link>() manually will
45
not cause any problems though.</para>
50
<title><anchor id="glade-require">glade_require ()</title>
51
<programlisting>void glade_require (const <link linkend="gchar">gchar</link> *library);</programlisting>
53
Ensure that a required library is available. If it is not already
54
available, libglade will attempt to dynamically load a module that
55
contains the handlers for that library.</para>
58
</para><informaltable pgwide="1" frame="none" role="params">
60
<colspec colwidth="2*">
61
<colspec colwidth="8*">
63
<row><entry align="right"><parameter>library</parameter> :</entry>
64
<entry> the required library
66
</tbody></tgroup></informaltable></refsect2>
68
<title><anchor id="glade-provide">glade_provide ()</title>
69
<programlisting>void glade_provide (const <link linkend="gchar">gchar</link> *library);</programlisting>
71
This function should be called by a module to assert that it
72
provides wrappers for a particular library. This should be called
73
by the <link linkend="register-widgets">register_widgets</link>() function of a libglade module so that it
74
isn't loaded twice, for instance.</para>
77
</para><informaltable pgwide="1" frame="none" role="params">
79
<colspec colwidth="2*">
80
<colspec colwidth="8*">
82
<row><entry align="right"><parameter>library</parameter> :</entry>
83
<entry> the provided library
85
</tbody></tgroup></informaltable></refsect2>