The Calendar type is used to handle a calendar (or organizer) associated with a user account or found on the device. You have the ability to list the appointments of the calendar via AppointmentListCalendar.

The characteristics of this calendar can be read by several WLanguage properties.

Note: See Declaring a variable for more details on the declaration of this type of variable and the use of WLanguage properties.

Versions 21 and later

This type of variable is now available for the iPhone/iPad applications.

New in version 21

This type of variable is now available for the iPhone/iPad applications.

This type of variable is now available for the iPhone/iPad applications.

Example

// Fills a list with the calendars available on the devicearrCalendar is arrayofCalendar = AppointmentListCalendar()FOR EACH Calendar OF arrCalendarListAdd(LIST_List1, Calendar..Name)END

Remarks

Properties specific to the description of Calendar variables

The following properties can be used to handle a Calendar:

Property name

Type used

Effect

Color

Integer

Color associated with the calendar. This color is the result of the following formula:Color = 65536 * Blue Component + 256 * Green Component + Red Component.

ID

8-byte integer

Identifier associated with the calendar. This property will be automatically filled when reading the calendar. We do not advise you to store this identifier beyond the lifetime of the application because this identifier can be modified when synchronizing the calendar.

Name

Character string

Name of the calendar.

AccountName

Character string

Name of the user account with which the calendar is associated.

This property can correspond to an email address for a Google account ("lastname.firstname@gmail.com" for example).

This property can correspond to "Gmail" for a Google account.

If this property corresponds to an empty string (""), the calendar is associated with no account: it is stored locally on the device.

AccountType

Character string

Type of account.

This property can correspond to "com.google" for a Google account.

This property can correspond to "CalDAV", name of the protocol used to access the online calendars (Calendaring Extensions to WebDAV).

If this property corresponds to an empty string (""), the calendar is associated with no account and it is stored locally on the device.

Caution: The properties of Calendar type are read-only and they are automatically filled when the calendars are read by AppointmentListCalendar.

Note: These properties can be used with one of the following syntaxes: