Set

---

Object Hierarchy:

Description:

Content:

Properties:

• public string description { owned get; set; }
• public void* holders { construct; }
• public string id { owned get; set; }
• public string name { owned get; set; }
• public bool validate_changes { get; set; }
  Defines if the "validate-set" signal gets emitted when any holder in the data set changes.

Static methods:

• public static Quark error_quark ()

Creation methods:

• public Set (SList<Holder> holders)
  Creates a new Set object, and populates it with the list given as argument.
• public Set.from_spec_node (unowned Node* xml_spec) throws Error
  Creates a new Set object from the xml_spec specifications
• public Set.from_spec_string (string xml_spec) throws Error
  Creates a new Set object from the xml_spec specifications
• public Set.read_only (SList<Holder> holders)
  Creates a new Set like Set, but does not allow modifications to any of the Holder object in holders.

Methods:

• public bool add_holder (Holder holder)
  Adds holder to the list of holders managed within this.
• public Set copy ()
  Creates a new Set object, copy of this
• public unowned SetGroup get_group (Holder holder)
  Finds a SetGroup which lists a SetNode containing holder, don't modify the returned structure.
• public unowned SList<SetGroup> get_groups ()
• public unowned Holder get_holder (string holder_id)
  Finds a Holder using its ID
• public unowned Value? get_holder_value (string holder_id)
  Get the value of the Holder which ID is holder_id
• public unowned SList<Holder> get_holders ()
• public unowned SetNode get_node (Holder holder)
  Finds a SetNode holding information for holder, don't modify the returned structure
• public unowned SList<SetNode> get_nodes ()
• public unowned Holder get_nth_holder (int pos)
  Finds a Holder using its position
• public unowned SetSource get_source (Holder holder)
  Finds a SetSource which contains the DataModel restricting the possible values of holder, don't modify the returned structure.
• public unowned SetSource get_source_for_model (DataModel model)
  Finds the SetSource structure used in this for which model is a the data model (the returned structure should not be modified).
• public unowned SList<SetSource> get_sources ()
• public bool is_valid () throws Error
  This method tells if all this's 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 an error.
• public void merge_with_set (Set set_to_merge)
  Add to this all the holders of set_to_merge.
• public void remove_holder (Holder holder)
  Removes a Holder from the list of holders managed by this
• public void replace_source_model (SetSource source, DataModel model)
  Replaces source->data_model with model, which must have the same characteristics as source->data_model (same column types)

Signals:

• public virtual signal void holder_attr_changed (Holder holder, string attr_name, Value attr_value)
  Gets emitted when an attribute for any of the Holder objects managed by set has changed
• public virtual signal void holder_changed (Holder holder)
• public virtual signal void holder_type_set (Holder holder)
  Gets emitted when holder in set has its type finally set, in case it was GDA_TYPE_NULL
• public virtual signal void public_data_changed ()
  Gets emitted when set's public data ( SetNode, SetGroup or SetSource values) have changed
• public virtual signal void source_model_changed (void* source)
  Gets emitted when the data model in source has changed
• public virtual signal Error validate_holder_change (Holder holder, Value new_value)
  Gets emitted when a Holder 's in set is going to change its value.
• public virtual signal Error validate_set ()
  Gets emitted when is_valid is called, use this signal to control which combination of values set's holder can have (for example to implement some business rules)

Inherited Members: