Collapse all Symbian^3 Product Developer Library

CESMRICalProperty Class Reference

class CESMRICalProperty : public CBase

Class representing a property.

Inherits from

CESMRICalProperty
- CBase

Public Member Functions
	~CESMRICalProperty()
IMPORT_C CESMRICalPropertyParam &	AddPropertyParamL(const TDesC &, CESMRICalValue *)
IMPORT_C CESMRICalPropertyParam &	AddPropertyParamL(const TDesC &, const TDesC &)
CESMRICalPropertyParam &	AddPropertyParamL()
IMPORT_C void	AddValueL(const TDesC &)
IMPORT_C void	AddValueL(CESMRICalValue *)
void	ExternalizeL(CESMRICalContentLineWriter &)
IMPORT_C const CESMRICalPropertyParam *	FindParam(const TDesC &)
IMPORT_C CESMRICalProperty *	NewL(const TDesC &, const TDesC &)
IMPORT_C CESMRICalProperty *	NewL(const TDesC &, CESMRICalValue *)
CESMRICalProperty *	NewL(const TDesC &)
IMPORT_C CESMRICalProperty *	NewLC(const TDesC &, const TDesC &)
IMPORT_C CESMRICalProperty *	NewLC(const TDesC &, CESMRICalValue *)
CESMRICalProperty *	NewLC(const TDesC &)
IMPORT_C const RPointerArray< CESMRICalPropertyParam > &	Parameters()
void	RemovePropertyParamL(const CESMRICalPropertyParam &)
IMPORT_C const TDesC &	Type()
IMPORT_C const RPointerArray< CESMRICalValue > &	Values()

Private Member Functions
	CESMRICalProperty()
	CESMRICalProperty(CESMRICalValue *)
void	ConstructL(const TDesC &)
void	ConstructL(const TDesC &, const TDesC &)
void	ConstructL(const TDesC &, CESMRICalValue *)

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()

Private Attributes
RPointerArray< CESMRICalPropertyParam >	iParams
HBufC *	iType
CESMRICalValue *	iValue
RPointerArray< CESMRICalValue >	iValues

Constructor & Destructor Documentation

CESMRICalProperty()

CESMRICalProperty

(

)

[private]

Constructor

CESMRICalProperty(CESMRICalValue *)

CESMRICalProperty

(

CESMRICalValue *

aValue

)

[private]

Constructor

Parameters

CESMRICalValue * aValue

The initial value.

~CESMRICalProperty()

~CESMRICalProperty

(

)

Destructor.

Member Functions Documentation

AddPropertyParamL(const TDesC &, CESMRICalValue *)

IMPORT_C CESMRICalPropertyParam &	AddPropertyParamL	(	const TDesC &	aType,
			CESMRICalValue *	aValue
		)

Adds a parameter with given type and value to the property, taking ownership of the value. Note that further values may be added later.

leave: Leaves with KErrParameterHasNoValue if aValue is NULL.

Parameters

const TDesC & aType	The type of property parameter.
CESMRICalValue * aValue	A value of the property parameter - this will be deleted if this function leaves.

AddPropertyParamL(const TDesC &, const TDesC &)

IMPORT_C CESMRICalPropertyParam &	AddPropertyParamL	(	const TDesC &	aType,
			const TDesC &	aValue
		)

Adds a parameter with given type and value to the property. Note that further values may be added later.

leave: Leaves with if there is an error adding a parameter.

Parameters

const TDesC & aType	The type of property parameter.
const TDesC & aValue	A value of the property parameter.

AddPropertyParamL()

CESMRICalPropertyParam &

AddPropertyParamL

(

)

Adds an empty parameter to the property.

leave: Leaves if there is an error adding a parameter.

AddValueL(const TDesC &)

IMPORT_C void

AddValueL

(

const TDesC &

aValue

)

Adds a value to the property. Any escaped characters in the value string are translated to the actual characters.

leave: Leaves if there is an error adding a value.

Parameters

const TDesC & aValue

The text string of the value, as would be entered into an iCalendar file.

AddValueL(CESMRICalValue *)

IMPORT_C void

AddValueL

(

CESMRICalValue *

aValue

)

Adds value to this property, taking ownership of the passed value pointer and deleting it if this function leaves.

leave: Leaves with KErrPropertyHasNoValue if aValue is NULL.

Parameters

CESMRICalValue * aValue

The value to add - this must not be NULL.

ConstructL(const TDesC &)

void

ConstructL

(

const TDesC &

aType

)

[private]

Internal construction

Parameters

const TDesC & aType

The type of property.

ConstructL(const TDesC &, const TDesC &)

void	ConstructL	(	const TDesC &	aType,
			const TDesC &	aValue
		)	[private]

