Virtual Method

CamelMessageInfotake_user_tags

since: 3.24

Declaration [src]

gboolean
take_user_tags (
  CamelMessageInfo* mi,
  CamelNameValueArray* user_tags
)

Description [src]

Takes all the user_tags, which replaces any current user tags on the mi. The passed-in user_tags is consumed by the mi, which becomes an owner of it. The caller should not change user_tags afterwards.

If the mi changed, the ‘dirty’ flag and the ‘folder-flagged’ flag are set automatically, unless the mi is aborting notifications. There is also emitted folder’s “changed” signal for this mi, if necessary.

Note that it’s not safe to use the user_tags after the call to this function, because it can be freed due to no change.

Available since: 3.24

Parameters

user_tags

Type: CamelNameValueArray

User tags to set.

The argument can be NULL.
The instance takes ownership of the data, and is responsible for freeing it.

Return value

Type: gboolean

Whether the mi changed.