take_user_tags


Description:

[ Version ( since = "3.24" ) ]
public virtual bool take_user_tags (owned NameValueArray? user_tags)

Takes all the user_tags, which replaces any current user tags on the this.

The passed-in user_tags is consumed by the this, which becomes an owner of it. The caller should not change user_tags afterwards.

If the this changed, the 'dirty' flag and the 'folder-flagged' flag are set automatically, unless the this is aborting notifications. There is also emitted folder's "changed" signal for this this, 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.

Parameters:

this

a MessageInfo

user_tags

user tags to set

Returns:

Whether the this changed.