Apple Developer Connection
Member Login Log In | Not a Member? Contact ADC

< Previous PageNext Page > Hide TOC

10.5 Symbol Changes

This article lists the symbols added to CalendarStore.framework in Mac OS X v10.5.

Contents:

Classes
C Symbols


Classes

All of the classes with new symbols are listed alphabetically, with their new class, instance, and delegate methods described.

CalAlarm (New)

Complete reference information is available in the CalAlarm reference.

Class Methods

alarmCreates and returns a new alarm object.

Instance Methods

absoluteTriggerThe date and time to trigger the alarm.
actionThe action to take when triggering the alarm.
emailAddressAn email address that is the recipient of an email alarm—an alarm that triggers an email message.
relativeTriggerThe relative date and time to trigger the alarm.
soundThe sound to play when the alarm triggers.
triggerDateRelativeTo:Returns a delta value between the specified date and the date that the alarm is scheduled to trigger.
url

CalAttendee (New)

Complete reference information is available in the CalAttendee reference.

Instance Methods

addressAn NSURL object that can be used to contact the attendee.
commonNameThe user-entered name of the attendee.
statusThe attendee’s confirmation status.

CalCalendar (New)

Complete reference information is available in the CalCalendar reference.

Class Methods

calendarCreates and returns a new CalCalendar object.

Instance Methods

colorThe calendar’s color.
isEditableA Boolean value indicating whether the calendar is editable or not.
notesTextual notes about the calendar.
titleThe calendar’s title.
typeThe type of calendar.
uidA unique identifier for the receiver.

CalCalendarItem (New)

Complete reference information is available in the CalCalendarItem reference.

Instance Methods

addAlarm:Adds an alarm to the receiver.
addAlarms:Adds the alarms contained in an array to the receiver.
alarmsAn array containing the calendar item’s alarm objects—an array of CalAlarm objects.
calendarThe associated calendar object for the calendar item.
dateStampThe date the calendar item was last modified (not the same as the date is was last synced). This property is read-only.
hasAlarmReturns whether or not the receiver has an alarm.
nextAlarmDateReturns the date of the next alarm.
notesThe notes about the calendar item.
removeAlarm:Removes the specified alarm from the receiver.
removeAlarms:Removes the alarms contained in an array from the receiver.
titleThe title of the calendar item.
uidThe calendar item’s unique identifier. This property is read-only.
urlThe URL for the calendar item.

CalCalendarStore (New)

Complete reference information is available in the CalCalendarStore reference.

Class Methods

defaultCalendarStoreReturns the shared CalCalendarStore object.
eventPredicateWithStartDate:endDate:calendars:Returns an NSPredicate object that specifies events within a date range that belong to the specified calendars.
eventPredicateWithStartDate:endDate:UID:calendars:Returns an NSPredicate object that specifies events with a UID and within a date range that belong to the specified calendars.
taskPredicateWithCalendars:Returns an NSPredicate object that specifies tasks that belong to the specified calendars.
taskPredicateWithTasksCompletedSince:calendars:Returns an NSPredicate object that specifies completed tasks since the specified date and that belong to the specified calendars.
taskPredicateWithUncompletedTasks:Returns an NSPredicate object that specifies tasks that are incomplete and belong to the specified calendars.
taskPredicateWithUncompletedTasksDueBefore: calendars:Returns an NSPredicate object that specifies incomplete tasks due before the specified date and that belong to the specified calendars.

Instance Methods

calendarsReturns an array of CalCalendar objects representing the user’s calendars in the order they appear in iCal.
calendarWithUID:Returns a CalCalendar object that corresponds to the given UID.
eventsWithPredicate:Returns an array of CalEvent objects that match the specified predicate.
eventWithUID:occurrence:Returns an event that matches the specified unique identifier.
removeCalendar:error:Removes the specified calendar from the iCal database.
removeEvent:span:error:Removes the specified event from the calendar store.
removeTask:error:Removes the specified task from the calendar store.
saveCalendar:error:Saves local changes to the specified calendar object to the iCal database.
saveEvent:span:error:Saves the specified event to the calendar store.
saveTask:error:Saves the specified task to the calendar store.
tasksWithPredicate:Returns an array of CalTask objects that match the specified predicate.
taskWithUID:Returns a task that matches the specified unique identifier.

CalEvent (New)

Complete reference information is available in the CalEvent reference.

Class Methods

eventCreates and returns a newly allocated CalEvent object.

Instance Methods

attendeesAn array of invited guests or an empty array if there are no attendees. This property is read-only.
endDateThe end date and time for this event.
isAllDayYES if this is an all day event; otherwise, NO.
isDetachedReturns whether or not an event is detached. This property is read-only.
locationA description of the location of this event.
occurrenceThe occurrence date of an event. This property is read-only.
recurrenceRuleThe recurrence rule of an event.
startDateThe start date and time for this event.

CalNthWeekDay (New)

Complete reference information is available in the CalNthWeekDay reference.

Instance Methods

dayOfTheWeekThe day of the week, a number from 1 to 7 with Sunday equal to 1.
weekNumberThe week of the month, a number that is either 1, 2, 3, 4, or -1 where -1 indicates the last week of the month.

CalRecurrenceEnd (New)

Complete reference information is available in the CalRecurrenceEnd reference.

Class Methods

recurrenceEndWithEndDate:Creates and returns a newly allocated CalRecurrenceEnd object with the specified end date.
recurrenceEndWithOccurrenceCount:Creates and returns a newly allocated CalRecurrenceEnd object with the specified recurrence count.

Instance Methods

endDateThe end date if the recurrence uses an end date value; nil if it uses an occurrence count.
occurrenceCountThe occurrence count—number of times an event repeats—if the recurrence uses a number value; 0 if it uses an end date.
usesEndDateYES if the recurrence uses an end date; NO if it uses a occurrence count.

CalRecurrenceRule (New)

Complete reference information is available in the CalRecurrenceRule reference.

Instance Methods

daysOfTheMonthIf the recurrenceType property is CalRecurrenceMonthly, an array of integer values ranging from 1 to 31 representing days of the month in the pattern; otherwise, nil.
daysOfTheWeekIf the recurrenceType property is CalRecurrenceWeekly, an integer value ranging from 1 to 7 representing the day of the week in the pattern where Sunday is equal to 1; otherwise, nil.
firstDayOfTheWeekAn integer value of 0 or 1 to 7 where 0 indicates no value is set, and 1 to 7 indicates the first day of the week where Sunday is represented by 1.
initDailyRecurrenceWithInterval:end:Initializes and returns a daily recurrence rule with the specified interval and ending rule.
initMonthlyRecurrenceWithInterval:end:Initializes and returns a monthly recurrence rule with the specified interval and end rule.
initMonthlyRecurrenceWithInterval:forDayOfTheWeek: forWeekOfTheMonth:end:
initMonthlyRecurrenceWithInterval: forDaysOfTheMonth:end:Initializes and returns a monthly recurrence rule that represents an event that occurs more than once a month in a monthly pattern—the pattern repeats at the specified interval.
initWeeklyRecurrenceWithInterval:end:Initializes and returns a weekly recurrence rule with the specified interval and ending rule.
initWeeklyRecurrenceWithInterval:forDaysOfTheWeek: end:Initializes and returns a weekly recurrence rule with the specified interval, ending rule, and specific days of the week.
initYearlyRecurrenceWithInterval:end:Initializes and returns a yearly recurrence rule with the specified yearly interval and end rule.
initYearlyRecurrenceWithInterval:forDayOfTheWeek: forWeekOfTheMonth:forMonthsOfTheYear:end:
initYearlyRecurrenceWithInterval: forMonthsOfTheYear:end:Initializes and returns a yearly recurrence rule representing an event that occurs multiple months within a year at a specified yearly interval.
monthsOfTheYearIf the recurrenceType property is CalRecurrenceYearly, an array of the months—integer values ranging from 1 to 12 representing the month of a year—that the event occurs; otherwise, nil.
nthWeekDaysOfTheMonthIf the recurrenceType property is CalRecurrenceMonthly or CalRecurrenceYearly, an array of CalNthWeekDay objects representing the days within the weeks of a month; otherwise, nil.
recurrenceEndAn object that describes how a recurring event ends by specifying an end date or a counter.
recurrenceIntervalThe number of intervals between the specified pattern of a recurring event. The actual time between a pattern depends on the value of the recurrenceType property.
recurrenceTypeThe unit of time between intervals. See “CalRecurrenceType” for possible values.

CalTask (New)

Complete reference information is available in the CalTask reference.

Class Methods

taskCreates and initializes a newly allocated task object.

Instance Methods

completedDateThe task’s completed date.
dueDateThe due date and time for this task.
isCompletedYES if this task is completed; otherwise, NO.
priorityThe priority of this task—an integer ranging from 0 to 9 with 0 representing an undefined priority, 1 the highest priority, and 9 the lowest priority.

