CPosLmCategoryCriteria Class Reference

#include <mw/EPos_CPosLmCategoryCriteria.h>

Link against: eposlmsearchlib.lib

class CPosLmCategoryCriteria : public CPosLmSearchCriteria

Inherits from

Detailed Description

Criterion used for searching for landmarks which belong to a certain category.

A category has an ID in the database and it has also a unique name. There are also some global categories which are known by all databases. It is possible to specify either a local category in a specific landmark database, a global category or the name of the category. If one is set, the others are reset and not used.

It is also possible to search for uncategorized landmarks, i.e. landmarks which do not contain any categories. If neither item ID, global ID nor name are set, then CPosLandmarkSearch::StartLandmarkSearchL will search for uncategorized landmarks.

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.

Since
S60 3.0

Constructor & Destructor Documentation

~CPosLmCategoryCriteria ( )

~CPosLmCategoryCriteria()[virtual]

Destructor.

Member Function Documentation

CategoryItemId ( )

IMPORT_C TPosLmItemIdCategoryItemId()const

Returns the item ID of the category which should be used as landmark search criterion.

Returns: The item ID of the category or KPosLmNullItemId if not set.

CategoryName ( )

IMPORT_C TPtrCCategoryName()const

Returns the name of the category which should be used as landmark search criterion.

Returns: The category name or empty descriptor if not set.

GlobalCategory ( )

IMPORT_C TPosLmGlobalCategoryGlobalCategory()const

Returns the global category which should be used as landmark search criterion.

Returns: The global category or KPosLmNullGlobalCategory if not set.

NewLC ( )

IMPORT_C CPosLmCategoryCriteria *NewLC()[static]

Two-phased constructor.

Returns: A new instance of this class.

SetCategoryItemId ( TPosLmItemId )

IMPORT_C voidSetCategoryItemId(TPosLmItemIdaItemId)

Sets the item ID of the category which should be used as landmark search criterion.

Passing KPosLmNullItemId means uncategorized landmarks search.

ParameterDescription
aItemIdThe item ID of the category.

SetCategoryNameL ( const TDesC & )

IMPORT_C voidSetCategoryNameL(const TDesC &aCategoryName)

Sets the name of the category which should be used as landmark search criterion.

The exact category name must be specified. Wild-card characters are not used as such, they will be considered as ordinary characters. It is possible to use CPosLmCatNameCriteria to list categories which match a category name pattern containing wild-card characters.

The matching is case sensitive.

An empty descriptor means uncategorized landmarks search.

leave
KErrArgument The category name is longer than KPosLmMaxCategoryNameLength.
ParameterDescription
aCategoryNameThe category name.

SetGlobalCategory ( TPosLmGlobalCategory )

IMPORT_C voidSetGlobalCategory(TPosLmGlobalCategoryaGlobalCategory)

Sets the global category which should be used as landmark search criterion.

Passing KPosLmNullGlobalCategory means uncategorized landmarks search.

ParameterDescription
aGlobalCategoryThe global category.