<!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> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <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.1.3</span></div> </td> </tr> </tbody> </table> </div> <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"> <h1>Gnome::Gda::Holder Class Reference<div class="ingroups"><a class="el" href="group__DataHandlers.html">Data Handlers</a></div></h1> </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="#_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" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="31,166,121,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="16,86,136,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="23,6,129,37"/></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" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="31,166,121,197"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="16,86,136,117"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="23,6,129,37"/></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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ab60ce4410f8f1dc896006f0c84c1bae8">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a72c54bd4e6c3d3052d7a2fc9cc99d034">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a036ae8e94d6f71a9a944ae78f3160508">get_value_str</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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#ad13f9171336b1a5f625fdd1f4f3f6a69">set_value</a> (const ValueType&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">DataHandler</a> >& dh, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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#ad13f9171336b1a5f625fdd1f4f3f6a69">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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& attribute, const <a class="el" href="classGnome_1_1Gda_1_1Value.html">Value</a>&<a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">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#ad13f9171336b1a5f625fdd1f4f3f6a69">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a265590f1aed75d56d1ebcb784ea8a7c0">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 colu...">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae3a5c81bdc5f953c7e14479b2f3a948d">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 colu...">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8ba0326fcf95deb370743a7736d949fb">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ae7739037be994307f1552b53933bc09b">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a87966f82759a5501336a56d25d529cfd">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#abe67baa53fe0f9e5cec60e5c0fc5c863">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#acd35047d792e04b22c8b92f7b5f51f5b">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#aebae539a1dbf093bf5b425deac47677f">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< gulong > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a7fc31f638cfccf1e800e767a5167bff5">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < 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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#acf9fa13b87d337a21ab736e8e89614e8">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a8dba4c1207852ddaa9a1e92a5bdcd9ea">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a802d89be45ddb4455894aeec6dfcfc2c">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a897c03b691f15e09eede622e9609f85c">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#aeaf03b8f0268a014490a3a35916aaef2">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < 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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a9c5910e4ddac682cd01c44e7f17d7e8a">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a256784dbf6c0fcf12748a9733c3847a8">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a029dc461eef4f7a403d03c512ab3b9b6">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#ac22098f16f36e6625fd5b0621dc23e99">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a7aa01c16931aee1116a7dbe98ec38500">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">DataModel</a> > > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#aff18f95824a66824249c71750313d5be">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a2d669ac6a8dca91a06bc6bada9d4362c">signal_changed</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">Glib::SignalProxy0</a>< void > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a48e83a06d694f2a1617cff9ef8e13b4c">signal_source_changed</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a><br class="typebreak"/> < <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html">Glib::Error</a>, const <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#a7ab86e7d5c8ca011fd4168a906d9fc7e">signal_validate_change</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy2.html">Glib::SignalProxy2</a>< void, <br class="typebreak"/> const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> &, const <br class="typebreak"/> <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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Holder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a6a75fb3690b303f8757f77888e7a5810">create</a> (GType g_type, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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 colspan="2">(Note that these are not member functions.) <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">Gnome::Gda::Holder</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGnome_1_1Gda_1_1Holder.html#a121dc2074183cb5c10b80d27ae8d3433">wrap</a> (GdaHolder* object, bool take_copy=false)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a121dc2074183cb5c10b80d27ae8d3433"></a><br/></td></tr> </table> <hr/><a name="_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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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#ad13f9171336b1a5f625fdd1f4f3f6a69">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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 colu...">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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 colu...">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gnome::Gda::Holder::get_value_str </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a778a94181132976bbfb0519793f3b32e">Glib::ObjectBase</a>.</p> </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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html#a4c6efc18be8cb9c56e58fc0bd20fafbe">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1Holder.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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="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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataModel.html">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="ad13f9171336b1a5f625fdd1f4f3f6a69"></a><!-- doxytag: member="Gnome::Gda::Holder::set_value" ref="ad13f9171336b1a5f625fdd1f4f3f6a69" 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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1DataHandler.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">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#ad13f9171336b1a5f625fdd1f4f3f6a69">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy2.html">Glib::SignalProxy2</a>< void,const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>&,const <a class="el" href="classGnome_1_1Gda_1_1Value.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& attr_name, const <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy0.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html">Glib::Error</a>,const <a class="el" href="classGnome_1_1Gda_1_1Value.html">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1Error.html">Glib::Error</a> on_my_validate_change(const <a class="el" href="classGnome_1_1Gda_1_1Value.html" title="Use value_type() to identify the value type at runtime.">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" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGnome_1_1Gda_1_1Holder.html">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" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">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 Thu Sep 22 2011 11:20:03 for libgdamm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address> </body> </html>