take_user_flags


Description:

[ Version ( since = "3.24" ) ]
public virtual bool take_user_flags (owned NamedFlags? user_flags)

Takes all the user_flags, which replaces any current user flags on the this.

The passed-in user_flags is consumed by the this, which becomes an owner of it. The caller should not change user_flags 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_flags after the call to this function, because it can be freed due to no change.

Parameters:

this

a MessageInfo

user_flags

user flags to set

Returns:

Whether the message info changed.