Categories Property

Used to specify categories or subtypes of the calendar event.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
char* GetCategories();
int SetCategories(const char* lpszCategories);

Unicode (Windows)
LPWSTR GetCategories();
INT SetCategories(LPCWSTR lpszCategories);

@property (nonatomic,readwrite,assign,getter=categories,setter=setCategories:) NSString* categories;
- (NSString*)categories;
- (void)setCategories:(NSString*)newCategories;

#define PID_CALDAV_CATEGORIES 14

IPWORKS_EXTERNAL void* IPWORKS_CALL IPWorks_CalDAV_Get(void *lpObj, int propid, int arridx, int *lpcbVal, int64 *lpllVal);
IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_CalDAV_Set(void *lpObj, int propid, int arridx, const void *val, int cbVal);

Default Value

""

Remarks

This property is used to specify the categories or subtypes contained in a calendar event. The categories are useful in searching for an event of a particular type and/or category. Within the "VEVENT", "VTODO", or "VJOURNAL" calendar components, more than one category can be specified as a COMMA-separated list of categories. For example:

  CalDAV.CalendarEvents[0].Category = "APPOINTMENT,EDUCATION,MEETING";

This property is filled from the response to a GetCalendarEvent, and is also used when creating an event to be added using the PutCalendarEvent method. However, when requesting a report using the GetCalendarReport method, the contents of this property will only be valid inside the EventDetails event.

Data Type

String