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.

Since

S60 3.1