TPosLmDatabaseSettings Class Reference

#include <mw/EPos_TPosLmDatabaseSettings.h>

Link against: eposlmdbmanlib.lib

class TPosLmDatabaseSettings
Public Member Enumerations
enumTAttribute { EName }
Public Member Functions
TPosLmDatabaseSettings()
IMPORT_C TPtrCDatabaseName()
IMPORT_C TBoolIsAttributeSet(TAttribute)
IMPORT_C voidSetDatabaseName(const TPosLmDatabaseName &)
IMPORT_C voidUnsetAttribute(TAttribute)

Detailed Description

TPosLmDatabaseSettings encapsulates the attributes that can be set for a landmark database.

The only available attribute is the displayable name.

To set a new display name, create a HPosLmDatabaseInfo object containing the URI of the database. Call SetDatabaseName on the TPosLmDatabaseSettings member in HPosLmDatabaseInfo and then pass the HPosLmDatabaseInfo to CPosLmDatabaseManager::ModifyDatabaseSettingsL .

When retrieving settings for a database, IsAttributeSet can be used to find out whether display name is set for the database or not.

Since
S60 3.0

Member Enumeration Documentation

Enum TAttribute

Enumeration of the attributes that can be set for a landmark database.

EnumeratorValueDescription
EName0x01

Displayable name for the landmark database

Constructor & Destructor Documentation

TPosLmDatabaseSettings ( )

IMPORT_CTPosLmDatabaseSettings()

Default constructor.

Member Function Documentation

DatabaseName ( )

IMPORT_C TPtrCDatabaseName()const

Retrieves the displayable name for the database.

If the EName attribute is not set, an empty descriptor is returned.

Returns: A pointer to the name descriptor. This pointer is valid until the TPosLmDatabaseSettings instance is destroyed.

IsAttributeSet ( TAttribute )

IMPORT_C TBoolIsAttributeSet(TAttributeaDbAttribute)const

Checks whether a database attribute is set in this instance.

ParameterDescription
aDbAttributeThe database attribute to check.

Returns: ETrue if the attribute is set, otherwise EFalse.

SetDatabaseName ( const TPosLmDatabaseName & )

IMPORT_C voidSetDatabaseName(const TPosLmDatabaseName &aDatabaseName)

Set a displayable name for the database.

If an empty descriptor is set, the database display name will be set to an empty string.

ParameterDescription
aDatabaseNameThe new name for the database.

UnsetAttribute ( TAttribute )

IMPORT_C voidUnsetAttribute(TAttributeaDbAttribute)

Unset a database attribute.

If an attribute is not set in this instance and the instance is passed as input to a function for modifying the settings for a database, e.g. CPosLmDatabaseManager::ModifyDatabaseSettingsL , the attribute will be removed from the database.

ParameterDescription
aDbAttributeThe database attribute to unset.