MCLFSortingStyle Class Reference
Sorting style for Content Listing Framework. This class can be used to define primary and secondary sorting styles for Content Listing Framework list model. Sorting styles are used to sort the list model. Secondary sorting style is used to sort items that could not be sorted by the primary sorting style. In other words, items that do not have the field defined by primary or any previous secondary sorting style, the items are sorted using the next secondary sorting style. When a secondary sorting style is appended, it becomes the least significant sorting style until a new one is added after it. Items with undefined fields are placed before or after items with defined fields, depending on the undefined field position setting in
MCLFSortingStyle. Usage:
// Create a sorting style instance
MCLFSortingStyle* sortingStyle = ContentListingFactory::NewSortingStyleLC();
// Set sort ordering
sortingStyle->SetOrdering( ECLFOrderingDescending );
// Set undefied item position. Undefined items are items that doesn't
// have field that is defined in sorting style fields
sortingStyle->SetUndefinedItemPosition( ECLFSortingStyleUndefinedEnd );
// All sorting style parameter fields are string type
sortingStyle->SetSortingDataType( ECLFItemDataTypeDesC );
// Set default sorting parameter
sortingStyle->AddFieldL( ECLFFieldIdSongName );
// Set secondary sorting parameter
sortingStyle->AddFieldL( ECLFFieldIdFileName );
// If item doesn't have ECLFFieldIdSongName field then
// ECLFFieldIdFileName field is used to sort item.
ContentListingFramework.lib
- Since
- S60 3.1
Private Member Functions |
---|
MCLFSortingStyleExt * | Extension() |
Constructor & Destructor Documentation
~MCLFSortingStyle()
~MCLFSortingStyle | ( | ) | [inline, virtual] |
Member Functions Documentation
AddFieldL(TCLFFieldId)
Add new field to the sorting style. First added field will be the default field. Remember to set type of field(s) with SetSortingDataType. Fields that are some other type will be ignored. See TCLFDefaultFieldId in CLFContentListing.hrh
- Since
- S60 3.1
Extension()
MCLFSortingStyleExt * | Extension | ( | ) | [private, inline, virtual] |
GetFieldsL(RArray< TCLFFieldId > &)
Get IDs of fields that have been set to the sorting style.
- Since
- S60 3.1
Ordering()
Get current sort ordering of the sorting style.
- Since
- S60 3.1
ResetL()
void | ResetL | ( | ) | [pure virtual] |
Reset settings of the sorting style to default.
- Since
- S60 3.1
SetOrdering(TCLFSortingStyleOrdering)
Set sort ordering. Ordering can be ascending or descending. See TCLFSortingStyleOrdering
- Since
- S60 3.1
SetSortingDataType(TCLFItemDataType)
Set data type of sorting parameter fields. Data type can be text, time or number. See TCLFItemDataType
- Since
- S60 3.1
SetUndefinedItemPosition(TCLFUndefinedItemPosition)
Set undefined item position. Items not having information for defined sorting parameter fields are placed to top or bottom of the model. See TCLFUndefinedItemPosition
- Since
- S60 3.1
SortingDataType()
Get current sorting data type of fields.
- Since
- S60 3.1
UndefinedItemPosition()
Get current position of undefined items.
- Since
- S60 3.1
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.