| class CPosLmTextCriteria : public CPosLmSearchCriteria |
Criterion for searching for landmarks which contain a certain text.
The search is defined by providing a text to search for and the position fields and text attributes to search.
If no attributes are specified for the search, all text attributes in the landmarks are searched. If no position fields are specified, then all fields are searched.
If this criterion is passed to CPosLandmarkSearch::StartLandmarkSearchL , only landmarks which contain the specified text are returned.
Wild-card characters are supported.
This criterion is only valid when searching for landmarks, i.e. if it is passed to CPosLandmarkSearch::StartCategorySearchL, the function will fail with error code KErrArgument.
| Public Member Functions | |
|---|---|
| ~CPosLmTextCriteria() | |
| IMPORT_C CPosLandmark::TAttributes | AttributesToSearch() |
| IMPORT_C void | ClearPositionFieldsToSearch() |
| IMPORT_C void | GetPositionFieldsToSearchL(RArray< TUint > &) |
| IMPORT_C CPosLmTextCriteria * | NewLC() |
| IMPORT_C void | SetAttributesToSearch(CPosLandmark::TAttributes) |
| IMPORT_C void | SetPositionFieldsToSearchL(const RArray< TUint > &) |
| IMPORT_C void | SetTextL(const TDesC &) |
| IMPORT_C TPtrC | Text() |
| Private Member Functions | |
|---|---|
| CPosLmTextCriteria() | |
| CPosLmTextCriteria(const CPosLmTextCriteria &) | |
| void | ConstructL() |
| CPosLmTextCriteria & | operator=(const CPosLmTextCriteria &) |
| Inherited Enumerations | |
|---|---|
| CPosLmSearchCriteria:TCriteriaType | |
| Private Attributes | |
|---|---|
| CPosLandmark::TAttributes | iAttributes |
| RArray< TUint > | iPositionFieldArray |
| HBufC * | iText |
| CPosLmTextCriteria | ( | const CPosLmTextCriteria & | ) | [private] |
| const CPosLmTextCriteria & |
| IMPORT_C CPosLandmark::TAttributes | AttributesToSearch | ( | ) | const |
Retrieves the landmark attributes which should be searched.
This function returns a bitmap of landmark attributes. The landmark attributes are defined by CPosLandmark::_TAttributes. It is only possible to search the ELandmarkName and EDescription attributes.
| IMPORT_C void | ClearPositionFieldsToSearch | ( | ) |
Clears the position fields list used in a search.
| IMPORT_C void | GetPositionFieldsToSearchL | ( | RArray< TUint > & | aFieldArray | ) | const |
Retrieves a list of the position fields to search.
| IMPORT_C void | SetAttributesToSearch | ( | CPosLandmark::TAttributes | aAttributes | ) |
Sets which landmark attributes to search.
The client passes a bitmap of the landmark attributes to search. It is only possible to search the ELandmarkName and EDescription attributes.
| CPosLandmark::TAttributes aAttributes | A bitmap indicating which landmark attributes should be searched. |
| IMPORT_C void | SetPositionFieldsToSearchL | ( | const RArray< TUint > & | aFieldArray | ) |
Sets the position fields to search.
Any previously set position fields are cleared by this call.
| IMPORT_C void | SetTextL | ( | const TDesC & | aText | ) |
Sets the search string.
A non-empty text string must be set, otherwise CPosLandmarkSearch::StartLandmarkSearchL will leave with error code KErrArgument.
The search is case insensitive.
Wild-card characters "?" and "*" are supported in the search string. "?" matches a single occurrence of any character and "*" matches zero or more consecutive occurrences of any characters.
A landmark matches the criterion if specified text is found anywhere in selected attributes or position fields.
| const TDesC & aText | The text to search for. |
| CPosLmTextCriteria & | operator= | ( | const CPosLmTextCriteria & | ) | [private] |
| const CPosLmTextCriteria & |
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.