| class CPosLmDisplayData : public CBase |
Displayable data collection.
A displayable data collection consists of displayable items (CPosLmDisplayItem ). A displayable data collection either consists of landmark items (if a landmark search has been started) or category items (if a category search has been started). Items of different types cannot be mixed in the collection.
Displayable data is used in CPosLandmarkSearch and CPosLmMultiDbSearch to hold search results. The collection is populated with new results every time the next search step is executed. Displayable items contain full or partial (see CPosLandmarkDatabase::SetPartialReadParameters ) landmark data or full category data, and can be used to display search results already during the search and also after it has completed.
Note: The single class instance may only be used by one search instance at a time.
| Public Member Functions | |
|---|---|
| ~CPosLmDisplayData() | |
| IMPORT_C TInt | Count() |
| IMPORT_C CPosLmDisplayItem & | DisplayItem(TInt) |
| RPointerArray< CPosLmDisplayItem > & | DisplayItems() |
| RPointerArray< CPosLmDisplayItem > & | NewDisplayItems() |
| IMPORT_C TInt | NewItemIndex() |
| IMPORT_C CPosLmDisplayData * | NewL() |
| CPosLmPartialReadParameters * | PartialReadParameters() |
| IMPORT_C void | Reset() |
| IMPORT_C void | SetPartialReadParametersL(const CPosLmPartialReadParameters &) |
| IMPORT_C void | UnsetPartialReadParameters() |
| Private Member Functions | |
|---|---|
| CPosLmDisplayData() | |
| Private Attributes | |
|---|---|
| RPointerArray< CPosLmDisplayItem > | iDisplayItems |
| RPointerArray< CPosLmDisplayItem > | iNewDisplayItems |
| CPosLmPartialReadParameters * | iPartialParameters |
| IMPORT_C CPosLmDisplayItem & | DisplayItem | ( | TInt | aItemIndex | ) | const |
Returns the displayable item specified by index. The index must be strictly less than Count and not less than 0.
| TInt aItemIndex | A displayable item index. |
| IMPORT_C TInt | NewItemIndex | ( | ) |
Returns the index of the next match found during current asynchronous search operation. If the search is executed synchronously, then all indexes of the matches found during the search are returned one by one.
After each search step, the new item indexes are returned in ascending order according to the specified sort preference in the search.
| IMPORT_C void | SetPartialReadParametersL | ( | const CPosLmPartialReadParameters & | aPartialSettings | ) |
Sets the partial read parameters for this display data.
Partial read parameters are used to define which landmark data should be read during a landmark search. If no partial read parameters are set, the whole landmark will be read.
This function only affects the searches which are started after it is called. The current search is not affected.
If landmarks are sorted by name, the name will always be a part of the landmark in the display data, even if it is not requested.
Note: Partial read parameters are only used for landmark searches.
| const CPosLmPartialReadParameters & aPartialSettings | The partial read parameters. |
| IMPORT_C void | UnsetPartialReadParameters | ( | ) |
Unsets the partial read parameters for this display data.
This means that from now on all landmarks added to this display data instance will contain all information.
To have any affect, this function must be called before a search is started. If it is called during a search, it will only affect the next search.
Note: Partial read parameters will only have effect on landmarks searches.
| RPointerArray< CPosLmDisplayItem > | iDisplayItems | [private] |
| RPointerArray< CPosLmDisplayItem > | iNewDisplayItems | [private] |
| CPosLmPartialReadParameters * | iPartialParameters | [private] |
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.