Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: CNTDB.H
Link against: cntmodel.lib

Class CContactTextDef

class CContactTextDef : public CArrayFixFlat< TContactTextDefItem >;

Description

Defines a way of grouping fields to form a string which represents a contact item.

A text definition is implemented as an array of text definition items (TContactTextDefItems).

For example, CContactDatabase::ReadContactTextDefL() uses a text definition to build up a string from a contact item. When creating the string, it searches the item for fields whose type matches one of the fields specified in the text definition. The contents of the first matching field of each type found in the item are read into the string. These strings may be separated using a field separator, which is also specified in the text definition. A separator is not appended to the last field used to make up the string. It is only inserted when there is a following non-empty field.

Additionally, the text definition may also contain a fallback field type. This is used when none of the fields specified in the text definition contain any text. If the item's fallback field contains no text either, or if the fallback field type's value is KUidContactFieldNone, the text is read from the first non-empty field in the item.

A contact database can have a default text definition which is set using CContactDatabase::SetTextDefinitionL(). This may be overridden using the variants of CContactDatabase::ReadContactTextDefL() which take a CContactTextDef* argument.

CContactTextDef is derived from CArrayFixFlat<TContactTextDefItem>, so all relevant functions can be used, e.g. to add and remove elements.

Derivation

Members

Defined in CContactTextDef:
ExactMatchOnly(), FallbackField(), NewL(), NewLC(), SetExactMatchOnly(), SetFallbackField()


Construction and destruction


NewL()

static IMPORT_C CContactTextDef *NewL();

Description

Allocates and constructs a new text definition. The fallback field type is initialised to KUidContactFieldNone.

Return value

CContactTextDef *

Pointer to the newly created text definition.


NewLC()

static IMPORT_C CContactTextDef *NewLC();

Description

Allocates and constructs a new text definition. If the text definition is successfully constructed, it is left on the cleanup stack. The fallback field type is initialised to KUidContactFieldNone.

Return value

CContactTextDef *

Pointer to the newly created text definition.

[Top]


Member functions


SetFallbackField()

IMPORT_C void SetFallbackField(TFieldType iFieldType);

Description

Sets the fallback field type.

Parameters

TFieldType iFieldType

The fallback field type.


FallbackField()

IMPORT_C TFieldType FallbackField() const;

Description

Gets the fallback field type.

Return value

TFieldType

The fallback field type.


ExactMatchOnly()

IMPORT_C TBool ExactMatchOnly();

Description

Gets the exact match for contact fields

Return value

TBool

ETrue if it gets the exact match


SetExactMatchOnly()

IMPORT_C void SetExactMatchOnly(TBool aExactMatchOnly);

Description

Sets the exact match for contact fields

Parameters

TBool aExactMatchOnly

Contains the value for exact match. It takes ETrue when an exact match is required, EFalse otherwise.