File: //usr/local/ssl/share/gtk-doc/html/libbonoboui/libbonoboui-bonobo-ui-node.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>bonobo-ui-node</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="LibBonoboUI API Reference Manual">
<link rel="up" href="bonobo-ui.html" title="Bonobo UI">
<link rel="prev" href="libbonoboui-bonobo-ui-util.html" title="bonobo-ui-util">
<link rel="next" href="libbonoboui-bonobo-ui-engine.html" title="BonoboUIEngine">
<meta name="generator" content="GTK-Doc V1.7 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="bonobo-controls.html" title="Controls">
<link rel="chapter" href="bonobo-ui.html" title="Bonobo UI">
<link rel="chapter" href="bonobo-support-utilities.html" title="Supporting Classes">
</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="2">
<tr valign="middle">
<td><a accesskey="p" href="libbonoboui-bonobo-ui-util.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="bonobo-ui.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">LibBonoboUI API Reference Manual</th>
<td><a accesskey="n" href="libbonoboui-bonobo-ui-engine.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2790949" class="shortcut">Top</a>
 | 
<a href="#id2791753" class="shortcut">Description</a></nobr></td></tr>
</table>
<div class="refentry" lang="en">
<a name="libbonoboui-bonobo-ui-node"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2>
<a name="id2790949"></a><span class="refentrytitle">bonobo-ui-node</span>
</h2>
<p>bonobo-ui-node — Simplified XML Node manipulation API</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<h2>Synopsis</h2>
<pre class="synopsis">
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>;
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-new">bonobo_ui_node_new</a> (const char *name);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-new-child">bonobo_ui_node_new_child</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *parent,
const char *name);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-copy">bonobo_ui_node_copy</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> recursive);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-free">bonobo_ui_node_free</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-set-data">bonobo_ui_node_set_data</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-get-data">bonobo_ui_node_get_data</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-set-attr">bonobo_ui_node_set_attr</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name,
const char *value);
char* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-get-attr">bonobo_ui_node_get_attr</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-has-attr">bonobo_ui_node_has_attr</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-remove-attr">bonobo_ui_node_remove_attr</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-add-child">bonobo_ui_node_add_child</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *parent,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *child);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-insert-before">bonobo_ui_node_insert_before</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *after,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *new_before);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-unlink">bonobo_ui_node_unlink</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-replace">bonobo_ui_node_replace</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *old_node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *new_node);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-set-content">bonobo_ui_node_set_content</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *content);
char* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-get-content">bonobo_ui_node_get_content</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-next">bonobo_ui_node_next</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-prev">bonobo_ui_node_prev</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-children">bonobo_ui_node_children</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-parent">bonobo_ui_node_parent</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
const char* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-get-name">bonobo_ui_node_get_name</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-has-name">bonobo_ui_node_has_name</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-transparent">bonobo_ui_node_transparent</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-copy-attrs">bonobo_ui_node_copy_attrs</a> (const <a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *src,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *dest);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-free-string">bonobo_ui_node_free_string</a> (char *str);
void <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-strip">bonobo_ui_node_strip</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> **node);
char* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-to-string">bonobo_ui_node_to_string</a> (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> recurse);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-from-string">bonobo_ui_node_from_string</a> (const char *str);
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* <a href="libbonoboui-bonobo-ui-node.html#bonobo-ui-node-from-file">bonobo_ui_node_from_file</a> (const char *filename);
</pre>
</div>
<div class="refsect1" lang="en">
<a name="id2791753"></a><h2>Description</h2>
<p>
The BonoboUINode API is designed to make XML node manipulation
simple, and to hide the underlying implementation of the XML tree.
This is to allow the use of some more efficient internal representation
than libxml's at some later date.
</p>
</div>
<div class="refsect1" lang="en">
<a name="id2791772"></a><h2>Details</h2>
<div class="refsect2" lang="en">
<a name="id2791782"></a><h3>
<a name="BonoboUINode"></a>BonoboUINode</h3>
<a class="indexterm" name="id2791795"></a><pre class="programlisting">typedef struct _BonoboUINode BonoboUINode;</pre>
<p>
The BonoboUINode structure is fully opaque to stop any code
depending on libxml inadvertantly.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2791812"></a><h3>
<a name="bonobo-ui-node-new"></a>bonobo_ui_node_new ()</h3>
<a class="indexterm" name="id2791826"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_new (const char *name);</pre>
<p>
Creates a new node with name <em class="parameter"><code>name</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> The name for the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a new node pointer
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2791891"></a><h3>
<a name="bonobo-ui-node-new-child"></a>bonobo_ui_node_new_child ()</h3>
<a class="indexterm" name="id2791904"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_new_child (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *parent,
const char *name);</pre>
<p>
Create a new node as a child of <em class="parameter"><code>parent</code></em> with name <em class="parameter"><code>name</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
<td> the parent
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the new child
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> pointer to the new child
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2791998"></a><h3>
<a name="bonobo-ui-node-copy"></a>bonobo_ui_node_copy ()</h3>
<a class="indexterm" name="id2792012"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_copy (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> recursive);</pre>
<p>
Copy an XML node, if <em class="parameter"><code>recursive</code></em> do a deep copy, otherwise just dup the node itself.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>recursive</code></em> :</span></td>
<td> whether to dup children too.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> a copy of the noce
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792101"></a><h3>
<a name="bonobo-ui-node-free"></a>bonobo_ui_node_free ()</h3>
<a class="indexterm" name="id2792114"></a><pre class="programlisting">void bonobo_ui_node_free (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Frees the memory associated with the <em class="parameter"><code>node</code></em> and unlink it from the tree</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> a node.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792171"></a><h3>
<a name="bonobo-ui-node-set-data"></a>bonobo_ui_node_set_data ()</h3>
<a class="indexterm" name="id2792184"></a><pre class="programlisting">void bonobo_ui_node_set_data (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> data);</pre>
<p>
Associates some user data with the node pointer</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>data</code></em> :</span></td>
<td> user data
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792256"></a><h3>
<a name="bonobo-ui-node-get-data"></a>bonobo_ui_node_get_data ()</h3>
<a class="indexterm" name="id2792269"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"
>gpointer</a> bonobo_ui_node_get_data (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Gets user data associated with <em class="parameter"><code>node</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the user data, see bonobo_ui_node_set_data
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792335"></a><h3>
<a name="bonobo-ui-node-set-attr"></a>bonobo_ui_node_set_attr ()</h3>
<a class="indexterm" name="id2792348"></a><pre class="programlisting">void bonobo_ui_node_set_attr (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name,
const char *value);</pre>
<p>
Set the attribute of <em class="parameter"><code>name</code></em> on <em class="parameter"><code>node</code></em> to <em class="parameter"><code>value</code></em> overriding any
previous values of that attr.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> The node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the attr
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>value</code></em> :</span></td>
<td> the value for the attr
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792460"></a><h3>
<a name="bonobo-ui-node-get-attr"></a>bonobo_ui_node_get_attr ()</h3>
<a class="indexterm" name="id2792474"></a><pre class="programlisting">char* bonobo_ui_node_get_attr (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);</pre>
<p>
Fetch the value of an attr of name <em class="parameter"><code>name</code></em> from <em class="parameter"><code>node</code></em>
see also: bonobo_ui_node_free_string</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the attr to get
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the attr text.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792569"></a><h3>
<a name="bonobo-ui-node-has-attr"></a>bonobo_ui_node_has_attr ()</h3>
<a class="indexterm" name="id2792583"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_ui_node_has_attr (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);</pre>
<p>
Determines whether the <em class="parameter"><code>node</code></em> has an attribute of name <em class="parameter"><code>name</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> the name of the attr to detect
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> TRUE if the attr exists
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792676"></a><h3>
<a name="bonobo-ui-node-remove-attr"></a>bonobo_ui_node_remove_attr ()</h3>
<a class="indexterm" name="id2792690"></a><pre class="programlisting">void bonobo_ui_node_remove_attr (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);</pre>
<p>
remove any attribute with name <em class="parameter"><code>name</code></em> from <em class="parameter"><code>node</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> name of the attribute
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792773"></a><h3>
<a name="bonobo-ui-node-add-child"></a>bonobo_ui_node_add_child ()</h3>
<a class="indexterm" name="id2792786"></a><pre class="programlisting">void bonobo_ui_node_add_child (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *parent,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *child);</pre>
<p>
Add a <em class="parameter"><code>child</code></em> node to the <em class="parameter"><code>parent</code></em> node ( after the other children )</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>parent</code></em> :</span></td>
<td> the parent
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>child</code></em> :</span></td>
<td> the new child
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792870"></a><h3>
<a name="bonobo-ui-node-insert-before"></a>bonobo_ui_node_insert_before ()</h3>
<a class="indexterm" name="id2792884"></a><pre class="programlisting">void bonobo_ui_node_insert_before (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *after,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *new_before);</pre>
<p>
Insert a <em class="parameter"><code>sibling</code></em> before <em class="parameter"><code>prev_sibling</code></em> in a node list</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>after</code></em> :</span></td>
<td> the placeholder for insertion
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_before</code></em> :</span></td>
<td> the node to insert
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2792969"></a><h3>
<a name="bonobo-ui-node-unlink"></a>bonobo_ui_node_unlink ()</h3>
<a class="indexterm" name="id2792983"></a><pre class="programlisting">void bonobo_ui_node_unlink (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Unlink <em class="parameter"><code>node</code></em> from its tree, ie. disassociate it with its parent</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793040"></a><h3>
<a name="bonobo-ui-node-replace"></a>bonobo_ui_node_replace ()</h3>
<a class="indexterm" name="id2793053"></a><pre class="programlisting">void bonobo_ui_node_replace (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *old_node,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *new_node);</pre>
<p>
Replace <em class="parameter"><code>old_node</code></em> with <em class="parameter"><code>new_node</code></em> in the tree. <em class="parameter"><code>old_node</code></em> is
left unlinked and floating with its children.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>old_node</code></em> :</span></td>
<td> node to be replaced
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>new_node</code></em> :</span></td>
<td> node to replace with
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793144"></a><h3>
<a name="bonobo-ui-node-set-content"></a>bonobo_ui_node_set_content ()</h3>
<a class="indexterm" name="id2793158"></a><pre class="programlisting">void bonobo_ui_node_set_content (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *content);</pre>
<p>
Set the textual content of <em class="parameter"><code>node</code></em> to <em class="parameter"><code>content</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>content</code></em> :</span></td>
<td> the new content
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793241"></a><h3>
<a name="bonobo-ui-node-get-content"></a>bonobo_ui_node_get_content ()</h3>
<a class="indexterm" name="id2793254"></a><pre class="programlisting">char* bonobo_ui_node_get_content (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
see also: bonobo_ui_node_free_string</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the content of <em class="parameter"><code>node</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793320"></a><h3>
<a name="bonobo-ui-node-next"></a>bonobo_ui_node_next ()</h3>
<a class="indexterm" name="id2793334"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_next (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the node after <em class="parameter"><code>node</code></em> in the list
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793400"></a><h3>
<a name="bonobo-ui-node-prev"></a>bonobo_ui_node_prev ()</h3>
<a class="indexterm" name="id2793414"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_prev (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the node after <em class="parameter"><code>node</code></em> in the list
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793480"></a><h3>
<a name="bonobo-ui-node-children"></a>bonobo_ui_node_children ()</h3>
<a class="indexterm" name="id2793493"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_children (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the first child of <em class="parameter"><code>node</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793559"></a><h3>
<a name="bonobo-ui-node-parent"></a>bonobo_ui_node_parent ()</h3>
<a class="indexterm" name="id2793573"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_parent (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the parent node of <em class="parameter"><code>node</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793639"></a><h3>
<a name="bonobo-ui-node-get-name"></a>bonobo_ui_node_get_name ()</h3>
<a class="indexterm" name="id2793652"></a><pre class="programlisting">const char* bonobo_ui_node_get_name (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the name of <em class="parameter"><code>node</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793719"></a><h3>
<a name="bonobo-ui-node-has-name"></a>bonobo_ui_node_has_name ()</h3>
<a class="indexterm" name="id2793732"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_ui_node_has_name (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
const char *name);</pre>
<p>
</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>name</code></em> :</span></td>
<td> a name the node might have
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> TRUE if <em class="parameter"><code>node</code></em> has name == <em class="parameter"><code>name</code></em>
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793826"></a><h3>
<a name="bonobo-ui-node-transparent"></a>bonobo_ui_node_transparent ()</h3>
<a class="indexterm" name="id2793840"></a><pre class="programlisting"><a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> bonobo_ui_node_transparent (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node);</pre>
<p>
Determines whether <em class="parameter"><code>node</code></em> is transparent. A node is
transparent if it has no content and either no attributes
or a single 'name' attribute.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> TRUE if transparent
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2793908"></a><h3>
<a name="bonobo-ui-node-copy-attrs"></a>bonobo_ui_node_copy_attrs ()</h3>
<a class="indexterm" name="id2793922"></a><pre class="programlisting">void bonobo_ui_node_copy_attrs (const <a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *src,
<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *dest);</pre>
<p>
This function copies all the attributes from <em class="parameter"><code>src</code></em> to <em class="parameter"><code>dest</code></em>
effectively cloning the <em class="parameter"><code>src</code></em> node as <em class="parameter"><code>dest</code></em></p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>src</code></em> :</span></td>
<td> the attr source node
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>dest</code></em> :</span></td>
<td> where to dump the attrs.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2794017"></a><h3>
<a name="bonobo-ui-node-free-string"></a>bonobo_ui_node_free_string ()</h3>
<a class="indexterm" name="id2794031"></a><pre class="programlisting">void bonobo_ui_node_free_string (char *str);</pre>
<p>
Frees a string returned by any of the get routines.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td> the string to free.
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2794082"></a><h3>
<a name="bonobo-ui-node-strip"></a>bonobo_ui_node_strip ()</h3>
<a class="indexterm" name="id2794094"></a><pre class="programlisting">void bonobo_ui_node_strip (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> **node);</pre>
<p>
A compat function for legacy reasons.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> a pointer to the node's pointer
</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2794145"></a><h3>
<a name="bonobo-ui-node-to-string"></a>bonobo_ui_node_to_string ()</h3>
<a class="indexterm" name="id2794159"></a><pre class="programlisting">char* bonobo_ui_node_to_string (<a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a> *node,
<a
href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"
>gboolean</a> recurse);</pre>
<p>
Convert the node to its XML string representation.</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>node</code></em> :</span></td>
<td> the node tree
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>recurse</code></em> :</span></td>
<td> whether to dump its children as well
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the string representation or NULL on error
Use g_free to free.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2794243"></a><h3>
<a name="bonobo-ui-node-from-string"></a>bonobo_ui_node_from_string ()</h3>
<a class="indexterm" name="id2794257"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_from_string (const char *str);</pre>
<p>
Parses a string into an XML tree</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>str</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the xml tree.
</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2794317"></a><h3>
<a name="bonobo-ui-node-from-file"></a>bonobo_ui_node_from_file ()</h3>
<a class="indexterm" name="id2794330"></a><pre class="programlisting"><a href="libbonoboui-bonobo-ui-node.html#BonoboUINode">BonoboUINode</a>* bonobo_ui_node_from_file (const char *filename);</pre>
<p>
Loads and parses the filename into an XML tree</p>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>filename</code></em> :</span></td>
<td>
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td>
<td> the xml tree.
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
<div class="refsect1" lang="en">
<a name="id2794392"></a><h2>See Also</h2>
<p>
<a href="libbonoboui-bonobo-ui-component.html#BonoboUIComponent"><span class="type">BonoboUIComponent</span></a>, <span class="type">bonobo-ui-util</span>
</p>
</div>
</div>
</body>
</html>