CContactTextField Class Reference

#include <app/cntfldst.h>

class CContactTextField : public CContactFieldStorage, public CContactFieldStorage

Inherits from

CContactTextField
- CContactFieldStorage
  - CBase
  - CBase
- CContactFieldStorage
  - CBase
  - CBase

Public Member Functions
	~CContactTextField()
virtual void	ExternalizeL(RWriteStream &)
void	ExternalizeL(RWriteStream &, TBool, TInt)
void	InternalizeL(HBufC *, TInt)
virtual void	InternalizeL(RReadStream &)
virtual TBool	IsFull()
virtual void	RestoreL(CStreamStore &, RReadStream &)
IMPORT_C void	SetStandardTextArray(MDesCArray *)
IMPORT_C void	SetStandardTextArray(MDesC16Array *)
IMPORT_C void	SetStandardTextL(const TDesC &)
IMPORT_C void	SetText(HBufC *)
IMPORT_C void	SetTextArray(MDesCArray *)
IMPORT_C void	SetTextArray(MDesC16Array *)
IMPORT_C void	SetTextL(const TDesC &)
IMPORT_C TPtrC	StandardTextLC()
virtual TStreamId	StoreL(CStreamStore &)
IMPORT_C TPtrC	Text()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Provides access to the text stored in a contact item field.

An object of this class can be retrieved using CContactItemField::TextStorage().

Constructor & Destructor Documentation

~CContactTextField ( )

IMPORT_C

~CContactTextField

(

)

Deletes the text owned by the object, prior to its destruction.

Member Function Documentation

ExternalizeL ( RWriteStream & )

void

ExternalizeL

(

RWriteStream &

aStream

)

const [virtual]

Reimplemented from CContactFieldStorage::ExternalizeL(RWriteStream &)const

Externalises the field data.

Parameters
aStream	Write stream to which the contents of the field should be externalised.

ExternalizeL ( RWriteStream &, TBool, TInt )

void	ExternalizeL	(	RWriteStream &	aStream,
			TBool	aIsInlineBlob,
			TInt	aTextFieldIndex
		)	const

InternalizeL ( HBufC *, TInt )

void	InternalizeL	(	HBufC *	aTextStream,
			TInt	aTextFieldIndex
		)

InternalizeL ( RReadStream & )

void

InternalizeL

(

RReadStream &

aStream

)

[virtual]

Reimplemented from CContactFieldStorage::InternalizeL(RReadStream &)

Internalises the field data.

Parameters
aStream	Stream from which the the contents of the field should be internalised.

IsFull ( )

TBool

IsFull

(

)

const [virtual]

Reimplemented from CContactFieldStorage::IsFull()const

Tests whether the field storage contains data.

Return Value: True if the field storage contains data, false if not.

RestoreL ( CStreamStore &, RReadStream & )

void	RestoreL	(	CStreamStore &	aStore,
			RReadStream &	aStream
		)	[virtual]

Reimplemented from CContactFieldStorage::RestoreL(CStreamStore &,RReadStream &)

Restores the field data.

Parameters
aStore	Reference to the store from which the object is to be restored.
aStream	Reference to the stream which should be passed to InternalizeL().

SetStandardTextArray ( MDesCArray * )

IMPORT_C void

SetStandardTextArray

(

MDesCArray *

anArray

)

Converts an array of text strings from plain text into Symbian editable text, appends them to a single descriptor, separating them with the new line character, and sets this as the text which is stored in the field. Any existing field text is replaced. The text is truncated to KCntMaxTextFieldLength characters if necessary.

Parameters
anArray	Array of descriptors to set as the field data.

SetStandardTextArray ( MDesC16Array * )

IMPORT_C void

SetStandardTextArray

(

MDesC16Array *

anArray

)

SetStandardTextL ( const TDesC & )

IMPORT_C void

SetStandardTextL

(

const TDesC &

aText

)

Converts a text string from plain text into Symbian editable text, and sets this as the text which is stored in the field. The text is truncated to KCntMaxTextFieldLength characters if necessary.

Parameters
aText	The new field data.

SetText ( HBufC * )

IMPORT_C void

SetText

(

HBufC *

aHbuf

)

Sets the field text.

The text field object takes ownership of the specified descriptor. The function cannot leave.

Parameters
aHbuf	The new field text.

SetTextArray ( MDesCArray * )

IMPORT_C void

SetTextArray

(

MDesCArray *

anArray

)

Sets the field text from a descriptor array. Each descriptor in the array is appended to the text field storage. They are separated by paragraph delimiters (CEditableText::EParagraphDelimiter). Any existing text is replaced.

Parameters
anArray	Pointer to array of descriptors to set as the field text.

SetTextArray ( MDesC16Array * )

IMPORT_C void

SetTextArray

(

MDesC16Array *

anArray

)

SetTextL ( const TDesC & )

IMPORT_C void

SetTextL

(

const TDesC &

aText

)

Sets the field text.

This function allocates a new HBufC descriptor, deleting any existing one, and copies the new text into it. The function can leave.

Parameters
aText	The new field text.

StandardTextLC ( )

IMPORT_C TPtrC

StandardTextLC

(

)

const

Converts a copy of the text stored in the field from Symbian editable text format into plain text and returns it as a pointer descriptor.

Return Value: Descriptor pointing to a copy of the field data as plain text.

StoreL ( CStreamStore & )

TStreamId

StoreL

(

CStreamStore &

aStore

)

const [virtual]

Reimplemented from CContactFieldStorage::StoreL(CStreamStore &)const

Stores the field data.

Parameters
aStore	Reference to the stream store to which the field data is written.

Return Value: The ID of the stream store.

Text ( )

IMPORT_C TPtrC

Text

(

)

const

Gets a copy of the text which is stored in the field.

Return Value: Descriptor pointing to a copy of the field data.