peachsim 0.1.2176 → 0.1.2179

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKEventStore.h

@@ -0,0 +1,477 @@
+//
+//  EKEventStore.h
+//  EventKit
+//
+//  Copyright 2009-2010 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <EventKit/EventKitDefines.h>
+#import <EventKit/EKTypes.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class EKCalendar, EKEvent, EKSource, EKReminder, EKCalendarItem;
+
+/*!
+    @enum           EKSpan
+    @abstract       Values for controlling what occurrences to affect in a recurring event.
+    @discussion     This enumerated type is used to indicate the scope of a change being made to a repeating event. EKSpanThisEvent 
+                    indicates the changes should apply only to this event, EKSpanFutureEvents indicates the changes should apply to 
+                    this event and all future events in the pattern.
+    @constant       EKSpanThisEvent        Affect this event only.
+    @constant       EKSpanFutureEvents     Affect this event and all after it.
+*/
+
+typedef NS_ENUM(NSInteger, EKSpan) {
+    EKSpanThisEvent,
+    EKSpanFutureEvents
+};
+
+
+typedef void (^EKEventSearchCallback)(EKEvent *event, BOOL *stop);
+
+/*!
+    @class       EKEventStore
+    @abstract    The EKEventStore class provides an interface for accessing and manipulating calendar events and reminders.
+    @discussion  The EKEventStore class is the main point of contact for accessing Calendar data. You must
+                 create a EKEventStore object in order to retrieve/add/delete events or reminders from the Calendar database.
+                 
+                 Events, Reminders, and Calendar objects retrieved from an event store cannot be used with any other event
+                 store. It is generally best to hold onto a long-lived instance of an event store, most
+                 likely as a singleton instance in your application.
+*/
+NS_CLASS_AVAILABLE(10_8, 4_0)
+@interface EKEventStore : NSObject
+
+/*!
+    @method     authorizationStatusForEntityType:
+    @discussion Returns the authorization status for the given entity type
+ */
+
++ (EKAuthorizationStatus)authorizationStatusForEntityType:(EKEntityType)entityType NS_AVAILABLE(10_9, 6_0);
+
+
+/*!
+    @method     initWithAccessToEntityTypes:
+    @discussion Users are able to grant or deny access to event and reminder data on a per-app basis. To request access to
+                event and/or reminder data, instantiate an EKEventStore using this method. This call will not block the
+                program while the user is being asked to grant or deny access. Until access has been granted for an entity
+                type, this event store will not contain any calendars for that entity type, and any attempt to save entities
+                of that entity type will fail. If access is later granted or declined, the event store will broadcast an
+                EKEventStoreChangedNotification. You can check the current access status for an entity type
+                using +authorizationStatusForEntityType:. The user will only be prompted the first time access is requested; any
+                subsequent instantiations of EKEventStore will use the existing permissions.
+    @param      entityTypes         A bit mask of entity types to which you want access
+*/
+- (id)initWithAccessToEntityTypes:(EKEntityMask)entityTypes NS_DEPRECATED(10_8, 10_9, NA, NA);
+
+
+/*!
+        @method     init
+ */
+- (id)init NS_AVAILABLE(10_9, 4_0);
+
+/*!
+    @method     initWithSources:
+    @abstract   Creates a new event store that only includes items and calendars for a subset of sources.
+    @param      sources The sources you want this event store to recognize. This may include delegate sources.
+ */
+- (instancetype)initWithSources:(NSArray<EKSource *> *)sources NS_AVAILABLE(10_11, 16_0);
+
+typedef void(^EKEventStoreRequestAccessCompletionHandler)(BOOL granted, NSError * __nullable error);
+
+- (void)requestFullAccessToEventsWithCompletion:(EKEventStoreRequestAccessCompletionHandler)completion API_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0));
+
+- (void)requestWriteOnlyAccessToEventsWithCompletion:(EKEventStoreRequestAccessCompletionHandler)completion API_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0));
+
+- (void)requestFullAccessToRemindersWithCompletion:(EKEventStoreRequestAccessCompletionHandler)completion API_AVAILABLE(ios(17.0), macos(14.0), watchos(10.0));
+
+- (void)requestAccessToEntityType:(EKEntityType)entityType completion:(EKEventStoreRequestAccessCompletionHandler)completion API_DEPRECATED("Use -requestFullAccessToEventsWithCompletion:, -requestWriteOnlyAccessToEventsWithCompletion:, or -requestFullAccessToRemindersWithCompletion:", ios(6.0, 17.0), macos(10.0, 14.0), watchos(1.0, 10.0));
+
+/*!
+    @property   eventStoreIdentifier
+    @abstract   Returns a unique identifier string representing this calendar store.
+*/
+@property(nonatomic, readonly) NSString *eventStoreIdentifier;
+
+//----------------------------------------------------
+// SOURCES
+//----------------------------------------------------
+
+/*!
+    @property   delegateSources
+    @abstract   Returns an unordered array of sources for all available delegates.
+ */
+@property (nonatomic, readonly) NSArray<EKSource *> *delegateSources NS_AVAILABLE(10_11, 12_0);
+
+/*!
+    @property   sources
+    @abstract   Returns an unordered array of sources.
+*/
+@property (nonatomic, readonly) NSArray<EKSource *> *sources NS_AVAILABLE(10_8, 5_0);
+
+/*!
+    @method     sourceWithIdentifier:
+    @abstract   Returns a source with a specified identifier.
+*/
+- (nullable EKSource *)sourceWithIdentifier:(NSString *)identifier NS_AVAILABLE(10_8, 5_0);
+
+//----------------------------------------------------
+// CALENDARS
+//----------------------------------------------------
+
+/*!
+    @method     calendars
+    @abstract   While this returns an array, the calendars are unordered. This call is deprecated
+                 and only returns calendars that support events. If you want reminder calendars
+                 you should use calendarsForEntityType:
+*/
+@property(nonatomic, readonly) NSArray<EKCalendar *> *calendars NS_DEPRECATED(NA, NA, 4_0, 6_0)
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+API_UNAVAILABLE(visionos)
+#endif
+;
+
+/*!
+    @method     calendarsForEntityType
+    @abstract   Returns calendars that support a given entity type (reminders, events)
+ */
+- (NSArray<EKCalendar *> *)calendarsForEntityType:(EKEntityType)entityType NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @property   defaultCalendarForNewEvents
+    @abstract   Returns the calendar that events should be added to by default.
+    @discussion This may be nil if there is no default calendar for new events.
+*/
+@property(nullable, nonatomic, readonly) EKCalendar *defaultCalendarForNewEvents;
+
+/*!
+    @method     defaultCalendarForNewReminders
+    @abstract   Returns the calendar that reminders should be added to by default.
+    @discussion This may be nil if there is no default calendar for new reminders.
+*/
+- (nullable EKCalendar *)defaultCalendarForNewReminders NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @method     calendarWithIdentifier:
+    @abstract   Returns a calendar with a specified identifier.
+*/
+- (nullable EKCalendar *)calendarWithIdentifier:(NSString *)identifier NS_AVAILABLE(10_8, 5_0);
+
+/*!
+    @method     saveCalendar:commit:error:
+    @abstract   Saves changes to a calendar, or adds a new calendar to the database.
+    @discussion This method attempts to save the given calendar to the calendar database. It
+                returns YES if successful and NO otherwise. Passing a calendar fetched from
+                another EKEventStore instance into this function will raise an exception.
+                On WatchOS, saving changes is not supported.
+
+    @param      calendar    The calendar to save.
+    @param      commit      Pass YES to cause the database to save. You can pass NO to save multiple
+                            calendars and then call commit: to save them all at once.
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)saveCalendar:(EKCalendar *)calendar commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     removeCalendar:commit:error:
+    @abstract   Removes a calendar from the database.
+    @discussion This method attempts to delete the given calendar from the calendar database. It
+                returns YES if successful and NO otherwise. Passing a calendar fetched from
+                another EKEventStore instance into this function will raise an exception.
+
+                If the calendar supports multiple entity types (allowedEntityTypes), but the user has 
+                not granted you access to all those entity types, then we will delete all of the entity types 
+                for which you have access and remove that entity type from the allowedEntityTypes.
+                For example: If a calendar supports both events and reminders, but you only have access to reminders,
+                we will delete all the reminders and make the calendar only support events.
+ 
+                If you have access to all of its allowedEntityTypes, then it will delete the calendar and
+                all of the events and reminders in the calendar.
+ 
+                On WatchOS, modifying the database is not supported.
+ 
+    @param      calendar    The calendar to delete.
+    @param      commit      Pass YES to cause the database to save. You can pass NO to batch multiple
+                            changes and then call commit: to save them all at once.
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)removeCalendar:(EKCalendar *)calendar commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+
+//----------------------------------------------------
+// CALENDAR ITEMS (apply to both reminders and events)
+//----------------------------------------------------
+
+/*!
+    @method     calendarItemWithIdentifier:
+    @abstract   Returns either a reminder or the first occurrence of an event.
+*/
+- (nullable EKCalendarItem *)calendarItemWithIdentifier:(NSString *)identifier NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @method     calendarItemsWithExternalIdentifier:
+    @abstract   Returns either matching reminders or the first occurrences of any events matching
+                the given external identifier.
+    @discussion This method returns a set of EKEvents or EKReminders with the given external identifier.
+                Due to reasons discussed in -[EKCalendarItem calendarItemExternalIdentifier], there may be
+                more than one matching calendar item.
+ 
+    @param      externalIdentifier  The value obtained from EKCalendarItem's
+                calendarItemExternalIdentifier property
+    @result     An unsorted array of EKCalendarItem instances
+*/
+- (NSArray<EKCalendarItem *> *)calendarItemsWithExternalIdentifier:(NSString *)externalIdentifier NS_AVAILABLE(10_8, 6_0);
+
+//----------------------------------------------------
+// EVENTS
+//----------------------------------------------------
+
+/*!
+    @method     saveEvent:span:error:
+    @abstract   Saves changes to an event permanently.
+    @discussion This method attempts to save the event to the calendar database. It returns YES if
+                successful and NO otherwise. It's possible for this method to return NO, and error
+                will be set to nil. This occurs if the event wasn't dirty and didn't need saving. This
+                means the correct way to detect failure is a result of NO and a non-nil error parameter.
+                Passing an event fetched from another EKEventStore instance into this function will
+                raise an exception.
+
+                After an event is successfully saved, it is also put into sync with the database, meaning
+                that all fields you did not change will be updated to the latest values. If you save the
+                event, but it was deleted by a different store/process, you will effectively recreate the
+                event as a new event.
+ 
+                On WatchOS, saving changes is not supported.
+ 
+    @param      event       The event to save.
+    @param      span        The span to use (this event, or this and future events).
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)saveEvent:(EKEvent *)event span:(EKSpan)span error:(NSError **)error NS_AVAILABLE(10_14, 4_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     removeEvent:span:error:
+    @abstract   Removes an event from the calendar store.
+    @discussion This method attempts to remove the event from the calendar database. It returns YES if
+                successful and NO otherwise. It's possible for this method to return NO, and error
+                will be set to nil. This occurs if the event wasn't ever added and didn't need removing. This
+                means the correct way to detect failure is a result of NO and a non-nil error parameter.
+                Passing an event from another CalendarStore into this function will raise an exception. After
+                an event is removed, it is no longer tied to this calendar store, and all data in the event
+                is cleared except for the eventIdentifier.
+ 
+                On WatchOS, modifying the database is not supported.
+ 
+    @param      event       The event to save.
+    @param      span        The span to use (this event, or this and future events).
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)removeEvent:(EKEvent *)event span:(EKSpan)span error:(NSError **)error NS_AVAILABLE(10_14, 4_0) __WATCHOS_PROHIBITED;
+
+// These variants of the above allow you to batch changes by passing NO to commit. You can commit
+// all changes later with [EKEventStore commit:]
+- (BOOL)saveEvent:(EKEvent *)event span:(EKSpan)span commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+- (BOOL)removeEvent:(EKEvent *)event span:(EKSpan)span commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     eventWithIdentifier:
+    @abstract   Returns the first occurrence of an event matching the given event identifier.
+ 
+    @param      identifier   The eventIdentifier to search for.
+    @result     An EKEvent object, or nil if not found.
+*/
+- (nullable EKEvent *)eventWithIdentifier:(NSString *)identifier;
+
+/*!
+    @method     eventsMatchingPredicate:
+    @abstract   Searches for events that match the given predicate.
+    @discussion This call executes a search for the events indicated by the predicate passed to it.
+ 
+                It is synchronous. If you want async behavior, you should either use dispatch_async or
+                NSOperation to run the query someplace other than the main thread, and then funnel the
+                array back to the main thread.
+ 
+    @param      predicate   The predicate to invoke. If this predicate was not created with the predicate
+                            creation functions in this class, an exception is raised.
+    @result     An array of EKEvent objects, or nil. There is no guaranteed order to the events.
+*/
+- (NSArray<EKEvent *> *)eventsMatchingPredicate:(NSPredicate *)predicate;
+
+/*!
+    @method     enumerateEventsMatchingPredicate:usingBlock:
+    @abstract   Searches for events that match the given predicate.
+    @discussion This call executes a search for the events indicated by the predicate passed to it, calling
+                the block specified in the callback parameter for each event.
+ 
+                This method is synchronous. If you want async behavior, you should either use dispatch_async or
+                NSOperation to run the query someplace other than the main thread.
+ 
+    @param      predicate   The predicate to invoke. If this predicate was not created with the predicate
+                            creation functions in this class, an exception is raised.
+    @param      block       The block to call for each event. Your block should return YES in the stop
+                            parameter to stop iterating.
+*/
+- (void)enumerateEventsMatchingPredicate:(NSPredicate *)predicate usingBlock:(EKEventSearchCallback)block;
+
+/*!
+    @method     predicateForEventsWithStartDate:endDate:calendars:
+    @abstract   Creates a predicate for use with eventsMatchingPredicate or enumerateEventsMatchingPredicate:usingBlock:.
+    @discussion Creates a simple query predicate to search for events within a certain date range. At present,
+                this will return events in the default time zone ([NSTimeZone defaultTimeZone]).
+
+                For performance reasons, this method will only return events within a four year timespan.
+                If the date range between the startDate and endDate is greater than four years, then it will be shortened 
+                to the first four years.
+ 
+    @param      startDate   The start date.
+    @param      endDate     The end date.
+    @param      calendars   The calendars to search for events in, or nil to search all calendars.
+*/
+- (NSPredicate *)predicateForEventsWithStartDate:(NSDate *)startDate endDate:(NSDate *)endDate calendars:(nullable NSArray<EKCalendar *> *)calendars;
+
+//----------------------------------------------------
+// REMINDERS
+//----------------------------------------------------
+
+/*!
+    @method     saveReminder:commit:error:
+    @abstract   Saves changes to a reminder.
+    @discussion This method attempts to save the reminder to the event store database. It returns YES if
+                successful and NO otherwise. Passing a reminder fetched from another EKEventStore instance
+                into this function will raise an exception.
+
+                After a reminder is successfully saved, its fields are updated to the latest values in
+                the database.
+ 
+                On WatchOS, saving changes is not supported.
+
+    @param      reminder    The reminder to save.
+    @param      commit      Whether to save to the database or not. Pass NO to batch changes together and
+                            commit with [EKEventStore commit:].
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)saveReminder:(EKReminder *)reminder commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 6_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     removeReminder:commit:error:
+    @abstract   Removes a reminder from the event store.
+    @discussion This method attempts to remove the reminder from the event store database. It returns YES if
+                successful and NO otherwise. Passing a reminder from another EKEventStore into this function
+                will raise an exception. After a reminder is removed, it is no longer tied to this event store.
+ 
+                On WatchOS, modifying the database is not supported.
+
+    @param      reminder    The reminder to save.
+    @param      commit      Whether to save to the database or not. Pass NO to batch changes together and
+                            commit with [EKEventStore commit:].
+    @param      error       If an error occurs, this will contain a valid NSError object on exit.
+*/
+- (BOOL)removeReminder:(EKReminder *)reminder commit:(BOOL)commit error:(NSError **)error NS_AVAILABLE(10_8, 6_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     fetchRemindersMatchingPredicate:completion:
+    @abstract   Fetches reminders asynchronously.
+    @discussion This method fetches reminders asynchronously and returns a value which can be
+                used in cancelFetchRequest: to cancel the request later if desired. The completion
+                block is called with an array of reminders that match the given predicate (or potentially nil).
+*/
+- (id)fetchRemindersMatchingPredicate:(NSPredicate *)predicate completion:(void (^)(NSArray<EKReminder *> * __nullable reminders))completion NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @method     cancelFetchRequest:
+    @discussion Given a value returned from fetchRemindersMatchingPredicate, this method can be used to
+                cancel the request. Once called, the completion block specified in fetchReminders... will
+                not be called.
+*/
+- (void)cancelFetchRequest:(id)fetchIdentifier NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @method     predicateForRemindersInCalendars:
+    @abstract   Fetch all reminders in a set of calendars.
+    @discussion You can pass nil for calendars to fetch from all available calendars.
+*/
+- (NSPredicate *)predicateForRemindersInCalendars:(nullable NSArray<EKCalendar *> *)calendars NS_AVAILABLE(10_8, 6_0);
+
+/*!
+    @method     predicateForIncompleteRemindersWithDueDateStarting:ending:calendars:
+    @abstract   Fetch incomplete reminders in a set of calendars.
+    @discussion You can use this method to search for incomplete reminders due in a range.
+                You can pass nil for start date to find all reminders due before endDate.
+                You can pass nil for both start and end date to get all incomplete reminders
+                in the specified calendars.
+                You can pass nil for calendars to fetch from all available calendars.
+*/
+- (NSPredicate *)predicateForIncompleteRemindersWithDueDateStarting:(nullable NSDate *)startDate ending:(nullable NSDate *)endDate calendars:(nullable NSArray<EKCalendar *> *)calendars NS_AVAILABLE(10_8, 6_0);
+
+
+/*!
+    @method     predicateForCompletedRemindersWithCompletionDateStarting:ending:calendars:
+    @abstract   Fetch completed reminders in a set of calendars.
+    @discussion You can use this method to search for reminders completed between a range of dates.
+                You can pass nil for start date to find all reminders completed before endDate.
+                You can pass nil for both start and end date to get all completed reminders
+                in the specified calendars.
+                You can pass nil for calendars to fetch from all available calendars.
+*/
+- (NSPredicate *)predicateForCompletedRemindersWithCompletionDateStarting:(nullable NSDate *)startDate ending:(nullable NSDate *)endDate calendars:(nullable NSArray<EKCalendar *> *)calendars NS_AVAILABLE(10_8, 6_0);
+
+//----------------------------------------------------
+// COMMIT, RESET, ROLLBACK
+//----------------------------------------------------
+
+/*!
+    @method     commit:
+    @abstract   Commits pending changes to the database.
+    @discussion If you use saveCalendar/saveEvent/removeCalendar/removeEvent, etc. and you pass NO to their
+                parameter, you are batching changes for a later commit. This method does that commit. This
+                allows you to save the database only once for many additions or changes.  If you pass
+                YES to methods' commit parameter, then you don't need to call this method.
+ 
+                This method will return YES as long as nothing went awry, even if nothing was actually
+                committed. If it returns NO, error should contain the reason it became unhappy.
+ 
+                On WatchOS, modifying the database is not supported.
+*/
+- (BOOL)commit:(NSError **)error NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+
+/*!
+    @method     reset
+    @abstract   Resets the event store.
+    @discussion You can use this method to forget ALL changes made to the event store (all additions, all
+                fetched objects, etc.). It essentially is as if you released the store and then created a
+                new one. It brings it back to its initial state. All objects ever created/fetched, etc.
+                using this store are no longer connected to it and are considered invalid.
+*/
+- (void)reset NS_AVAILABLE(10_8, 5_0);
+
+/*!
+    @method     refreshSourcesIfNecessary
+    @abstract   Cause a sync to potentially occur taking into account the necessity of it.
+    @discussion You can call this method to pull new data from remote sources.  
+                This only updates the event store's data.  If you want to update your objects after 
+                refreshing the sources, you should call refresh on each of them afterwards.
+                On iOS and macOS, this sync only occurs if deemed necessary.
+                On WatchOS, initiating sync is not available. Sync will occur automatically with the paired iOS device.
+ */
+- (void)refreshSourcesIfNecessary NS_AVAILABLE(10_8, 5_0) __WATCHOS_PROHIBITED;
+
+@end
+
+/*!
+    @constant   EKEventStoreChangedNotification
+    @discussion Notification name sent out when the database is changed by either an external process,
+                another event store in the same process, or by calling saveEvent: or removeEvent: on a
+                store you are managing. When you receive this notification, you should consider all EKEvent
+                instances you have to be invalid. If you had selected events for a date range using
+                eventsMatchingPredicate, etc. for display, you should release them and re-fetch the events
+                again. If you have an event you are actively using (e.g. you are currently viewing details
+                for it or editing it), you can call [EKEvent refresh] to try to revalidate it against the
+                latest state of the database. If that method returns YES, you can continue to use the event,
+                otherwise, you should release it and abandon what you were doing with it. The view
+                controllers provided by EventKitUI automatically deal with this for you.
+                This notification will also be posted if access to events or reminders is changed by the user.
+*/
+EVENTKIT_EXTERN NSString *const EKEventStoreChangedNotification NS_AVAILABLE(10_8, 4_0);
+
+NS_ASSUME_NONNULL_END

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKObject.h

@@ -0,0 +1,34 @@
+//
+//  EKObject.h
+//  EventKit
+//
+//  Copyright 2011 Apple Inc. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+NS_CLASS_AVAILABLE(10_8, 13_0)
+@interface EKObject : NSObject
+
+// Returns YES if this object or any sub-object (alarm, etc.) has uncommitted changes.
+@property (nonatomic, readonly) BOOL hasChanges;
+
+// Returns YES if this object has never been saved.
+#if defined(__cplusplus)
+- (BOOL)isNew;
+#else
+@property (nonatomic, readonly, getter=isNew) BOOL new;
+#endif
+
+// If this object is not new, this method will unload all loaded properties and clear any dirty state
+- (void)reset;
+
+// If this object is not new, this method will unload dirty state only.
+- (void)rollback;
+
+// Determines if the object is still valid (i.e. it still exists in the database), and unloads all
+// properties that have not been modified. If this ever returns NO, it indicates the record was deleted
+// and this instance should be discarded and no longer referenced.
+- (BOOL)refresh;
+
+@end

package/sdk/ios/System/Library/Frameworks/EventKit.framework/Headers/EKParticipant.h

@@ -0,0 +1,115 @@
+//
+//  EKParticipant.h
+//  EventKit
+//
+//  Copyright 2009-2010 Apple Inc. All rights reserved.
+//
+
+#import <EventKit/EventKitDefines.h>
+#import <EventKit/EKObject.h>
+#import <EventKit/EKTypes.h>
+
+#if TARGET_OS_IPHONE
+#if __has_include(<AddressBook/ABPerson.h>)
+#import <AddressBook/ABPerson.h>
+#endif
+typedef CFTypeRef ABRecordRef API_DEPRECATED("use CNContact, CNGroup, or CNContainer", ios(2.0, 9.0));
+typedef CFTypeRef ABAddressBookRef API_DEPRECATED("use CNContactStore", ios(2.0, 9.0));
+#else
+@class ABPerson, ABAddressBook;
+#endif
+
+
+NS_ASSUME_NONNULL_BEGIN
+
+#if !TARGET_OS_IPHONE
+@class ABPerson, ABAddressBook;
+#endif
+
+/*!
+    @class      EKParticipant
+    @abstract   Abstract class representing a participant attached to an event.
+*/
+NS_CLASS_AVAILABLE(10_8, 4_0)
+@interface EKParticipant : EKObject <NSCopying> {
+}
+
+/*!
+    @property   url
+    @abstract   URL representing this participant.
+*/
+@property(nonatomic, readonly) NSURL           *URL;
+
+/*!
+    @property   name
+    @abstract   Name of this participant.
+*/
+@property(nonatomic, readonly, nullable) NSString        *name;
+
+/*!
+    @property   participantStatus
+    @abstract   The status of the attendee.
+    @discussion Returns the status of the attendee as a EKParticipantStatus value.
+*/
+@property(nonatomic, readonly) EKParticipantStatus participantStatus;
+
+/*!
+    @property   participantRole
+    @abstract   The role of the attendee.
+    @discussion Returns the role of the attendee as a EKParticipantRole value.
+*/
+@property(nonatomic, readonly) EKParticipantRole participantRole;
+
+/*!
+    @property   participantType
+    @abstract   The type of the attendee.
+    @discussion Returns the type of the attendee as a EKParticipantType value.
+*/
+@property(nonatomic, readonly) EKParticipantType participantType;
+
+/*!
+    @property   currentUser
+    @abstract   A boolean indicating whether this participant represents the
+                owner of this account.
+ */
+@property(nonatomic, readonly, getter=isCurrentUser) BOOL currentUser NS_AVAILABLE(10_9, 6_0);
+
+/*!
+    @method     contactPredicate
+    @abstract   Returns a predicate to use with Contacts.framework to retrieve the corresponding
+                CNContact instance.
+    @discussion This method returns a predicate that can be used with a CNContactStore to fetch
+                a CNContact instance for this participant, if one exists.
+ */
+@property(nonatomic, readonly) NSPredicate *contactPredicate NS_AVAILABLE(10_11, 9_0);
+
+#if TARGET_OS_IPHONE
+/*!
+ @method     ABRecordWithAddressBook
+ @abstract   Returns the ABRecordRef that represents this participant.
+ @discussion This method returns the ABRecordRef that represents this participant,
+ if a match can be found based on email address in the address book
+ passed. If we cannot find the participant, nil is returned.
+ */
+
+- (nullable ABRecordRef)ABRecordWithAddressBook:(ABAddressBookRef)addressBook API_AVAILABLE(ios(4.0), macCatalyst(14.0)) API_DEPRECATED("Use contactPredicate instead", ios(4.0, 9.0)) API_UNAVAILABLE(watchos)
+#if defined(TARGET_OS_VISION) && TARGET_OS_VISION
+    API_UNAVAILABLE(visionos)
+#endif
+CF_RETURNS_NOT_RETAINED;
+
+#else
+/*!
+ @method     ABPersonInAddressBook
+ @abstract   Returns the ABPerson that represents this participant.
+ @discussion This method returns the ABPerson that represents this participant,
+ if a match can be found based on email address in the address book
+ passed. If we cannot find the participant, nil is returned.
+ */
+- (nullable ABPerson *)ABPersonInAddressBook:(ABAddressBook *)addressBook NS_DEPRECATED_MAC(10_8, 10_11, "Use contactPredicate instead");
+#endif
+
+
+@end
+
+NS_ASSUME_NONNULL_END