Constructor
GcrFilterCollectionnew_with_callback
Declaration [src]
GcrCollection*
gcr_filter_collection_new_with_callback (
GcrCollection* underlying,
GcrFilterCollectionFunc callback,
gpointer user_data,
GDestroyNotify destroy_func
)
Description [src]
Create a new GcrFilterCollection.
The callback should return TRUE if an object should appear in the
filtered collection.
If a NULL callback is set, then all underlynig objects will appear in the
filtered collection.
Parameters
underlying-
Type:
GcrCollectionThe underlying collection.
The data is owned by the caller of the function. callback-
Type:
GcrFilterCollectionFuncFunction to call for each object.
The argument can be NULL. user_data-
Type:
gpointerData to pass to the callback.
The argument can be NULL.The data is owned by the caller of the function. destroy_func-
Type:
GDestroyNotifyCalled for user_data when it is no longer needed.
Return value
Type: GcrFilterCollection
A newly allocated filtered collection, which should be freed with g_object_unref().
| The caller of the function takes ownership of the data, and is responsible for freeing it. |