#include <mw/msvstd.h>
Link against: msgs_autoshutdown.lib
class TMsvSelectionOrdering |
Public Member Functions | |
---|---|
TMsvSelectionOrdering() | |
TMsvSelectionOrdering(TInt, TMsvSorting, TBool) | |
IMPORT_C void | ExternalizeL(RWriteStream &) |
TBool | GroupByMtm() |
TBool | GroupByPriority() |
TBool | GroupByType() |
TBool | GroupStandardFolders() |
TBool | GroupingOn() |
IMPORT_C void | InternalizeL(RReadStream &) |
void | SetGroupByMtm(TBool) |
void | SetGroupByPriority(TBool) |
void | SetGroupByType(TBool) |
void | SetGroupStandardFolders(TBool) |
void | SetShowInvisibleEntries(TBool) |
void | SetSorting(TMsvSorting) |
IMPORT_C void | SetSubjectSkipString(const TDesC &) |
TBool | ShowInvisibleEntries() |
TMsvSorting | Sorting() |
IMPORT_C const TDesC & | SubjectSkipString() |
IMPORT_C TBool | operator==(const TMsvSelectionOrdering &) |
Defines the sorting and grouping rules used to prepare a selection of entries.
It is used in the interfaces of CMsvEntry and CMsvServerEntry to set the ordering of an entry's children.
Firstly, the entries will be grouped, if the appropriate grouping option is set, by:
1. Standard folders: any entries marked as standard folders are placed first, in the order they were created.
2. Entry type: in the order services, folders, messages, attachments, unknown
3. Priority: in the order high, medium, then low
4. MTM: either in the MTM order set by CMsvEntry::SetMtmListL() or just in MTM Uid value
Grouping options are simply Boolean flags that can be set on or off by functions of this class.
Secondly, the order of entries within these groups is defined by a sorting order option.
See also: CMsvEntry CMsvServerEntry
IMPORT_C | TMsvSelectionOrdering | ( | ) |
Default constructor.
Creates a new object with no grouping, and sets the sorting to EMsvSortByNone.
Creates a new object, sets the group, sort order, and show-invisibility options to those specified in the parameters.
Parameters | |
---|---|
aGroupingKey | A bitmask of grouping options. For the values to use, see TMsvGrouping. |
aSorting | Sorting order. |
aShowInvisible | Determines whether invisible entries are included in the selection |
IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream | ) | const |
Writes the object into the specified stream.
Parameters | |
---|---|
aStream | Stream to which to write |
TBool | GroupByPriority | ( | ) | const [inline] |
Gets the group-by-priority flag.
TBool | GroupByType | ( | ) | const [inline] |
Gets the group-by-entry-type flag.
TBool | GroupStandardFolders | ( | ) | const [inline] |
Gets the group-by-standard-folders flag.
TBool | GroupingOn | ( | ) | const [inline] |
Tests whether any grouping option has been set.
IMPORT_C void | InternalizeL | ( | RReadStream & | aStream | ) |
Reads an externalised object from the specified stream.
Parameters | |
---|---|
aStream | Stream from which to read |
void | SetGroupByMtm | ( | TBool | aFlag | ) | [inline] |
void | SetGroupByPriority | ( | TBool | aFlag | ) | [inline] |
void | SetGroupByType | ( | TBool | aFlag | ) | [inline] |
void | SetGroupStandardFolders | ( | TBool | aFlag | ) | [inline] |
void | SetShowInvisibleEntries | ( | TBool | aFlag | ) | [inline] |
void | SetSorting | ( | TMsvSorting | aSortType | ) | [inline] |
IMPORT_C void | SetSubjectSkipString | ( | const TDesC & | aSubjectSkipString | ) |
Set the subject skip string up to maximum length of KMaxSubjectSkipStringLength
Panic Codes | |
---|---|
USER | 11, if the length of the descriptor aSubjectSkipString is greater than KMaxSubjectSkipStringLength (defined in <msvstd.h>) |
TBool | ShowInvisibleEntries | ( | ) | const [inline] |
Gets the show-invisible-entries flag. Entries whose entry visible flag index field is not set are included in the ordered list only if this is set.
TMsvSorting | Sorting | ( | ) | const [inline] |
Gets the sorting order of entries within groups.
IMPORT_C const TDesC & | SubjectSkipString | ( | ) | const |
Get the current subject skip string
IMPORT_C TBool | operator== | ( | const TMsvSelectionOrdering & | aOrdering | ) | const |
Tests two TMsvSelectionOrdering objects for equality.
Two TMsvSelectionOrdering objects are equal if the same grouping and sorting options have been set on each.
Parameters | |
---|---|
aOrdering | The object with which to compare |