|  |  |  | Gcr Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Prerequisites | Known Implementations | Signals | ||||
GcrCollection; guint gcr_collection_get_length (GcrCollection *self); GList * gcr_collection_get_objects (GcrCollection *self); gboolean gcr_collection_contains (GcrCollection *self,GObject *object); void gcr_collection_emit_added (GcrCollection *self,GObject *object); void gcr_collection_emit_removed (GcrCollection *self,GObject *object);
GcrCollection is implemented by GcrFilterCollection, GcrSimpleCollection and GcrUnionCollection.
A GcrCollection is used to group a set of objects. This is an abstract interface which can be used to determine which objects show up in a selector or other user interface element.
Use gcr_simple_collection_new() to create a concrete implementation of this
interface which you can add objects to.
typedef struct _GcrCollection GcrCollection;
A GcrCollection is used to group a set of objects.
guint               gcr_collection_get_length           (GcrCollection *self);
Get the number of objects in this collection.
| 
 | The collection | 
| Returns : | The number of objects. | 
GList *             gcr_collection_get_objects          (GcrCollection *self);
Get a list of the objects in this collection.
| 
 | The collection | 
| Returns : | a list of the objects
in this collection, which should be freed with g_list_free(). [transfer container][element-type GObject.Object] | 
gboolean gcr_collection_contains (GcrCollection *self,GObject *object);
Check whether the collection contains an object or not.
| 
 | the collection | 
| 
 | object to check | 
| Returns : | whether the collection contains this object | 
void gcr_collection_emit_added (GcrCollection *self,GObject *object);
Emit the "added" signal for the given object. This function is used by implementors of this interface.
| 
 | The collection | 
| 
 | The object that was added | 
void gcr_collection_emit_removed (GcrCollection *self,GObject *object);
Emit the "removed" signal for the given object. This function is used by implementors of this interface.
| 
 | The collection | 
| 
 | The object that was removed | 
"added" signalvoid                user_function                      (GcrCollection *self,
                                                        GObject       *object,
                                                        gpointer       user_data)      : Run Last
This signal is emitted when an object is added to the collection.
| 
 | the collection | 
| 
 | object that was added. [type GObject.Object] | 
| 
 | user data set when the signal handler was connected. | 
"removed" signalvoid                user_function                      (GcrCollection *self,
                                                        GObject       *object,
                                                        gpointer       user_data)      : Run Last
This signal is emitted when an object is removed from the collection.
| 
 | the collection | 
| 
 | object that was removed. [type GObject.Object] | 
| 
 | user data set when the signal handler was connected. |