<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>libgdamm: Gnome::Gda::Holder Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">libgdamm
 <span id="projectnumber">4.99.6</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.5.1-20110925 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="namespaceGnome.html">Gnome</a> </li>
<li class="navelem"><a class="el" href="namespaceGnome_1_1Gda.html">Gda</a> </li>
<li class="navelem"><a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> </li>
</ul>
</div>
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#pro-methods">Protected Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<div class="title">Gnome::Gda::Holder Class Reference<div class="ingroups"><a class="el" href="group__DataHandlers.html">Data Handlers</a></div></div> </div>
</div>
<div class="contents">
<!-- doxytag: class="Gnome::Gda::Holder" --><!-- doxytag: inherits="Glib::Object" -->
<p>Container for a single <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Gda::Value</a>. <a href="classGnome_1_1Gda_1_1Holder.html#details">More...</a></p>
<div class="dynheader">
Inheritance diagram for Gnome::Gda::Holder:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1Holder__inherit__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1Holder_inherit__map" alt="Inheritance graph"/></div>
<map name="Gnome_1_1Gda_1_1Holder_inherit__map" id="Gnome_1_1Gda_1_1Holder_inherit__map">
<area shape="rect" id="node2" /></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<div class="dynheader">
Collaboration diagram for Gnome::Gda::Holder:</div>
<div class="dyncontent">
<div class="center"><img src="classGnome_1_1Gda_1_1Holder__coll__graph.png" border="0" usemap="#Gnome_1_1Gda_1_1Holder_coll__map" alt="Collaboration graph"/></div>
<map name="Gnome_1_1Gda_1_1Holder_coll__map" id="Gnome_1_1Gda_1_1Holder_coll__map">
<area shape="rect" id="node2" /></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGnome_1_1Gda_1_1Holder-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#abc4210cf43aef80ae56bf1c003db9b10">~Holder</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaHolder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a7032ce96e5db792c57ac7abb5647b707">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a7032ce96e5db792c57ac7abb5647b707"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GdaHolder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a684dd2036005ca7799761a0cab039c7b">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <a href="#a684dd2036005ca7799761a0cab039c7b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GdaHolder* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#aa36ea26a0aaaafd98a5e9310b2311114">gobj_copy</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <a href="#aa36ea26a0aaaafd98a5e9310b2311114"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >copy</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Copy constructor. <a href="#ab60ce4410f8f1dc896006f0c84c1bae8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GType </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a6939a75ea9ab8cd9d14879b7d19b7def">get_g_type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get <em>holder's</em> type. <a href="#a6939a75ea9ab8cd9d14879b7d19b7def"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >get_id</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the ID of <em>holder</em>. <a href="#a72c54bd4e6c3d3052d7a2fc9cc99d034"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a5cd1f5ca6e80b66d5c4c09e70d395a40">get_value</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the value held into the holder. <a href="#a5cd1f5ca6e80b66d5c4c09e70d395a40"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >DataHandler</a> >& dh) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Same functionality as <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a5cd1f5ca6e80b66d5c4c09e70d395a40" title="Get the value held into the holder.">get_value()</a> except that it returns the value as a string (the conversion is done using <em>dh</em> if not <code>0</code>, or the default data handler otherwise). <a href="#a036ae8e94d6f71a9a944ae78f3160508"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8063525e34d29eeca710f6a4990194c4">set_value_as_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>&<a class="elRef" >value</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the value within the holder. <a href="#a8063525e34d29eeca710f6a4990194c4"></a><br/></td></tr>
<tr><td class="memTemplParams" colspan="2">template<class ValueType > </td></tr>
<tr><td class="memTemplItemLeft" align="right" valign="top">bool </td><td class="memTemplItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a64ad49fcadb2d6748a444892b097f128">set_value</a> (const ValueType&<a class="elRef" >value</a>)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a3d9e7e8fd2a115cd01111fcc4d31d5a3">set_value_str</a> (const <a class="elRef" >value</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Same functionality as <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a64ad49fcadb2d6748a444892b097f128">set_value()</a> except that it uses a string representation of the value to set, which will be converted into a GValue first (using default data handler if <em>dh</em> is <code>0</code>). <a href="#a3d9e7e8fd2a115cd01111fcc4d31d5a3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8a2ef486bf9c9f855e67b9ad7781653c">take_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>&<a class="elRef" >value</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the value within the holder. <a href="#a8a2ef486bf9c9f855e67b9ad7781653c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#af46c921837245a870733ae518df9d18e">take_static_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>&<a class="elRef" >value</a>, bool& value_changed)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the const value within the holder. <a href="#af46c921837245a870733ae518df9d18e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a4178f1d24a1ec14a33d08296ce466201">set_attribute</a> (const <a class="elRef" >value</a>)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#aa9db1bda49609b6da4cb4642c8680e6c">get_attribute</a> (const <a class="elRef" >Glib::ustring</a>& attribute) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the value associated to a named attribute. <a href="#aa9db1bda49609b6da4cb4642c8680e6c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a982193f0aa803f1ef7ebf09267a285c3">get_default_value</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the default value held into the holder. <a href="#a982193f0aa803f1ef7ebf09267a285c3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a24940e0d9ddaaf567f7984171930d463">set_default_value</a> (const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>&<a class="elRef" >value</a>)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the default value within the holder. <a href="#a24940e0d9ddaaf567f7984171930d463"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a89bf918cba4702b862105ca6d010a17b">set_value_to_default</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGnome_1_1Gda_1_1Set.html" title="Container for several values.">Set</a> <em>holder's</em> value to its default value. <a href="#a89bf918cba4702b862105ca6d010a17b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a745821514d06a35016b9768f4c2d77bb">value_is_default</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tells if <em>holder's</em> current value is the default one. <a href="#a745821514d06a35016b9768f4c2d77bb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a87df6cd27006f5c799f14e3e48fa1f91">force_invalid</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Forces a holder to be invalid; to set it valid again, a new value must be assigned to it using <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a64ad49fcadb2d6748a444892b097f128">set_value()</a> or <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8a2ef486bf9c9f855e67b9ad7781653c" title="Sets the value within the holder.">take_value()</a>. <a href="#a87df6cd27006f5c799f14e3e48fa1f91"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ac1832074bf45c4e1e14a9de831af9122">is_valid</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the validity of <em>holder</em> (that is, of the value held by <em>holder</em>) <a href="#ac1832074bf45c4e1e14a9de831af9122"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ab35be6133133f4488c40f9a620e82e18">set_not_null</a> (bool not_null=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets if the holder can have a <code>0</code> value. <a href="#ab35be6133133f4488c40f9a620e82e18"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a4bef88a05240ab453e169cb53aecb550">get_not_null</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get wether the holder can be <code>0</code> or not. <a href="#a4bef88a05240ab453e169cb53aecb550"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >get_source_model</a> (int& col)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If <a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae9ee5ad1d5ba7aacc5675eefd67fe271" title="Sets an hint that holder's values should be restricted among the values contained in the col column o...">set_source_model()</a> has been used to provide a hint that <em>holder's</em> value should be among the values contained in a column of a data model, then this method returns which data model, and if <em>col</em> is not <code>0</code>, then it is set to the restricting column as well. <a href="#a265590f1aed75d56d1ebcb784ea8a7c0"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >get_source_model</a> (int& col) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">If <a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae9ee5ad1d5ba7aacc5675eefd67fe271" title="Sets an hint that holder's values should be restricted among the values contained in the col column o...">set_source_model()</a> has been used to provide a hint that <em>holder's</em> value should be among the values contained in a column of a data model, then this method returns which data model, and if <em>col</em> is not <code>0</code>, then it is set to the restricting column as well. <a href="#ae3a5c81bdc5f953c7e14479b2f3a948d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae9ee5ad1d5ba7aacc5675eefd67fe271">set_source_model</a> (const <a class="elRef" >DataModel</a> >& model, int col)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an hint that <em>holder's</em> values should be restricted among the values contained in the <em>col</em> column of the <em>model</em> data model. <a href="#ae9ee5ad1d5ba7aacc5675eefd67fe271"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ac23053c0f77127a13e67a48fe34f7f3d">set_bind</a> (const <a class="elRef" >Holder</a> >& bind_to)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets <em>holder</em> to change when <em>bind_to</em> changes (and does not make <em>bind_to</em> change when <em>holder</em> changes). <a href="#ac23053c0f77127a13e67a48fe34f7f3d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >get_bind</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the holder which makes <em>holder</em> change its value when the holder's value is changed. <a href="#a8ba0326fcf95deb370743a7736d949fb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >get_bind</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the holder which makes <em>holder</em> change its value when the holder's value is changed. <a href="#ae7739037be994307f1552b53933bc09b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_description</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's description. <a href="#a87966f82759a5501336a56d25d529cfd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_description</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's description. <a href="#abe67baa53fe0f9e5cec60e5c0fc5c863"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_full_bind</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make value holder follow other GdaHolder's changes and the other way around. <a href="#acd35047d792e04b22c8b92f7b5f51f5b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_full_bind</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make value holder follow other GdaHolder's changes and the other way around. <a href="#aebae539a1dbf093bf5b425deac47677f"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >property_g_type</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's GType. <a href="#a7fc31f638cfccf1e800e767a5167bff5"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< gulong > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a5080a0c4f4e306fe5f61ca2cbbed5f24">property_g_type</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's GType. <a href="#a5080a0c4f4e306fe5f61ca2cbbed5f24"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_id</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's ID. <a href="#acf9fa13b87d337a21ab736e8e89614e8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_id</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's ID. <a href="#a8dba4c1207852ddaa9a1e92a5bdcd9ea"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_name</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's name. <a href="#a802d89be45ddb4455894aeec6dfcfc2c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_name</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Holder's name. <a href="#a897c03b691f15e09eede622e9609f85c"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >property_not_null</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Can the value holder be NULL?. <a href="#aeaf03b8f0268a014490a3a35916aaef2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a37f555cd2bced6cc40df39accbe81597">property_not_null</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Can the value holder be NULL?. <a href="#a37f555cd2bced6cc40df39accbe81597"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_simple_bind</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make value holder follow other GdaHolder's changes. <a href="#a9c5910e4ddac682cd01c44e7f17d7e8a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_simple_bind</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Make value holder follow other GdaHolder's changes. <a href="#a256784dbf6c0fcf12748a9733c3847a8"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >property_source_column</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGnome_1_1Gda_1_1Column.html" title="Management of DataModel column attributes.">Column</a> number to use in coordination with the source-model property. <a href="#a029dc461eef4f7a403d03c512ab3b9b6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >property_source_column</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><a class="el" href="classGnome_1_1Gda_1_1Column.html" title="Management of DataModel column attributes.">Column</a> number to use in coordination with the source-model property. <a href="#ac22098f16f36e6625fd5b0621dc23e99"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_source_model</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Data model among which the holder's value should be. <a href="#a7aa01c16931aee1116a7dbe98ec38500"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >property_source_model</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Data model among which the holder's value should be. <a href="#aff18f95824a66824249c71750313d5be"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >signal_changed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >signal_source_changed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
< <a class="elRef" >signal_validate_change</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" />
const <a class="elRef" />
<a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ab8da2dcd2bea4e797bd511ff3969f7db">signal_attribute_changed</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" >Glib::ustring</a>& id)</td></tr>
<tr><td colspan="2"><h2><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ad4a705363436db8514190f8531c9fc5a">Holder</a> (GType g_type, const <a class="elRef" >Glib::ustring</a>& id)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a57aff0961cadd31ba600ff5e1f38b123">on_changed</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#acf7c85a3d28f1bb1bcde5edfa575a8f1">on_source_changed</a> ()</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p>
</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" >wrap</a> (GdaHolder* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" ></a><br/></td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Container for a single <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Gda::Value</a>. </p>
<p>The GdaHolder is a container for a single <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Gda::Value</a> value. It also specifies various attributes of the contained value (default value, ...) </p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="abc4210cf43aef80ae56bf1c003db9b10"></a><!-- doxytag: member="Gnome::Gda::Holder::~Holder" ref="abc4210cf43aef80ae56bf1c003db9b10" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gnome::Gda::Holder::~Holder </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ad4a705363436db8514190f8531c9fc5a"></a><!-- doxytag: member="Gnome::Gda::Holder::Holder" ref="ad4a705363436db8514190f8531c9fc5a" args="(GType g_type, const Glib::ustring &id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gnome::Gda::Holder::Holder </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"><em>g_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" >Glib::ustring</a> & </td>
<td class="paramname"><em>id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="ab60ce4410f8f1dc896006f0c84c1bae8"></a><!-- doxytag: member="Gnome::Gda::Holder::copy" ref="ab60ce4410f8f1dc896006f0c84c1bae8" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> Gnome::Gda::Holder::copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Copy constructor. </p>
<dl class="note"><dt><b>Note:</b></dt><dd>if <em>orig</em> is set with a static value (see <a class="el" href="classGnome_1_1Gda_1_1Holder.html#af46c921837245a870733ae518df9d18e" title="Sets the const value within the holder.">take_static_value()</a>) its copy will have a fresh new allocated GValue, so that user should free it when done. </dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A new <a class="el" href="classGnome_1_1Gda_1_1Holder.html" title="Container for a single Gda::Value.">Gda::Holder</a> object. </dd></dl>
</div>
</div>
<a class="anchor" id="a6a75fb3690b303f8757f77888e7a5810"></a><!-- doxytag: member="Gnome::Gda::Holder::create" ref="a6a75fb3690b303f8757f77888e7a5810" args="(GType g_type, const Glib::ustring &id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="elRef" >Holder</a>> Gnome::Gda::Holder::create </td>
<td>(</td>
<td class="paramtype">GType </td>
<td class="paramname"><em>g_type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" >Glib::ustring</a> & </td>
<td class="paramname"><em>id</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a87df6cd27006f5c799f14e3e48fa1f91"></a><!-- doxytag: member="Gnome::Gda::Holder::force_invalid" ref="a87df6cd27006f5c799f14e3e48fa1f91" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Gda::Holder::force_invalid </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Forces a holder to be invalid; to set it valid again, a new value must be assigned to it using <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a64ad49fcadb2d6748a444892b097f128">set_value()</a> or <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8a2ef486bf9c9f855e67b9ad7781653c" title="Sets the value within the holder.">take_value()</a>. </p>
<p><em>holder's</em> value is set to <code>0</code>. </p>
</div>
</div>
<a class="anchor" id="aa9db1bda49609b6da4cb4642c8680e6c"></a><!-- doxytag: member="Gnome::Gda::Holder::get_attribute" ref="aa9db1bda49609b6da4cb4642c8680e6c" args="(const Glib::ustring &attribute) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::Holder::get_attribute </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >Glib::ustring</a> & </td>
<td class="paramname"><em>attribute</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the value associated to a named attribute. </p>
<p>Attributes can have any name, but Libgda proposes some default names, see this section. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">attribute</td><td>Attribute name as a string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A read-only <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Value</a>, or <code>0</code> if not attribute named <em>attribute</em> has been set for <em>holder</em>. </dd></dl>
</div>
</div>
<a class="anchor" id="a8ba0326fcf95deb370743a7736d949fb"></a><!-- doxytag: member="Gnome::Gda::Holder::get_bind" ref="a8ba0326fcf95deb370743a7736d949fb" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> Gnome::Gda::Holder::get_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the holder which makes <em>holder</em> change its value when the holder's value is changed. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGnome_1_1Gda_1_1Holder.html" title="Container for a single Gda::Value.">Gda::Holder</a> or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="ae7739037be994307f1552b53933bc09b"></a><!-- doxytag: member="Gnome::Gda::Holder::get_bind" ref="ae7739037be994307f1552b53933bc09b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> Gnome::Gda::Holder::get_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the holder which makes <em>holder</em> change its value when the holder's value is changed. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The <a class="el" href="classGnome_1_1Gda_1_1Holder.html" title="Container for a single Gda::Value.">Gda::Holder</a> or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a982193f0aa803f1ef7ebf09267a285c3"></a><!-- doxytag: member="Gnome::Gda::Holder::get_default_value" ref="a982193f0aa803f1ef7ebf09267a285c3" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::Holder::get_default_value </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the default value held into the holder. </p>
<p>WARNING: the default value does not need to be of the same type as the one required by <em>holder</em>. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The default value. </dd></dl>
</div>
</div>
<a class="anchor" id="a6939a75ea9ab8cd9d14879b7d19b7def"></a><!-- doxytag: member="Gnome::Gda::Holder::get_g_type" ref="a6939a75ea9ab8cd9d14879b7d19b7def" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GType Gnome::Gda::Holder::get_g_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get <em>holder's</em> type. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The data type. </dd></dl>
</div>
</div>
<a class="anchor" id="a72c54bd4e6c3d3052d7a2fc9cc99d034"></a><!-- doxytag: member="Gnome::Gda::Holder::get_id" ref="a72c54bd4e6c3d3052d7a2fc9cc99d034" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a> Gnome::Gda::Holder::get_id </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the ID of <em>holder</em>. </p>
<p>The ID can be set using <em>holder's</em> "id" property </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The ID (don't modify the string). </dd></dl>
</div>
</div>
<a class="anchor" id="a4bef88a05240ab453e169cb53aecb550"></a><!-- doxytag: member="Gnome::Gda::Holder::get_not_null" ref="a4bef88a05240ab453e169cb53aecb550" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::get_not_null </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get wether the holder can be <code>0</code> or not. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the holder cannot be <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a265590f1aed75d56d1ebcb784ea8a7c0"></a><!-- doxytag: member="Gnome::Gda::Holder::get_source_model" ref="a265590f1aed75d56d1ebcb784ea8a7c0" args="(int &col)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >DataModel</a>> Gnome::Gda::Holder::get_source_model </td>
<td>(</td>
<td class="paramtype">int & </td>
<td class="paramname"><em>col</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If <a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae9ee5ad1d5ba7aacc5675eefd67fe271" title="Sets an hint that holder's values should be restricted among the values contained in the col column o...">set_source_model()</a> has been used to provide a hint that <em>holder's</em> value should be among the values contained in a column of a data model, then this method returns which data model, and if <em>col</em> is not <code>0</code>, then it is set to the restricting column as well. </p>
<p>Otherwise, this method returns <code>0</code>, and if <em>col</em> is not <code>0</code>, then it is set to 0. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">col</td><td>A place to store the column in the model sourcing the holder, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="ae3a5c81bdc5f953c7e14479b2f3a948d"></a><!-- doxytag: member="Gnome::Gda::Holder::get_source_model" ref="ae3a5c81bdc5f953c7e14479b2f3a948d" args="(int &col) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >DataModel</a>> Gnome::Gda::Holder::get_source_model </td>
<td>(</td>
<td class="paramtype">int & </td>
<td class="paramname"><em>col</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>If <a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae9ee5ad1d5ba7aacc5675eefd67fe271" title="Sets an hint that holder's values should be restricted among the values contained in the col column o...">set_source_model()</a> has been used to provide a hint that <em>holder's</em> value should be among the values contained in a column of a data model, then this method returns which data model, and if <em>col</em> is not <code>0</code>, then it is set to the restricting column as well. </p>
<p>Otherwise, this method returns <code>0</code>, and if <em>col</em> is not <code>0</code>, then it is set to 0. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">col</td><td>A place to store the column in the model sourcing the holder, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A pointer to a <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a>, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a5cd1f5ca6e80b66d5c4c09e70d395a40"></a><!-- doxytag: member="Gnome::Gda::Holder::get_value" ref="a5cd1f5ca6e80b66d5c4c09e70d395a40" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::Holder::get_value </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the value held into the holder. </p>
<p>If <em>holder</em> is set to use its default value and that default value is not of the same type as <em>holder</em>, then <code>0</code> is returned.</p>
<p>If <em>holder</em> is set to <code>0</code>, then the returned value is a Gda::TYPE_<tt>0 GValue. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>The value, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a036ae8e94d6f71a9a944ae78f3160508"></a><!-- doxytag: member="Gnome::Gda::Holder::get_value_str" ref="a036ae8e94d6f71a9a944ae78f3160508" args="(const Glib::RefPtr< DataHandler > &dh) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a> Gnome::Gda::Holder::get_value_str </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >DataHandler</a> >& </td>
<td class="paramname"><em>dh</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Same functionality as <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a5cd1f5ca6e80b66d5c4c09e70d395a40" title="Get the value held into the holder.">get_value()</a> except that it returns the value as a string (the conversion is done using <em>dh</em> if not <code>0</code>, or the default data handler otherwise). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dh</td><td>A <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html" title="Base class which provides data handling capabilities.">Gda::DataHandler</a> to use, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The value, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a7032ce96e5db792c57ac7abb5647b707"></a><!-- doxytag: member="Gnome::Gda::Holder::gobj" ref="a7032ce96e5db792c57ac7abb5647b707" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdaHolder* Gnome::Gda::Holder::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" >Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="a684dd2036005ca7799761a0cab039c7b"></a><!-- doxytag: member="Gnome::Gda::Holder::gobj" ref="a684dd2036005ca7799761a0cab039c7b" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GdaHolder* Gnome::Gda::Holder::gobj </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const<code> [inline]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C GObject. </p>
<p>Reimplemented from <a class="elRef" >Glib::ObjectBase</a>.</p>
</div>
</div>
<a class="anchor" id="aa36ea26a0aaaafd98a5e9310b2311114"></a><!-- doxytag: member="Gnome::Gda::Holder::gobj_copy" ref="aa36ea26a0aaaafd98a5e9310b2311114" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GdaHolder* Gnome::Gda::Holder::gobj_copy </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. </p>
</div>
</div>
<a class="anchor" id="ac1832074bf45c4e1e14a9de831af9122"></a><!-- doxytag: member="Gnome::Gda::Holder::is_valid" ref="ac1832074bf45c4e1e14a9de831af9122" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::is_valid </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the validity of <em>holder</em> (that is, of the value held by <em>holder</em>) </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>holder's</em> value can safely be used. </dd></dl>
</div>
</div>
<a class="anchor" id="a57aff0961cadd31ba600ff5e1f38b123"></a><!-- doxytag: member="Gnome::Gda::Holder::on_changed" ref="a57aff0961cadd31ba600ff5e1f38b123" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gnome::Gda::Holder::on_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="acf7c85a3d28f1bb1bcde5edfa575a8f1"></a><!-- doxytag: member="Gnome::Gda::Holder::on_source_changed" ref="acf7c85a3d28f1bb1bcde5edfa575a8f1" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gnome::Gda::Holder::on_source_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a87966f82759a5501336a56d25d529cfd"></a><!-- doxytag: member="Gnome::Gda::Holder::property_description" ref="a87966f82759a5501336a56d25d529cfd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_description </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's description. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="abe67baa53fe0f9e5cec60e5c0fc5c863"></a><!-- doxytag: member="Gnome::Gda::Holder::property_description" ref="abe67baa53fe0f9e5cec60e5c0fc5c863" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_description </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's description. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="acd35047d792e04b22c8b92f7b5f51f5b"></a><!-- doxytag: member="Gnome::Gda::Holder::property_full_bind" ref="acd35047d792e04b22c8b92f7b5f51f5b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> > Gnome::Gda::Holder::property_full_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Make value holder follow other GdaHolder's changes and the other way around. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aebae539a1dbf093bf5b425deac47677f"></a><!-- doxytag: member="Gnome::Gda::Holder::property_full_bind" ref="aebae539a1dbf093bf5b425deac47677f" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> > Gnome::Gda::Holder::property_full_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Make value holder follow other GdaHolder's changes and the other way around. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a7fc31f638cfccf1e800e767a5167bff5"></a><!-- doxytag: member="Gnome::Gda::Holder::property_g_type" ref="a7fc31f638cfccf1e800e767a5167bff5" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy</a><gulong> Gnome::Gda::Holder::property_g_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's GType. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a5080a0c4f4e306fe5f61ca2cbbed5f24"></a><!-- doxytag: member="Gnome::Gda::Holder::property_g_type" ref="a5080a0c4f4e306fe5f61ca2cbbed5f24" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy_ReadOnly</a><gulong> Gnome::Gda::Holder::property_g_type </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's GType. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="acf9fa13b87d337a21ab736e8e89614e8"></a><!-- doxytag: member="Gnome::Gda::Holder::property_id" ref="acf9fa13b87d337a21ab736e8e89614e8" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_id </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's ID. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a8dba4c1207852ddaa9a1e92a5bdcd9ea"></a><!-- doxytag: member="Gnome::Gda::Holder::property_id" ref="a8dba4c1207852ddaa9a1e92a5bdcd9ea" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_id </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's ID. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a802d89be45ddb4455894aeec6dfcfc2c"></a><!-- doxytag: member="Gnome::Gda::Holder::property_name" ref="a802d89be45ddb4455894aeec6dfcfc2c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_name </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's name. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a897c03b691f15e09eede622e9609f85c"></a><!-- doxytag: member="Gnome::Gda::Holder::property_name" ref="a897c03b691f15e09eede622e9609f85c" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::ustring</a>> Gnome::Gda::Holder::property_name </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Holder's name. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aeaf03b8f0268a014490a3a35916aaef2"></a><!-- doxytag: member="Gnome::Gda::Holder::property_not_null" ref="aeaf03b8f0268a014490a3a35916aaef2" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy</a><bool> Gnome::Gda::Holder::property_not_null </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Can the value holder be NULL?. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a37f555cd2bced6cc40df39accbe81597"></a><!-- doxytag: member="Gnome::Gda::Holder::property_not_null" ref="a37f555cd2bced6cc40df39accbe81597" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy_ReadOnly</a><bool> Gnome::Gda::Holder::property_not_null </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Can the value holder be NULL?. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a9c5910e4ddac682cd01c44e7f17d7e8a"></a><!-- doxytag: member="Gnome::Gda::Holder::property_simple_bind" ref="a9c5910e4ddac682cd01c44e7f17d7e8a" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> > Gnome::Gda::Holder::property_simple_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Make value holder follow other GdaHolder's changes. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a256784dbf6c0fcf12748a9733c3847a8"></a><!-- doxytag: member="Gnome::Gda::Holder::property_simple_bind" ref="a256784dbf6c0fcf12748a9733c3847a8" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Holder</a>> > Gnome::Gda::Holder::property_simple_bind </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Make value holder follow other GdaHolder's changes. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a029dc461eef4f7a403d03c512ab3b9b6"></a><!-- doxytag: member="Gnome::Gda::Holder::property_source_column" ref="a029dc461eef4f7a403d03c512ab3b9b6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy</a><int> Gnome::Gda::Holder::property_source_column </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classGnome_1_1Gda_1_1Column.html" title="Management of DataModel column attributes.">Column</a> number to use in coordination with the source-model property. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="ac22098f16f36e6625fd5b0621dc23e99"></a><!-- doxytag: member="Gnome::Gda::Holder::property_source_column" ref="ac22098f16f36e6625fd5b0621dc23e99" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::PropertyProxy_ReadOnly</a><int> Gnome::Gda::Holder::property_source_column </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classGnome_1_1Gda_1_1Column.html" title="Management of DataModel column attributes.">Column</a> number to use in coordination with the source-model property. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a7aa01c16931aee1116a7dbe98ec38500"></a><!-- doxytag: member="Gnome::Gda::Holder::property_source_model" ref="a7aa01c16931aee1116a7dbe98ec38500" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >DataModel</a>> > Gnome::Gda::Holder::property_source_model </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Data model among which the holder's value should be. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="aff18f95824a66824249c71750313d5be"></a><!-- doxytag: member="Gnome::Gda::Holder::property_source_model" ref="aff18f95824a66824249c71750313d5be" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >DataModel</a>> > Gnome::Gda::Holder::property_source_model </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Data model among which the holder's value should be. </p>
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
</div>
</div>
<a class="anchor" id="a4178f1d24a1ec14a33d08296ce466201"></a><!-- doxytag: member="Gnome::Gda::Holder::set_attribute" ref="a4178f1d24a1ec14a33d08296ce466201" args="(const Glib::ustring &attribute, const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Gda::Holder::set_attribute </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >Glib::ustring</a> & </td>
<td class="paramname"><em>attribute</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ac23053c0f77127a13e67a48fe34f7f3d"></a><!-- doxytag: member="Gnome::Gda::Holder::set_bind" ref="ac23053c0f77127a13e67a48fe34f7f3d" args="(const Glib::RefPtr< Holder > &bind_to)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Gda::Holder::set_bind </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >Holder</a> >& </td>
<td class="paramname"><em>bind_to</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets <em>holder</em> to change when <em>bind_to</em> changes (and does not make <em>bind_to</em> change when <em>holder</em> changes). </p>
<p>For the operation to succeed, the GType of <em>holder</em> and <em>bind_to</em> must be the same, with the exception that any of them can have a Gda::TYPE_<tt>0 type (in this situation, the GType of the two <a class="el" href="classGnome_1_1Gda_1_1Holder.html" title="Container for a single Gda::Value.">Gda::Holder</a> objects involved is set to match the other when any of them sets its type to something different than GDA_TYPE_<code>0</code>).</p>
<p>If <em>bind_to</em> is <code>0</code>, then <em>holder</em> will not be bound anymore. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">bind_to</td><td>A <a class="el" href="classGnome_1_1Gda_1_1Holder.html" title="Container for a single Gda::Value.">Gda::Holder</a> or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="a24940e0d9ddaaf567f7984171930d463"></a><!-- doxytag: member="Gnome::Gda::Holder::set_default_value" ref="a24940e0d9ddaaf567f7984171930d463" args="(const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Gda::Holder::set_default_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the default value within the holder. </p>
<p>If <em>value</em> is <code>0</code> then <em>holder</em> won't have a default value anymore. To set a default value to <code>0</code>, then pass a <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">Value</a> created using gda_value_new_null().</p>
<p>NOTE: the default value does not need to be of the same type as the one required by <em>holder</em>. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>A value to set the holder's default value, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ab35be6133133f4488c40f9a620e82e18"></a><!-- doxytag: member="Gnome::Gda::Holder::set_not_null" ref="ab35be6133133f4488c40f9a620e82e18" args="(bool not_null=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gnome::Gda::Holder::set_not_null </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"><em>not_null</em> = <code>true</code></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets if the holder can have a <code>0</code> value. </p>
<p>If <em>not_null</em> is <code>true</code>, then that won't be allowed </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">not_null</td><td><code>true</code> if <em>holder</em> should not accept <code>0</code> values. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ae9ee5ad1d5ba7aacc5675eefd67fe271"></a><!-- doxytag: member="Gnome::Gda::Holder::set_source_model" ref="ae9ee5ad1d5ba7aacc5675eefd67fe271" args="(const Glib::RefPtr< DataModel > &model, int col)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::set_source_model </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >DataModel</a> >& </td>
<td class="paramname"><em>model</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>col</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets an hint that <em>holder's</em> values should be restricted among the values contained in the <em>col</em> column of the <em>model</em> data model. </p>
<p>Note that this is just a hint, meaning this policy is not enforced by <em>holder's</em> implementation. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">model</td><td>A <a class="el" href="classGnome_1_1Gda_1_1DataModel.html" title="Abstract DataModel (Base class for all DataModels).">Gda::DataModel</a> object or <code>0</code>. </td></tr>
<tr><td class="paramname">col</td><td>The reference column in <em>model</em>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if no error occurred. </dd></dl>
</div>
</div>
<a class="anchor" id="a64ad49fcadb2d6748a444892b097f128"></a><!-- doxytag: member="Gnome::Gda::Holder::set_value" ref="a64ad49fcadb2d6748a444892b097f128" args="(const ValueType &value)" -->
<div class="memitem">
<div class="memproto">
<div class="memtemplate">
template <class ValueType > </div>
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::set_value </td>
<td>(</td>
<td class="paramtype">const ValueType & </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a8063525e34d29eeca710f6a4990194c4"></a><!-- doxytag: member="Gnome::Gda::Holder::set_value_as_value" ref="a8063525e34d29eeca710f6a4990194c4" args="(const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::set_value_as_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the value within the holder. </p>
<p>If <em>holder</em> is an alias for another holder, then the value is also set for that other holder.</p>
<p>On success, the action of any call to <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a87df6cd27006f5c799f14e3e48fa1f91" title="Forces a holder to be invalid; to set it valid again, a new value must be assigned to it using set_va...">force_invalid()</a> is cancelled as soon as this method is called (even if <em>holder's</em> value does not actually change)</p>
<p>If the value is not different from the one already contained within <em>holder</em>, then <em>holder</em> is not changed and no signal is emitted.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>the <em>value</em> argument is treated the same way if it is <code>0</code> or if it is a Gda::TYPE_<tt>0 value</dd>
<dd>
if <em>holder</em> can't accept the <em>value</em> value, then this method returns <code>false</code>, and <em>holder</em> will be left in an invalid state.</dd>
<dd>
before the change is accepted by <em>holder</em>, the "validate-change" signal will be emitted (the value of which can prevent the change from happening) which can be connected to to have a greater control of which values <em>holder</em> can have, or implement some business rules. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>A value to set the holder to, or <code>0</code>. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if value has been set. </dd></dl>
</div>
</div>
<a class="anchor" id="a3d9e7e8fd2a115cd01111fcc4d31d5a3"></a><!-- doxytag: member="Gnome::Gda::Holder::set_value_str" ref="a3d9e7e8fd2a115cd01111fcc4d31d5a3" args="(const Glib::RefPtr< DataHandler > &dh, const Glib::ustring &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::set_value_str </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" >DataHandler</a> >& </td>
<td class="paramname"><em>dh</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" >Glib::ustring</a> & </td>
<td class="paramname"><em>value</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Same functionality as <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a64ad49fcadb2d6748a444892b097f128">set_value()</a> except that it uses a string representation of the value to set, which will be converted into a GValue first (using default data handler if <em>dh</em> is <code>0</code>). </p>
<dl class="note"><dt><b>Note:</b></dt><dd>if <em>value</em> is <code>0</code> or is the "<tt>0</tt>" string, then <em>holder's</em> value is set to <code>0</code>. </dd>
<dd>
if <em>holder</em> can't accept the <em>value</em> value, then this method returns <code>false</code>, and <em>holder</em> will be left in an invalid state. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dh</td><td>A <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html" title="Base class which provides data handling capabilities.">Gda::DataHandler</a> to use, or <code>0</code>. </td></tr>
<tr><td class="paramname">value</td><td>A value to set the holder to, as a string. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if value has been set. </dd></dl>
</div>
</div>
<a class="anchor" id="a89bf918cba4702b862105ca6d010a17b"></a><!-- doxytag: member="Gnome::Gda::Holder::set_value_to_default" ref="a89bf918cba4702b862105ca6d010a17b" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::set_value_to_default </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p><a class="el" href="classGnome_1_1Gda_1_1Set.html" title="Container for several values.">Set</a> <em>holder's</em> value to its default value. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>holder</em> has got a default value. </dd></dl>
</div>
</div>
<a class="anchor" id="ab8da2dcd2bea4e797bd511ff3969f7db"></a><!-- doxytag: member="Gnome::Gda::Holder::signal_attribute_changed" ref="ab8da2dcd2bea4e797bd511ff3969f7db" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Value</a>& > Gnome::Gda::Holder::signal_attribute_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_attribute_changed(const <a class="elRef" >Value</a>& value)</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a2d669ac6a8dca91a06bc6bada9d4362c"></a><!-- doxytag: member="Gnome::Gda::Holder::signal_changed" ref="a2d669ac6a8dca91a06bc6bada9d4362c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::SignalProxy0</a>< void > Gnome::Gda::Holder::signal_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_changed()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a48e83a06d694f2a1617cff9ef8e13b4c"></a><!-- doxytag: member="Gnome::Gda::Holder::signal_source_changed" ref="a48e83a06d694f2a1617cff9ef8e13b4c" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Glib::SignalProxy0</a>< void > Gnome::Gda::Holder::signal_source_changed </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_source_changed()</code> </dd></dl>
</div>
</div>
<a class="anchor" id="a7ab86e7d5c8ca011fd4168a906d9fc7e"></a><!-- doxytag: member="Gnome::Gda::Holder::signal_validate_change" ref="a7ab86e7d5c8ca011fd4168a906d9fc7e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Value</a>& > Gnome::Gda::Holder::signal_validate_change </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="user"><dt><b>Prototype:</b></dt><dd><code><a class="elRef" >Value</a>& value)</code> </dd></dl>
</div>
</div>
<a class="anchor" id="af46c921837245a870733ae518df9d18e"></a><!-- doxytag: member="Gnome::Gda::Holder::take_static_value" ref="af46c921837245a870733ae518df9d18e" args="(const Value &value, bool &value_changed)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a> Gnome::Gda::Holder::take_static_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool & </td>
<td class="paramname"><em>value_changed</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the const value within the holder. </p>
<p>If <em>holder</em> is an alias for another holder, then the value is also set for that other holder.</p>
<p>The value will not be freed, and user should take care of it, either for its freeing or for its correct value at the moment of query.</p>
<p>If the value is not different from the one already contained within <em>holder</em>, then <em>holder</em> is not changed and no signal is emitted.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>if <em>holder</em> can't accept the <em>value</em> value, then this method returns <code>0</code>, and <em>holder</em> will be left in an invalid state.</dd>
<dd>
before the change is accepted by <em>holder</em>, the "validate-change" signal will be emitted (the value of which can prevent the change from happening) which can be connected to to have a greater control of which values <em>holder</em> can have, or implement some business rules. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>A const value to set the holder to. </td></tr>
<tr><td class="paramname">value_changed</td><td>A boolean set with <code>true</code> if the value changes, <code>false</code> elsewhere. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>0</code> if an error occurred or if the previous GValue was <code>0</code> itself. It returns the static GValue user set previously, so that he can free it. </dd></dl>
</div>
</div>
<a class="anchor" id="a8a2ef486bf9c9f855e67b9ad7781653c"></a><!-- doxytag: member="Gnome::Gda::Holder::take_value" ref="a8a2ef486bf9c9f855e67b9ad7781653c" args="(const Value &value)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::take_value </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>& </td>
<td class="paramname"><em>value</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets the value within the holder. </p>
<p>If <em>holder</em> is an alias for another holder, then the value is also set for that other holder.</p>
<p>On success, the action of any call to <a class="el" href="classGnome_1_1Gda_1_1Holder.html#a87df6cd27006f5c799f14e3e48fa1f91" title="Forces a holder to be invalid; to set it valid again, a new value must be assigned to it using set_va...">force_invalid()</a> is cancelled as soon as this method is called (even if <em>holder's</em> value does not actually change).</p>
<p>If the value is not different from the one already contained within <em>holder</em>, then <em>holder</em> is not changed and no signal is emitted.</p>
<dl class="note"><dt><b>Note:</b></dt><dd>if <em>holder</em> can't accept the <em>value</em> value, then this method returns <code>false</code>, and <em>holder</em> will be left in an invalid state.</dd>
<dd>
before the change is accepted by <em>holder</em>, the "validate-change" signal will be emitted (the value of which can prevent the change from happening) which can be connected to to have a greater control of which values <em>holder</em> can have, or implement some business rules.</dd>
<dd>
if user previously set this holder with <a class="el" href="classGnome_1_1Gda_1_1Holder.html#af46c921837245a870733ae518df9d18e" title="Sets the const value within the holder.">take_static_value()</a> the GValue stored internally will be forgiven and replaced by the <em>value</em>. User should then take care of the 'old' static GValue. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">value</td><td>A value to set the holder to. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if value has been set. </dd></dl>
</div>
</div>
<a class="anchor" id="a745821514d06a35016b9768f4c2d77bb"></a><!-- doxytag: member="Gnome::Gda::Holder::value_is_default" ref="a745821514d06a35016b9768f4c2d77bb" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gnome::Gda::Holder::value_is_default </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tells if <em>holder's</em> current value is the default one. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if <em>holder</em> <em>holder's</em> current value is the default one. </dd></dl>
</div>
</div>
<hr/><h2>Friends And Related Function Documentation</h2>
<a class="anchor" id="a121dc2074183cb5c10b80d27ae8d3433"></a><!-- doxytag: member="Gnome::Gda::Holder::wrap" ref="a121dc2074183cb5c10b80d27ae8d3433" args="(GdaHolder *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" >Gnome::Gda::Holder</a> > wrap </td>
<td>(</td>
<td class="paramtype">GdaHolder * </td>
<td class="paramname"><em>object</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>A <a class="elRef" >Glib::wrap()</a> method for this object. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li>libgdamm/holder.h</li>
</ul>
</div>
<hr class="footer"/><address class="footer"><small>
Generated on Sun Nov 20 2011 22:38:13 for libgdamm by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.7.5.1-20110925
</small></address>
</body>
</html>
