Symbian
 Developer Library

UIQ 3 SDK

UIQ developer portal

FEEDBACK 

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



Location: calcategory.h
Link against: calinterimapi.lib

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:
Category(), ECalAppointment, ECalBusiness, ECalEducation, ECalExtended, ECalHoliday, ECalMeeting, ECalMiscellaneous, ECalPersonal, ECalPhoneCall, ECalSickDay, ECalSpecialOccasion, ECalTravel, ECalVacation, ExtendedCategoryName(), NewL(), NewL(), TCalCategoryType, ~CCalCategory()

Inherited from CBase:
Delete(), Extension_(), operator new()


Construction and destruction


NewL()

Capability: None

static IMPORT_C CCalCategory *NewL(TCalCategoryType aCategory);

Description

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

Parameters

TCalCategoryType aCategory

The category type.

Return value

CCalCategory *


NewL()

Capability: None

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

Description

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

Parameters

const TDesC &aExtendedName

The extended category name.

Return value

CCalCategory *


~CCalCategory()

Capability: None

IMPORT_C ~CCalCategory();

Description

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

[Top]


Member functions


Category()

Capability: None

IMPORT_C TCalCategoryType Category() const;

Description

Gets the category type.

Return value

TCalCategoryType

The category type.


ExtendedCategoryName()

Capability: None

IMPORT_C const TDesC &ExtendedCategoryName() const;

Description

Gets the extended category name.

Return value

const TDesC &

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

Terms and conditions of use of the material