| class CParserGroupedProperty : public CParserProperty |
A grouped property.
This is a vCard property which may be a member of one or more property groups. It owns an array of descriptors, each of which identifies a group to which the property belongs.
An example of how grouped properties may be useful is for a person with two homes. Each home has an address and telephone number, both of which are to be stored on the vCard. The address and telephone number are grouped for each home. A prefix for the address and telephone number properties is provided: one for each home. Each prefix is stored as a property group.
When the property is externalised, the identities of all the groups to which the property belongs (i.e. the prefixes) are written to the stream before CParserProperty::ExternalizeL() is called.
The class also provides a function which can be used to test whether the property is a member of a given group.
Note that the vCard parser stores all properties using this class; if the vCard property is not grouped then the array of property groups is empty. Conversely, the vCalender parser does not have property groups, and so stores all properties using the CParserProperty base class.
| Public Member Functions | |
|---|---|
| CParserGroupedProperty(CDesC8Array *, CArrayPtr< CParserParam > *) | |
| ~CParserGroupedProperty() | |
| IMPORT_C void | ExternalizeL(RWriteStream &, CVersitParser *) |
| IMPORT_C TBool | Group(const TDesC8 &) |
| const CDesC8Array * | Groups() |
| IMPORT_C CParserGroupedProperty * | NewL(CParserPropertyValue &, const TDesC8 &, CDesC8Array *, CArrayPtr< CParserParam > *) |
| void | SetGroups(CDesC8Array *) |
| IMPORT_C TBool | SupportsInterface(const TUid &) |
| Protected Member Functions | |
|---|---|
| CParserGroupedProperty(CParserPropertyValue &, CDesC8Array *, CArrayPtr< CParserParam > *) | |
| Private Member Functions | |
|---|---|
| IMPORT_C void | Reserved() |
| Protected Attributes | |
|---|---|
| CDesC8Array * | iArrayOfGroups |
| Inherited Attributes | |
|---|---|
| CParserProperty::iArrayOfParams | |
| CParserProperty::iPropertyName | |
| CParserProperty::iPropertyNameUid | |
| CParserProperty::iPropertyValue | |
| IMPORT_C | CParserGroupedProperty | ( | CDesC8Array * | aArrayOfGroups, |
| CArrayPtr< CParserParam > * | aArrayOfParams | |||
| ) | ||||
Allocates and partially constructs a new grouped property using the array of grouped property names and array of property parameters specified.
| CDesC8Array * aArrayOfGroups | Pointer to an array of descriptors. Each one specifies a group name. The grouped property takes ownership of this array. (May be NULL). |
| CArrayPtr< CParserParam > * aArrayOfParams | The property parameters. The grouped property takes ownership of this array. (May be NULL). |
| CParserGroupedProperty | ( | CParserPropertyValue & | aPropertyValue, |
| CDesC8Array * | aArrayOfGroups, | ||
| CArrayPtr< CParserParam > * | aArrayOfParams | ||
| ) | [protected] | ||
| CParserPropertyValue & aPropertyValue | |
| CDesC8Array * aArrayOfGroups | |
| CArrayPtr< CParserParam > * aArrayOfParams |
| IMPORT_C | ~CParserGroupedProperty | ( | ) |
Frees all resources owned by the property, prior to its destruction.
| IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream, |
| CVersitParser * | aVersitParser = NULL | |||
| ) | [virtual] | |||
Externalises the property into aStream.
Externalises the list of groups to which the property belongs, if there are any, then calls CParserProperty::ExternalizeL() to write the rest of the property data to the stream.
| RWriteStream & aStream | Stream to which the value should be externalised. |
| CVersitParser * aVersitParser = NULL | Versit parser which contains the objects to be externalised. This must not be NULL or a panic occurs. |
| IMPORT_C TBool | Group | ( | const TDesC8 & | aGroup | ) | const |
Tests whether the property is a member of the specified property group.
| const TDesC8 & aGroup | The name of the property group. |
| IMPORT_C CParserGroupedProperty * | NewL | ( | CParserPropertyValue & | aPropertyValue, |
| const TDesC8 & | aName, | |||
| CDesC8Array * | aArrayOfGroups, | |||
| CArrayPtr< CParserParam > * | aArrayOfParams | |||
| ) | [static] | |||
Allocates and constructs a new grouped property from the value, name, property parameters and groups specified.
Note: the property value, name and array of property parameters are generic to all properties. The array of grouped property names is specific to the CParserGroupedProperty class.
| CParserPropertyValue & aPropertyValue | The property value. The grouped property takes ownership of this. |
| const TDesC8 & aName | The property name. The grouped property takes ownership of this. |
| CDesC8Array * aArrayOfGroups | Pointer to an array of descriptors. Each one specifies a group name. The grouped property takes ownership of this array. (May be NULL). |
| CArrayPtr< CParserParam > * aArrayOfParams | The property parameters. The grouped property takes ownership of this array. (May be NULL). |
| void | SetGroups | ( | CDesC8Array * | aArrayOfGroups | ) | [inline] |
Sets the list of groups to which the property belongs, replacing any existing list.
| CDesC8Array * aArrayOfGroups | Array of descriptors; each of which specifies a group name. The grouped property takes ownership of the array. |
| IMPORT_C TBool | SupportsInterface | ( | const TUid & | aInterfaceUid | ) | const [virtual] |
Tests whether the property supports the given interface.
Returns true if the given interface UID is KVersitGroupedPropertyUid.
| const TUid & aInterfaceUid | An interface UID. |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.