Class
PurpleTags
unstable since: 3.0
Description [src]
final class Purple.Tags : GObject.Object
{
/* No available fields */
}Tags is an object that can be used to keep track of arbitrary tags on
objects. Tags are simple strings that use the first ‘:’ to delimit a value.
For example: foo is a tag with just a name and no value, but foo:bar is
a tag with a name and value. Also, foo: is still considered a name and
value, but the value is an empty string.
Please note this distinction when the API calls for a name versus a tag which would be the name and the value.
Available since: 3.0
Instance methods
purple_tags_add
Adds tag to tags. If the tag already exists, the existing tag will be replaced.
unstable since: 3.0
purple_tags_add_with_value
Formats name and value into a tag and adds it to tags. If the tag already
exists, the existing tag will be replaced.
unstable since: 3.0
purple_tags_remove
Removes tag from tags. Note that this is the tag name and value not just
the name.
unstable since: 3.0
purple_tags_remove_with_value
A helper function around purple_tags_remove() that builds the tag variable
from name and value.
unstable since: 3.0
purple_tags_to_string
Creates a separator delimited string containing each item in tags.
unstable since: 3.0
Signals
Purple.Tags::added
Emitted when a tag is added. The tag as well as its name and value are provided to be as flexible as possible.
unstable since: 3.0
Purple.Tags::removed
Emitted when a tag is removed. The tag as well as its name and value are provided to be as flexible as possible.
unstable since: 3.0
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.