C Symbols

All of the header files with new symbols are listed alphabetically, with their new symbols described.

CalAlarm.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalAlarmActionDisplayA message should be displayed when an alarm triggers.
CalAlarmActionEmailAn email message should be sent when an alarm triggers.
CalAlarmActionProcedureA file should be opened when an alarm triggers.
CalAlarmActionSoundA sound should be played when an alarm triggers.

CalAttendee.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalAttendeeStatusAcceptedThe attendee accepted the invitation.
CalAttendeeStatusDeclinedThe attendee declined the invitation.
CalAttendeeStatusNeedsActionThe status is not set for this attendee.
CalAttendeeStatusTentativeThe attendee’s status is tentative.

CalCalendar.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalCalendarTypeBirthdayAn birthday calendar maintained by Address Book.
CalCalendarTypeCalDAVA CalDAV server calendar.
CalCalendarTypeIMAPAn IMAP calendar.
CalCalendarTypeLocalA local calendar that may be synced over .Mac.
CalCalendarTypeSubscriptionA subscribed calendar.

CalCalendarStore.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalCalendarsChangedExternallyNotificationPosted by the shared NSDistributedNotificationCenter object when another application process changes calendar objects.
CalCalendarsChangedNotificationPosted by the shared NSDistributedNotificationCenter object when this application process changes calendar objects.
CalDeletedRecordsKeyAn array of record UIDs that were deleted.
CalEventsChangedExternallyNotificationPosted by the shared NSDistributedNotificationCenter object when another application process changes event objects.
CalEventsChangedNotificationPosted by the shared NSDistributedNotificationCenter object when this application process changes event objects.
CalInsertedRecordsKeyAn array of record UIDs that were inserted.
CalSenderProcessIDKeyThe key for a process ID that identifies the application that changed either a calendar, event, or task object.
CalSpanThe range of events to apply changes to for a recurring event.
CalSpanAllEventsApply changes to all events of a recurring event.
CalSpanFutureEventsApply changes to all future events of a recurring event.
CalSpanThisEventApply changes to just this instance of a recurring event.
CalTasksChangedExternallyNotificationPosted by the shared NSDistributedNotificationCenter object when another application process changes task objects.
CalTasksChangedNotificationPosted by the shared NSDistributedNotificationCenter object when this application process changes task objects.
CalUpdatedRecordsKeyAn array of record UIDs whose properties were changed.
CalUserUIDKeyThe key for a user UID that identifies the user that changed either a calendar, event, or task object.

CalRecurrenceRule.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalDefaultRecurrenceIntervalThe default recurrence interval. The default value of 1 indicates that the event repeats daily, weekly, monthly, or yearly depending on the recurrence type.
CalRecurrenceDailyIndicates a daily unit of measurement.
CalRecurrenceMonthlyIndicates a monthly unit of measurement.
CalRecurrenceTypeThe unit of measurement between occurrences of a recurring event.
CalRecurrenceWeeklyIndicates a weekly unit of measurement.
CalRecurrenceYearlyIndicates a yearly unit of measurement.

CalTask.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalPriorityType that describes the priority of a task.
CalPriorityHighThe priority for this task is high.
CalPriorityLowThe priority for this task is low.
CalPriorityMediumThe priority for this task is medium.
CalPriorityNoneThe priority is not set for this task.

CalendarStoreErrors.h

Data Types & Constants

All of the new data types and constants in this header file are listed alphabetically, with links to documentation and abstracts, if available.

CalCalendarNotEditableErrorAttempted to add events or tasks to a read-only calendar.
CalCalendarNotInRepositoryAttempted to set an event or task’s calendar object to a nonlocal calendar—a calendar that is not in the user’s iCal database.
CalCalendarStoreErrorDomainThe Calendar Store error domain.
CalCalendarTitleNotUniqueErrorAttempted to save a calendar object that doesn’t have a unique title. All calendar titles must be unique.
CalDateInvalidErrorAttempted to set the start date of an event earlier than its end date.


< Previous PageNext Page > Hide TOC


Last updated: 2007-07-18




Did this document help you?
Yes: Tell us what works for you.

It’s good, but: Report typos, inaccuracies, and so forth.

It wasn’t helpful: Tell us what would have helped.
Get information on Apple products.
Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Copyright © 2007 Apple Inc.
All rights reserved. | Terms of use | Privacy Notice