Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <calcategory.h>

Class CCalCategory

class CCalCategory : public CBase;

Description

Calendar categories can be associated with a calendar entry.

There are 12 built in category types defined by TCalCategoryType. Additionally, it is possible to define extended category types which are held as a descriptor of any length.

Any number of categories can be specified for an entry. CCalEntry provides member functions for adding, deleting and fetching categories for an entry.

CCalCategoryManager functions enable the client to add\delete\fetch categories from a Calendar session and to get a list of entries filtered by their category.

Derivation

Members

Defined in CCalCategory:

Inherited from CBase:


Construction and destruction


NewL(TCalCategoryType)

Capability: Illegal

IMPORT_C static CCalCategory* NewL(TCalCategoryType aCategory);

Description

Parameters

CCalCategory::TCalCategoryType aCategory

Return value

CCalCategory *


NewL(TCalCategoryType)

Capability: Illegal

IMPORT_C static CCalCategory* NewL(TCalCategoryType aCategory);

Description

Allocates and constructs a category object of one of the standard types.

Parameters

CCalCategory::TCalCategoryType aCategory

The category type.

Return value

CCalCategory *

Pointer to newly created category object.


NewL(const TDesC &)

Capability: Illegal

IMPORT_C static CCalCategory* NewL(const TDesC &aExtendedName);

Description

Parameters

const TDesC16 &aExtendedName

Return value

CCalCategory *


~CCalCategory()

Capability: Illegal

IMPORT_C ~CCalCategory();

Description


NewL(const TDesC &)

Capability: Illegal

IMPORT_C static CCalCategory* NewL(const TDesC &aExtendedName);

Description

Allocates and constructs a category object of user-defined type with specified category name.

Parameters

const TDesC16 &aExtendedName

The extended category name.

Return value

CCalCategory *

Pointer to newly created category object.


~CCalCategory()

Capability: Illegal

IMPORT_C ~CCalCategory();

Description

The destructor frees all resources owned by the category, prior to its destruction.

[Top]


Member functions


Category()const

Capability: Illegal

IMPORT_C TCalCategoryType Category() const;

Description

Return value

CCalCategory::TCalCategoryType


Category()const

Capability: Illegal

IMPORT_C TCalCategoryType Category() const;

Description

Gets the category type.

Return value

CCalCategory::TCalCategoryType

The category type.


ExtendedCategoryName()const

Capability: Illegal

IMPORT_C const TDesC& ExtendedCategoryName() const;

Description

Return value

const TDesC16 &


ExtendedCategoryName()const

Capability: Illegal

IMPORT_C const TDesC& ExtendedCategoryName() const;

Description

Gets the extended category name.

Return value

const TDesC16 &

The extended category name if there is one, otherwise an empty descriptor.

[Top]


Member enumerations


Enum TCalCategoryType

TCalCategoryType

Description

Calendar category type.

ECalAppointment

Appointment

ECalBusiness

Business

ECalEducation

Education

ECalHoliday

Holiday

ECalMeeting

Meeting

ECalMiscellaneous

All other types

ECalPersonal

Personal

ECalPhoneCall

Phone call

ECalSickDay

Sick day

ECalSpecialOccasion

Special occasion

ECalTravel

Travel

ECalVacation

Vacation

ECalExtended

Extended


Enum TCalCategoryType

TCalCategoryType

Description

Calendar category type.

ECalAppointment

Appointment

ECalBusiness

Business

ECalEducation

Education

ECalHoliday

Holiday

ECalMeeting

Meeting

ECalMiscellaneous

All other types

ECalPersonal

Personal

ECalPhoneCall

Phone call

ECalSickDay

Sick day

ECalSpecialOccasion

Special occasion

ECalTravel

Travel

ECalVacation

Vacation

ECalExtended

Extended