Internal construction.

Parameters

const TDesC & aType	The type of property.
const TDesC & aValue	A value of the property.

ConstructL(const TDesC &, CESMRICalValue *)

void	ConstructL	(	const TDesC &	aType,
			CESMRICalValue *	aValue
		)	[private]

Internal construction. Takes ownership of the passed value pointer and deletes it if this function leaves.

Parameters

const TDesC & aType	The type of property.
CESMRICalValue * aValue	A value of the property - this class takes ownership.

ExternalizeL(CESMRICalContentLineWriter &)

void

ExternalizeL

(

CESMRICalContentLineWriter &

aWriter

)

Export this property using the given line writer, escaping any necessary characters. Assumes it contains at least one value from the check in CESMRICalBase::ExternalizeL().

Parameters

CESMRICalContentLineWriter & aWriter

The content line writer to export to.

FindParam(const TDesC &)

IMPORT_C const CESMRICalPropertyParam *

FindParam

(

const TDesC &

aType

)

const

Find a parameter with the given name. Ownership is not passed out.

Parameters

const TDesC & aType

The type of the parameter to search for

NewL(const TDesC &, const TDesC &)

IMPORT_C CESMRICalProperty *	NewL	(	const TDesC &	aType,
			const TDesC &	aValue
		)	[static]

Constructs a new CESMRICalProperty with given type and value and returns it. Note that other values may be added later.

Parameters

const TDesC & aType	The type of the property.
const TDesC & aValue	The value of the property.

NewL(const TDesC &, CESMRICalValue *)

IMPORT_C CESMRICalProperty *	NewL	(	const TDesC &	aType,
			CESMRICalValue *	aValue
		)	[static]

Constructs a new CESMRICalProperty with given type and value and returns it. Takes ownership of the passed value pointer and deletes it if this function leaves. Note that other values may be added later.

leave: Leaves with KErrPropertyHasNoValue if aValue is NULL.

Parameters

const TDesC & aType	The type of the property.
CESMRICalValue * aValue	The value of the property.

NewL(const TDesC &)

CESMRICalProperty *

NewL

(

const TDesC &

aType

)

[static]

Constructs a new CESMRICalProperty with given type and returns it

Parameters

const TDesC & aType

The type of the property.

NewLC(const TDesC &, const TDesC &)

IMPORT_C CESMRICalProperty *	NewLC	(	const TDesC &	aType,
			const TDesC &	aValue
		)	[static]

Constructs a new CESMRICalProperty with given type and value, pushes it onto the Cleanup Stack, and returns it. Note that other values may be added later.

Parameters

const TDesC & aType	The type of the property.
const TDesC & aValue	The value of the property.

NewLC(const TDesC &, CESMRICalValue *)

IMPORT_C CESMRICalProperty *	NewLC	(	const TDesC &	aType,
			CESMRICalValue *	aValue
		)	[static]

Constructs a new CESMRICalProperty with given type and value, pushes it onto the Cleanup Stack, and returns it. Takes ownership of the passed value pointer and deletes it if this function leaves. Note that other values may be added later.

leave: Leaves with KErrPropertyHasNoValue if aValue is NULL.

Parameters

const TDesC & aType	The type of the property.
CESMRICalValue * aValue	The value of the property.

NewLC(const TDesC &)

CESMRICalProperty *

NewLC

(

const TDesC &

aType

)

[static]

Constructs a new CESMRICalProperty with given type, pushes it onto the Cleanup Stack, and returns it.

Parameters

const TDesC & aType

The type of the property.

Parameters()

IMPORT_C const RPointerArray< CESMRICalPropertyParam > &

Parameters

(

)

const

Access method for the array of parameters.

RemovePropertyParamL(const CESMRICalPropertyParam &)

void

RemovePropertyParamL

(

const CESMRICalPropertyParam &

aParam

)

Removes the given parameter from the property.

leave: Leaves in debug mode if the parameter is not found (release mode ignores this).

Parameters

const CESMRICalPropertyParam & aParam

The parameter to remove.

Type()

IMPORT_C const TDesC &

Type

(

)

const

Gets the type of the property.

Values()

IMPORT_C const RPointerArray< CESMRICalValue > &

Values

(

)

const

Access method for the array of properties.

Member Data Documentation

RPointerArray< CESMRICalPropertyParam > iParams

RPointerArray< CESMRICalPropertyParam >

iParams

[private]

HBufC * iType

HBufC *

iType

[private]

CESMRICalValue * iValue

CESMRICalValue *

iValue

[private]

RPointerArray< CESMRICalValue > iValues

RPointerArray< CESMRICalValue >

iValues

[private]