libgdamm Reference Documentation |
Public Member Functions | |
void | add_holder (const Glib::RefPtr<Holder>& holder) |
Adds holder to the list of holders managed within set. | |
Glib::RefPtr<Set> | copy () |
Creates a new Gda::Set object, opy of set. | |
SetGroup* | get_group (const Glib::RefPtr<Holder>& holder) |
Finds a Gda::SetGroup which lists a Gda::SetNode containing holder, don't modify the returned structure. | |
Glib::RefPtr<Holder> | get_holder (const Glib::ustring& holder_id) |
Finds a Gda::Holder using its ID. | |
Value | get_holder_value (const Glib::ustring& holder_id) |
Get the value of the Gda::Holder which ID is holder_id. | |
SetNode* | get_node (const Glib::RefPtr<Holder>& holder) |
Finds a Gda::SetNode holding information for holder, don't modify the returned structure. | |
SetSource* | get_source (const Glib::RefPtr<Holder>& holder) |
Finds a Gda::SetSource which contains the Gda::DataModel restricting the possible values of holder, don't modify the returned structure. | |
SetSource* | get_source_for_model (const Glib::RefPtr<DataModel>& model) |
Finds the Gda::SetSource structure used in set for which model is a the data model, don't modify the returned structure. | |
const GdaSet* | gobj () const |
Provides access to the underlying C GObject. | |
GdaSet* | gobj () |
Provides access to the underlying C GObject. | |
GdaSet* | gobj_copy () |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. | |
bool | is_valid () const |
This method tells if all set's Gda::Holder objects are valid, and if they represent a valid combination of values, as defined by rules external to Libgda: the "validate-set" signal is emitted and if none of the signal handlers return an error, then the returned value is true , otherwise the return value is false as soon as a signal handler Returns: true if the set is valid. | |
void | merge_with_set (const Glib::RefPtr<Set>& set_to_merge) |
Add to set all the holders of set_to_merge. | |
Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_description () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy <Glib::ustring> | property_description () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_id () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy <Glib::ustring> | property_id () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy_ReadOnly <Glib::ustring> | property_name () const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
Glib::PropertyProxy <Glib::ustring> | property_name () |
You rarely need to use properties because there are get_ and set_ methods for almost all of them. | |
void | remove_holder (const Glib::RefPtr<Holder>& holder) |
template<class T> | |
bool | set_holder_value (const Glib::ustring& holder_id, T value) |
Set the value of the Gda::Holder which ID is holder_id to a specified value. | |
Glib::SignalProxy3< void, const Glib::RefPtr<Holder> &, Glib::ustring, Value > | signal_holder_attr_changed () |
Glib::SignalProxy1< void, const Glib::RefPtr<Holder >&> | signal_holder_changed () |
Glib::SignalProxy0<void> | signal_public_data_changed () |
Glib::SignalProxy2< Error, const Glib::RefPtr<Holder> &, Value > | signal_validate_holder_change () |
Glib::SignalProxy0<Error> | signal_validate_set () |
virtual | ~Set () |
Static Public Member Functions | |
static Glib::RefPtr<Set> | create (const HolderSList& holders) |
Protected Member Functions | |
virtual void | on_holder_changed (const Glib::RefPtr<Holder>& holder) |
virtual void | on_public_data_changed () |
Set (const HolderSList& holders) | |
Related Functions | |
(Note that these are not member functions.) | |
Glib::RefPtr<Gnome::Gda::Set> | wrap (GdaSet* object, bool take_copy=false) |
A Glib::wrap() method for this object. |
The Gda::Set object is a container for several values (as Gda::Holder objects), which also offers different classifications of the group of GdaHolder values (see get_node(), get_source() or get_group()). It is possible to control the values a Gda::Holder can have in the Gda::Set by connecting to the signal_before_holder_change() signal.
virtual Gnome::Gda::Set::~Set | ( | ) | [virtual] |
Gnome::Gda::Set::Set | ( | const HolderSList & | holders | ) | [explicit, protected] |
void Gnome::Gda::Set::add_holder | ( | const Glib::RefPtr<Holder>& | holder | ) |
Adds holder to the list of holders managed within set.
NOTE: if set already has a Gda::Holder with the same ID as holder, then holder will not be added to the set (even if holder's type or value is not the same as the one already in set).
holder | A Gda::Holder object. |
true
if holder has been added to set (and false
if it has not been added because there is another Gda::Holder with the same ID). Glib::RefPtr<Set> Gnome::Gda::Set::copy | ( | ) |
static Glib::RefPtr<Set> Gnome::Gda::Set::create | ( | const HolderSList & | holders | ) | [static] |
SetGroup* Gnome::Gda::Set::get_group | ( | const Glib::RefPtr<Holder>& | holder | ) |
Finds a Gda::SetGroup which lists a Gda::SetNode containing holder, don't modify the returned structure.
holder | A Gda::Holder object. |
0
. Glib::RefPtr<Holder> Gnome::Gda::Set::get_holder | ( | const Glib::ustring & | holder_id | ) |
Finds a Gda::Holder using its ID.
holder_id | The ID of the requested value holder. |
0
. Value Gnome::Gda::Set::get_holder_value | ( | const Glib::ustring & | holder_id | ) |
Get the value of the Gda::Holder which ID is holder_id.
holder_id | The ID of the holder to set the value. |
0
(see Gda::Holder::get_value()). SetNode* Gnome::Gda::Set::get_node | ( | const Glib::RefPtr<Holder>& | holder | ) |
Finds a Gda::SetNode holding information for holder, don't modify the returned structure.
holder | A Gda::Holder object. |
0
. SetSource* Gnome::Gda::Set::get_source | ( | const Glib::RefPtr<Holder>& | holder | ) |
Finds a Gda::SetSource which contains the Gda::DataModel restricting the possible values of holder, don't modify the returned structure.
holder | A Gda::Holder object. |
0
. SetSource* Gnome::Gda::Set::get_source_for_model | ( | const Glib::RefPtr<DataModel>& | model | ) |
Finds the Gda::SetSource structure used in set for which model is a the data model, don't modify the returned structure.
model | A Gda::DataModel object. |
0
. const GdaSet* Gnome::Gda::Set::gobj | ( | ) | const [inline] |
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
Reimplemented in Gnome::Gda::DataModelIter.
GdaSet* Gnome::Gda::Set::gobj | ( | ) | [inline] |
Provides access to the underlying C GObject.
Reimplemented from Glib::ObjectBase.
Reimplemented in Gnome::Gda::DataModelIter.
GdaSet* Gnome::Gda::Set::gobj_copy | ( | ) |
Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs.
Reimplemented in Gnome::Gda::DataModelIter.
bool Gnome::Gda::Set::is_valid | ( | ) | const |
This method tells if all set's Gda::Holder objects are valid, and if they represent a valid combination of values, as defined by rules external to Libgda: the "validate-set" signal is emitted and if none of the signal handlers return an error, then the returned value is true
, otherwise the return value is false
as soon as a signal handler Returns: true
if the set is valid.
true
if the set is valid. Reimplemented in Gnome::Gda::DataModelIter.
void Gnome::Gda::Set::merge_with_set | ( | const Glib::RefPtr<Set>& | set_to_merge | ) |
Add to set all the holders of set_to_merge.
all the Gda::Holder merged in set are still used by set_to_merge.
set_to_merge | A Gda::Set object. |
virtual void Gnome::Gda::Set::on_holder_changed | ( | const Glib::RefPtr<Holder>& | holder | ) | [protected, virtual] |
virtual void Gnome::Gda::Set::on_public_data_changed | ( | ) | [protected, virtual] |
Glib::PropertyProxy_ReadOnly<Glib::ustring> Gnome::Gda::Set::property_description | ( | ) | const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<Glib::ustring> Gnome::Gda::Set::property_description | ( | ) |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<Glib::ustring> Gnome::Gda::Set::property_id | ( | ) | const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<Glib::ustring> Gnome::Gda::Set::property_id | ( | ) |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy_ReadOnly<Glib::ustring> Gnome::Gda::Set::property_name | ( | ) | const |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
Glib::PropertyProxy<Glib::ustring> Gnome::Gda::Set::property_name | ( | ) |
You rarely need to use properties because there are get_ and set_ methods for almost all of them.
void Gnome::Gda::Set::remove_holder | ( | const Glib::RefPtr<Holder>& | holder | ) |
bool Gnome::Gda::Set::set_holder_value | ( | const Glib::ustring & | holder_id, | |
T | value | |||
) | [inline] |
Set the value of the Gda::Holder which ID is holder_id to a specified value.
holder_id | The ID of the holder to set the value. | |
Varargs | Value, of the correct type, depending on the requested holder's type (not 0 ). |
true
if no error occurred and the value was set correctly. Glib::SignalProxy3<void,const Glib::RefPtr<Holder>&,Glib::ustring,Value> Gnome::Gda::Set::signal_holder_attr_changed | ( | ) |
void on_my_holder_attr_changed(const Glib::RefPtr<Holder>& holder, Glib::ustring attr_name, Value value)
Glib::SignalProxy1<void,const Glib::RefPtr<Holder>&> Gnome::Gda::Set::signal_holder_changed | ( | ) |
void on_my_holder_changed(const Glib::RefPtr<Holder>& holder)
Glib::SignalProxy0< void > Gnome::Gda::Set::signal_public_data_changed | ( | ) |
void on_my_public_data_changed()
Glib::SignalProxy2<Error,const Glib::RefPtr<Holder>&,Value> Gnome::Gda::Set::signal_validate_holder_change | ( | ) |
Glib::SignalProxy0<Error> Gnome::Gda::Set::signal_validate_set | ( | ) |
Error on_my_validate_set()
Glib::RefPtr<Gnome::Gda::Set> wrap | ( | GdaSet * | object, | |
bool | take_copy = false | |||
) | [related] |
A Glib::wrap() method for this object.
object | The C instance. | |
take_copy | False if the result should take ownership of the C instance. True if it should take a new copy or ref. |