/**
* gimp_tagged_container_get_tag_count:
* @container: a #GimpTaggedContainer object.
*
* Get number of distinct tags that are currently assigned to all
* objects in the container. The count is independent of currently
* used filter, it is provided for all available objects (ie. empty
* filter).
*
* Return value: number of distinct tags assigned to all objects in the
* container.
**/
gint
gimp_tagged_container_get_tag_count (GimpTaggedContainer *container)
{
g_return_val_if_fail (GIMP_IS_TAGGED_CONTAINER (container), 0);
return container->tag_count;
}
/**
* gimp_tagged_container_set_filter:
* @tagged_container: a #GimpTaggedContainer object.
* @tags: list of #GimpTag objects.
*
* Sets list of tags to be used for filtering. Only objects which have
* all of the tags assigned match filtering criteria.
**/
void
gimp_tagged_container_set_filter (GimpTaggedContainer *tagged_container,
GList *tags)
{
GList *new_filter;
g_return_if_fail (GIMP_IS_TAGGED_CONTAINER (tagged_container));
if (tags)
{
GList *list;
for (list = tags; list; list = g_list_next (list))
g_return_if_fail (list->data == NULL || GIMP_IS_TAG (list->data));
}
if (! gimp_container_frozen (GIMP_FILTERED_CONTAINER (tagged_container)->src_container))
{
gimp_tagged_container_src_freeze (GIMP_FILTERED_CONTAINER (tagged_container));
}
/* ref new tags first, they could be the same as the old ones */
new_filter = g_list_copy (tags);
g_list_foreach (new_filter, (GFunc) gimp_tag_or_null_ref, NULL);
g_list_free_full (tagged_container->filter,
(GDestroyNotify) gimp_tag_or_null_unref);
tagged_container->filter = new_filter;
if (! gimp_container_frozen (GIMP_FILTERED_CONTAINER (tagged_container)->src_container))
{
gimp_tagged_container_src_thaw (GIMP_FILTERED_CONTAINER (tagged_container));
}
}
/**
* gimp_tagged_container_get_filter:
* @tagged_container: a #GimpTaggedContainer object.
*
* Returns current tag filter. Tag filter is a list of GimpTag objects, which
* must be contained by each object matching filter criteria.
*
* Return value: a list of GimpTag objects used as filter. This value should
* not be modified or freed.
**/
const GList *
gimp_tagged_container_get_filter (GimpTaggedContainer *tagged_container)
{
g_return_val_if_fail (GIMP_IS_TAGGED_CONTAINER (tagged_container), NULL);
return tagged_container->filter;
}
/**
* gimp_combo_tag_entry_new:
* @container: a tagged container to be used.
* @mode: tag entry mode to work in.
*
* Creates a new #GimpComboTagEntry widget which extends #GimpTagEntry by
* adding ability to pick tags using popup window (similar to combo box).
*
* Return value: a new #GimpComboTagEntry widget.
**/
GtkWidget *
gimp_combo_tag_entry_new (GimpTaggedContainer *container,
GimpTagEntryMode mode)
{
g_return_val_if_fail (GIMP_IS_TAGGED_CONTAINER (container), NULL);
return g_object_new (GIMP_TYPE_COMBO_TAG_ENTRY,
"container", container,
"mode", mode,
NULL);
}
