File: libglade-Libglade-Initialisation.html

package info (click to toggle)
libglade2 1%3A2.4.2-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 2,148 kB
  • ctags: 461
  • sloc: sh: 8,376; ansic: 4,260; xml: 1,764; makefile: 116
file content (35 lines) | stat: -rw-r--r-- 5,377 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Libglade Initialisation</title><meta name="generator" content="DocBook XSL Stylesheets V1.66.1"><link rel="start" href="index.html" title="Libglade Reference Manual"><link rel="up" href="libglade-lib.html" title="PartI.Libglade Library Reference"><link rel="prev" href="libglade-lib.html" title="PartI.Libglade Library Reference"><link rel="next" href="GladeXML.html" title="GladeXML"><meta name="generator" content="GTK-Doc V1.3 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="libglade-notes.html" title="Libglade Programming Notes"><link rel="chapter" href="libglade-dtd.html" title="Glade 2.0 File Format"><link rel="part" href="libglade-lib.html" title="PartI.Libglade Library Reference"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="libglade-lib.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="libglade-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Libglade Reference Manual</th><td><a accesskey="n" href="GladeXML.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr></table><div class="refentry" lang="en"><a name="libglade-Libglade-Initialisation"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle">Libglade Initialisation</span></h2><p>Libglade Initialisation &#8212; Routines used to initialise libglade.</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><h2>Synopsis</h2><pre class="synopsis">

#include &lt;glade/glade-init.h&gt;


void        <a href="libglade-Libglade-Initialisation.html#glade-init">glade_init</a>                      (void);
void        <a href="libglade-Libglade-Initialisation.html#glade-require">glade_require</a>                   (const gchar *library);
void        <a href="libglade-Libglade-Initialisation.html#glade-provide">glade_provide</a>                   (const gchar *library);

</pre></div><div class="refsect1" lang="en"><a name="id301641"></a><h2>Description</h2><p>
These routines are used to initialise libglade, and to load addon modules
that recognise extra widget sets.  The <tt class="filename">glade_init</tt>
routine must be called before any libglade routines are used, and the
<tt class="filename">glade_load_module</tt> routine would be used to load
extra modules.
</p></div><div class="refsect1" lang="en"><a name="id301658"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id301663"></a><h3><a name="glade-init"></a>glade_init ()</h3><a class="indexterm" name="id301672"></a><pre class="programlisting">void        glade_init                      (void);</pre><p>
It used to be necessary to call <a href="libglade-Libglade-Initialisation.html#glade-init"><tt class="function">glade_init()</tt></a> before creating
GladeXML objects.  This is now no longer the case, as libglade will
be initialised on demand now.  Calling <a href="libglade-Libglade-Initialisation.html#glade-init"><tt class="function">glade_init()</tt></a> manually will
not cause any problems though.</p><p>

</p></div><hr><div class="refsect2" lang="en"><a name="id301702"></a><h3><a name="glade-require"></a>glade_require ()</h3><a class="indexterm" name="id301711"></a><pre class="programlisting">void        glade_require                   (const gchar *library);</pre><p>
Ensure that a required library is available.  If it is not already
available, libglade will attempt to dynamically load a module that
contains the handlers for that library.</p><p>

</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>library</tt></i>:</span></td><td> the required library
</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id254734"></a><h3><a name="glade-provide"></a>glade_provide ()</h3><a class="indexterm" name="id254742"></a><pre class="programlisting">void        glade_provide                   (const gchar *library);</pre><p>
This function should be called by a module to assert that it
provides wrappers for a particular library.  This should be called
by the <tt class="function">register_widgets()</tt> function of a libglade module so that it
isn't loaded twice, for instance.</p><p>

</p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><i class="parameter"><tt>library</tt></i>:</span></td><td> the provided library
</td></tr></tbody></table></div></div></div></div><table class="navigation" width="100%" summary="Navigation footer" cellpadding="2" cellspacing="0"><tr valign="middle"><td align="left"><a accesskey="p" href="libglade-lib.html"><b>&lt;&lt;PartI.Libglade Library Reference</b></a></td><td align="right"><a accesskey="n" href="GladeXML.html"><b>GladeXML&gt;&gt;</b></a></td></tr></table></body></html>