Akonadi::MessageStatus
#include <messagestatus.h>
Properties | |
bool | hasAttachment |
bool | hasError |
bool | hasInvitation |
bool | isDeleted |
bool | isEncrypted |
bool | isForwarded |
bool | isHam |
bool | isIgnored |
bool | isImportant |
bool | isOfUnknownStatus |
bool | isQueued |
bool | isRead |
bool | isReplied |
bool | isSent |
bool | isSigned |
bool | isSpam |
bool | isToAct |
bool | isWatched |
Public Member Functions | |
MessageStatus () | |
void | clear () |
void | fromQInt32 (qint32 status) |
bool | hasAttachment () const |
bool | hasError () const |
bool | hasInvitation () const |
bool | isDeleted () const |
bool | isEncrypted () const |
bool | isForwarded () const |
bool | isHam () const |
bool | isIgnored () const |
bool | isImportant () const |
bool | isOfUnknownStatus () const |
bool | isQueued () const |
bool | isRead () const |
bool | isReplied () const |
bool | isSent () const |
bool | isSigned () const |
bool | isSpam () const |
bool | isToAct () const |
bool | isWatched () const |
bool | operator!= (MessageStatus other) const |
bool | operator& (MessageStatus other) const |
bool | operator== (MessageStatus other) const |
void | set (MessageStatus other) |
void | setDeleted (bool deleted=true) |
void | setEncrypted (bool value=true) |
void | setForwarded (bool forwarded=true) |
void | setHam (bool ham=true) |
void | setHasAttachment (bool hasAttachment=true) |
void | setHasError (bool value=true) |
void | setHasInvitation (bool hasInvitation=true) |
void | setIgnored (bool ignored=true) |
void | setImportant (bool important=true) |
void | setQueued (bool queued=true) |
void | setRead (bool read=true) |
void | setReplied (bool replied=true) |
void | setSent (bool sent=true) |
void | setSigned (bool value=true) |
void | setSpam (bool spam=true) |
void | setStatusFromFlags (const QSet< QByteArray > &flags) |
void | setStatusFromStr (const QString &aStr) |
void | setToAct (bool toAct=true) |
void | setWatched (bool watched=true) |
QSet< QByteArray > | statusFlags () const |
QString | statusStr () const |
void | toggle (MessageStatus other) |
qint32 | toQInt32 () const |
Static Public Member Functions | |
static const MessageStatus | statusDeleted () |
static const MessageStatus | statusEncrypted () |
static const MessageStatus | statusForwarded () |
static const MessageStatus | statusHam () |
static const MessageStatus | statusHasAttachment () |
static const MessageStatus | statusHasError () |
static const MessageStatus | statusHasInvitation () |
static const MessageStatus | statusIgnored () |
static const MessageStatus | statusImportant () |
static const MessageStatus | statusQueued () |
static const MessageStatus | statusRead () |
static const MessageStatus | statusReplied () |
static const MessageStatus | statusSent () |
static const MessageStatus | statusSigned () |
static const MessageStatus | statusSpam () |
static const MessageStatus | statusToAct () |
static const MessageStatus | statusUnread () |
static const MessageStatus | statusWatched () |
Detailed Description
Akonadi KMime Message Status.
The class encapsulates the handling of the different flags which describe the status of a message. The flags themselves are not intended to be used outside this class.
In the status pairs Watched/Ignored and Spam/Ham, there both values can't be set at the same time, however they can be unset at the same time.
Note that this class does not sync with the Akonadi storage. It is used as an in-memory helper when manipulating Akonadi items.
- Since
- 4.6.
Definition at line 37 of file messagestatus.h.
Property Documentation
◆ hasAttachment
|
readwrite |
Definition at line 53 of file messagestatus.h.
◆ hasError
|
readwrite |
Definition at line 57 of file messagestatus.h.
◆ hasInvitation
|
readwrite |
Definition at line 54 of file messagestatus.h.
◆ isDeleted
|
readwrite |
Definition at line 42 of file messagestatus.h.
◆ isEncrypted
|
readwrite |
Definition at line 55 of file messagestatus.h.
◆ isForwarded
|
readwrite |
Definition at line 44 of file messagestatus.h.
◆ isHam
|
readwrite |
Definition at line 51 of file messagestatus.h.
◆ isIgnored
|
readwrite |
Definition at line 49 of file messagestatus.h.
◆ isImportant
|
readwrite |
Definition at line 47 of file messagestatus.h.
◆ isOfUnknownStatus
|
read |
Definition at line 40 of file messagestatus.h.
◆ isQueued
|
readwrite |
Definition at line 45 of file messagestatus.h.
◆ isRead
|
readwrite |
Definition at line 41 of file messagestatus.h.
◆ isReplied
|
readwrite |
Definition at line 43 of file messagestatus.h.
◆ isSent
|
readwrite |
Definition at line 46 of file messagestatus.h.
◆ isSigned
|
readwrite |
Definition at line 56 of file messagestatus.h.
◆ isSpam
|
readwrite |
Definition at line 50 of file messagestatus.h.
◆ isToAct
|
readwrite |
Definition at line 52 of file messagestatus.h.
◆ isWatched
|
readwrite |
Definition at line 48 of file messagestatus.h.
Constructor & Destructor Documentation
◆ MessageStatus()
Akonadi::MessageStatus::MessageStatus | ( | ) |
Constructor - sets status initially to unknown.
Definition at line 44 of file messagestatus.cpp.
Member Function Documentation
◆ clear()
void Akonadi::MessageStatus::clear | ( | ) |
Clear all status flags, this resets to unknown.
Definition at line 72 of file messagestatus.cpp.
◆ fromQInt32()
void Akonadi::MessageStatus::fromQInt32 | ( | qint32 | status | ) |
Set the status as a whole e.g.
for reading from an index. Don't manipulte the index via this value, this bypasses all integrity checks in the setter methods.
- Parameters
-
status The status encoded in bits to be set in this instance.
Definition at line 448 of file messagestatus.cpp.
◆ hasAttachment()
|
nodiscard |
Check for Attachment status.
- Returns
- true if status indicates an attachment.
Definition at line 258 of file messagestatus.cpp.
◆ hasError()
|
nodiscard |
Check for error status.
- Returns
- true if status indicates an error.
Definition at line 278 of file messagestatus.cpp.
◆ hasInvitation()
|
nodiscard |
Check for Invitation status.
- Returns
- true if status indicates an invitation.
Definition at line 263 of file messagestatus.cpp.
◆ isDeleted()
|
nodiscard |
Check for Deleted status.
- Returns
- true if status is deleted.
Definition at line 203 of file messagestatus.cpp.
◆ isEncrypted()
|
nodiscard |
Check for Encrypted status.
- Returns
- true if status is encrypted.
Definition at line 273 of file messagestatus.cpp.
◆ isForwarded()
|
nodiscard |
Check for Forwarded status.
- Returns
- true if status is forwarded.
Definition at line 213 of file messagestatus.cpp.
◆ isHam()
|
nodiscard |
Check for Ham status.
- Returns
- true if status is not spam.
Definition at line 253 of file messagestatus.cpp.
◆ isIgnored()
|
nodiscard |
Check for Ignored status.
- Returns
- true if status is ignored.
Definition at line 238 of file messagestatus.cpp.
◆ isImportant()
|
nodiscard |
Check for Important status.
- Returns
- true if status is important.
Definition at line 228 of file messagestatus.cpp.
◆ isOfUnknownStatus()
|
nodiscard |
Check for Unknown status.
- Returns
- true if status is unknown.
Definition at line 193 of file messagestatus.cpp.
◆ isQueued()
|
nodiscard |
Check for Queued status.
- Returns
- true if status is queued.
Definition at line 218 of file messagestatus.cpp.
◆ isRead()
|
nodiscard |
Check for Read status.
Note that ignored messages are read.
- Returns
- true if status is read.
Definition at line 198 of file messagestatus.cpp.
◆ isReplied()
|
nodiscard |
Check for Replied status.
- Returns
- true if status is replied.
Definition at line 208 of file messagestatus.cpp.
◆ isSent()
|
nodiscard |
Check for Sent status.
- Returns
- true if status is sent.
Definition at line 223 of file messagestatus.cpp.
◆ isSigned()
|
nodiscard |
Check for Signed status.
- Returns
- true if status is signed.
Definition at line 268 of file messagestatus.cpp.
◆ isSpam()
|
nodiscard |
Check for Spam status.
- Returns
- true if status is spam.
Definition at line 248 of file messagestatus.cpp.
◆ isToAct()
|
nodiscard |
Check for ToAct status.
- Returns
- true if status is action item.
Definition at line 243 of file messagestatus.cpp.
◆ isWatched()
|
nodiscard |
Check for Watched status.
- Returns
- true if status is watched.
Definition at line 233 of file messagestatus.cpp.
◆ operator!=()
bool Akonadi::MessageStatus::operator!= | ( | Akonadi::MessageStatus | other | ) | const |
Compare the status with that from another instance.
- Returns
- true if the stati are equal, false if different.
- Parameters
-
other message status to compare with current object
Definition at line 54 of file messagestatus.cpp.
◆ operator&()
bool Akonadi::MessageStatus::operator& | ( | Akonadi::MessageStatus | other | ) | const |
Check, if some of the flags in the status match with those flags from another instance.
- Returns
- true if at least one flag is set in both stati.
- Parameters
-
other message status to compare objects' flags
Definition at line 59 of file messagestatus.cpp.
◆ operator==()
bool Akonadi::MessageStatus::operator== | ( | Akonadi::MessageStatus | other | ) | const |
Compare the status with that from another instance.
- Returns
- true if the stati are equal, false if different.
- Parameters
-
other message status to compare with current object
Definition at line 49 of file messagestatus.cpp.
◆ set()
void Akonadi::MessageStatus::set | ( | Akonadi::MessageStatus | other | ) |
Set / add stati described by another MessageStatus object.
This can be used to merge in multiple stati at once without using the single setter methods. However, internally the setters are used anyway to ensure the integrity of the resulting status.
- Parameters
-
other message status to set
Definition at line 77 of file messagestatus.cpp.
◆ setDeleted()
void Akonadi::MessageStatus::setDeleted | ( | bool | deleted = true | ) |
Set the status for deleted.
- Parameters
-
deleted Set (true) or unset (false) this status flag.
Definition at line 292 of file messagestatus.cpp.
◆ setEncrypted()
void Akonadi::MessageStatus::setEncrypted | ( | bool | value = true | ) |
Set the status to encrypted.
- Parameters
-
value Set (true) or unset (false) this status flag.
Definition at line 425 of file messagestatus.cpp.
◆ setForwarded()
void Akonadi::MessageStatus::setForwarded | ( | bool | forwarded = true | ) |
Set the status for forwarded.
- Parameters
-
forwarded Set (true) or unset (false) this status flag.
Definition at line 310 of file messagestatus.cpp.
◆ setHam()
void Akonadi::MessageStatus::setHam | ( | bool | ham = true | ) |
Set the status to not spam.
- Parameters
-
ham Set (true) or unset (false) this status flag.
Definition at line 388 of file messagestatus.cpp.
◆ setHasAttachment()
void Akonadi::MessageStatus::setHasAttachment | ( | bool | hasAttachment = true | ) |
Set the status for an attachment.
- Parameters
-
hasAttachment Set (true) or unset (false) this status flag.
Definition at line 398 of file messagestatus.cpp.
◆ setHasError()
void Akonadi::MessageStatus::setHasError | ( | bool | value = true | ) |
Set the status to error.
- Parameters
-
value Set (true) or unset (false) this status flag.
Definition at line 434 of file messagestatus.cpp.
◆ setHasInvitation()
void Akonadi::MessageStatus::setHasInvitation | ( | bool | hasInvitation = true | ) |
Set the status for an invitation.
- Parameters
-
hasInvitation Set (true) or unset (false) this status flag.
Definition at line 407 of file messagestatus.cpp.
◆ setIgnored()
void Akonadi::MessageStatus::setIgnored | ( | bool | ignored = true | ) |
Set the status to ignored.
- Parameters
-
ignored Set (true) or unset (false) this status flag.
Definition at line 358 of file messagestatus.cpp.
◆ setImportant()
void Akonadi::MessageStatus::setImportant | ( | bool | important = true | ) |
Set the status for important.
- Parameters
-
important Set (true) or unset (false) this status flag.
Definition at line 338 of file messagestatus.cpp.
◆ setQueued()
void Akonadi::MessageStatus::setQueued | ( | bool | queued = true | ) |
Set the status for queued.
- Parameters
-
queued Set (true) or unset (false) this status flag.
Definition at line 319 of file messagestatus.cpp.
◆ setRead()
void Akonadi::MessageStatus::setRead | ( | bool | read = true | ) |
Set the status to read.
- Parameters
-
read new read status
Definition at line 283 of file messagestatus.cpp.
◆ setReplied()
void Akonadi::MessageStatus::setReplied | ( | bool | replied = true | ) |
Set the status for replied.
- Parameters
-
replied Set (true) or unset (false) this status flag.
Definition at line 301 of file messagestatus.cpp.
◆ setSent()
void Akonadi::MessageStatus::setSent | ( | bool | sent = true | ) |
Set the status for sent.
- Parameters
-
sent Set (true) or unset (false) this status flag.
Definition at line 328 of file messagestatus.cpp.
◆ setSigned()
void Akonadi::MessageStatus::setSigned | ( | bool | value = true | ) |
Set the status to signed.
- Parameters
-
value Set (true) or unset (false) this status flag.
Definition at line 416 of file messagestatus.cpp.
◆ setSpam()
void Akonadi::MessageStatus::setSpam | ( | bool | spam = true | ) |
Set the status to spam.
- Parameters
-
spam Set (true) or unset (false) this status flag.
Definition at line 378 of file messagestatus.cpp.
◆ setStatusFromFlags()
void Akonadi::MessageStatus::setStatusFromFlags | ( | const QSet< QByteArray > & | flags | ) |
Set the status as a whole e.g.
for reading from IMAP flags.
- Parameters
-
flags set of flags for status as a whole
Definition at line 617 of file messagestatus.cpp.
◆ setStatusFromStr()
void Akonadi::MessageStatus::setStatusFromStr | ( | const QString & | aStr | ) |
Set the status based on a string representation.
- Parameters
-
aStr The status string to be analyzed. Normally it is a string obtained using getStatusStr().
- Note
- This code is legacy for the KMail1 indexes
Definition at line 501 of file messagestatus.cpp.
◆ setToAct()
void Akonadi::MessageStatus::setToAct | ( | bool | toAct = true | ) |
Set the status to action item.
- Parameters
-
toAct Set (true) or unset (false) this status flag.
Definition at line 368 of file messagestatus.cpp.
◆ setWatched()
void Akonadi::MessageStatus::setWatched | ( | bool | watched = true | ) |
Set the status to watched.
- Parameters
-
watched Set (true) or unset (false) this status flag.
Definition at line 348 of file messagestatus.cpp.
◆ statusDeleted()
|
static |
Return a predefined status initialized as Deleted as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Deleted.
Definition at line 679 of file messagestatus.cpp.
◆ statusEncrypted()
|
static |
Return a predefined status initialized as Encrypted as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Encrypted.
Definition at line 777 of file messagestatus.cpp.
◆ statusFlags()
|
nodiscard |
Get the status as a whole e.g.
for storage as IMAP flags.
- Returns
- The status encoded in flags.
Definition at line 552 of file messagestatus.cpp.
◆ statusForwarded()
|
static |
Return a predefined status initialized as Forwarded as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Forwarded.
Definition at line 693 of file messagestatus.cpp.
◆ statusHam()
|
static |
Return a predefined status initialized as Ham as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Ham.
Definition at line 749 of file messagestatus.cpp.
◆ statusHasAttachment()
|
static |
Return a predefined status initialized as Attachment as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Attachment.
Definition at line 756 of file messagestatus.cpp.
◆ statusHasError()
|
static |
Return a predefined status initialized as Error as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Error.
Definition at line 784 of file messagestatus.cpp.
◆ statusHasInvitation()
|
static |
Return a predefined status initialized as Invitation as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Invitation.
Definition at line 763 of file messagestatus.cpp.
◆ statusIgnored()
|
static |
Return a predefined status initialized as Ignored as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Ignored.
Definition at line 728 of file messagestatus.cpp.
◆ statusImportant()
|
static |
Return a predefined status initialized as Important as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Important.
Definition at line 714 of file messagestatus.cpp.
◆ statusQueued()
|
static |
Return a predefined status initialized as Queued as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Queued.
Definition at line 700 of file messagestatus.cpp.
◆ statusRead()
|
static |
Return a predefined status initialized as Read as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Read.
Definition at line 672 of file messagestatus.cpp.
◆ statusReplied()
|
static |
Return a predefined status initialized as Replied as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Replied.
Definition at line 686 of file messagestatus.cpp.
◆ statusSent()
|
static |
Return a predefined status initialized as Sent as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Sent.
Definition at line 707 of file messagestatus.cpp.
◆ statusSigned()
|
static |
Return a predefined status initialized as Signed as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Signed.
Definition at line 770 of file messagestatus.cpp.
◆ statusSpam()
|
static |
Return a predefined status initialized as Spam as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Spam.
Definition at line 742 of file messagestatus.cpp.
◆ statusStr()
|
nodiscard |
Convert the status to a string representation.
- Returns
- A string containing coded uppercase letters which describe the status.
- Note
- This code is legacy for the KMail1 indexes
Definition at line 453 of file messagestatus.cpp.
◆ statusToAct()
|
static |
Return a predefined status initialized as Action Item as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as ToAct.
Definition at line 735 of file messagestatus.cpp.
◆ statusUnread()
|
static |
Return a special status that expresses Unread.
This status can only be used for comparison with other states.
Definition at line 665 of file messagestatus.cpp.
◆ statusWatched()
|
static |
Return a predefined status initialized as Watched as is useful e.g.
when providing a state for comparison.
- Returns
- A reference to a status instance initialized as Watched.
Definition at line 721 of file messagestatus.cpp.
◆ toggle()
void Akonadi::MessageStatus::toggle | ( | Akonadi::MessageStatus | other | ) |
Toggle one or more stati described by another MessageStatus object.
Internally the setters are used to ensure the integrity of the resulting status.
- Parameters
-
other message status to toggle
Definition at line 138 of file messagestatus.cpp.
◆ toQInt32()
|
nodiscard |
Get the status as a whole e.g.
for storage in an index. D on't manipulte the *index via this value, this bypasses all integrity checks in the setter methods.
- Returns
- The status encoded in bits.
Definition at line 443 of file messagestatus.cpp.
The documentation for this class was generated from the following files:
Documentation copyright © 1996-2024 The KDE developers.
Generated on Mon Nov 4 2024 16:32:40 by doxygen 1.12.0 written by Dimitri van Heesch, © 1997-2006
KDE's Doxygen guidelines are available online.