Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы EventKit ссылка класса EKEventStore

Опции
Развертывание Target:

На этой странице
Язык:

EKEventStore

Наследование

Соответствует

Оператор импорта

Swift

import EventKit

Objective C

@import EventKit;

Доступность

Доступный в iOS 4.0 и позже.

Экземпляр EKEventStore класс представляет базу данных Calendar. Это - точка контакта приложения для доступа к календарю и данным напоминания.

На iOS 5 и позже, инициализируйте событие, хранят объект со значением по умолчанию init метод. На iOS 6 и позже, необходимо запросить доступ к типу объекта после того, как хранилище события будет инициализировано с requestAccessToEntityType:completion: для данных для возврата.

На OS X использовать initWithAccessToEntityTypes: вместо значения по умолчанию init метод. Приемлемые типы объекта EKEntityMaskEvent для событий и EKEntityMaskReminder для напоминаний.

Создайте предикат или поисковый запрос для событий, с predicateForEventsWithStartDate:endDate:calendars: метод.

Выборка и события процесса, соответствующие данный предикат eventsMatchingPredicate: и enumerateEventsMatchingPredicate:usingBlock: методы.

Сохраните и удалите события из хранилища события с saveEvent:span:commit:error: и removeEvent:span:commit:error: методы.

Используйте похожие методы получить доступ и управлять напоминаниями. Напоминания не доступны в Наборе События перед iOS 6.

Доступ к хранилищу события
  • requestAccessToEntityType (_: завершение:) - requestAccessToEntityType:completion:

    Предлагает пользователю предоставлять или запрещать доступа к данным напоминания или событию.

    Объявление

    Swift

    func requestAccessToEntityType(_ entityType: EKEntityType, completion completion: EKEventStoreRequestAccessCompletionHandler!)

    Objective C

    - (void)requestAccessToEntityType:(EKEntityType)entityType completion:(EKEventStoreRequestAccessCompletionHandler)completion

    Параметры

    entityType

    Событие или тип объекта напоминания.

    completion

    Блок для вызова, когда завершается запрос.

    Обсуждение

    В iOS 6 и позже, запрашивая доступ к хранилищу события асинхронно предлагает Вашим пользователям разрешение использовать их данные. Пользователю только предлагают в первый раз Ваш доступ запросов приложения к типу объекта; любые последующие инстанцирования EKEventStore использует существующие полномочия. Когда пользователь коснется, чтобы предоставить или запретить доступа, обработчик завершения вызовут на произвольной очереди. В то время как пользователь решает предоставить или отклонить разрешение, Ваше приложение не блокируется.

    После того, как пользователи выбирают свой уровень разрешения, хранилище события или вызывает обработчик завершения или широковещательно передает EKEventStoreChangedNotification. Обработчик завершения вызывают на iOS 6 и позже, и уведомление широковещательно передано на iOS 5. Поскольку пользователи могут запретить доступа к хранилищу события, Ваше приложение должно обработать пустой случай данных.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный на iOS 6 и позже.

  • authorizationStatusForEntityType (_:) + authorizationStatusForEntityType:

    Возвращает состояние авторизации для данного типа объекта.

    Объявление

    Swift

    class func authorizationStatusForEntityType(_ entityType: EKEntityType) -> EKAuthorizationStatus

    Objective C

    + (EKAuthorizationStatus)authorizationStatusForEntityType:(EKEntityType)entityType

    Параметры

    entityType

    Событие или тип объекта напоминания.

    Возвращаемое значение

    Состояние авторизации приложения данного типа.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный на iOS 6 и позже.

  • eventStoreIdentifier Свойство

    Уникальный идентификатор для хранилища события. (только для чтения)

    Объявление

    Swift

    var eventStoreIdentifier: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *eventStoreIdentifier

    Обсуждение

    Если хранилище повреждено, оно воссоздано и дано новый идентификатор. Если это значение отличается от выбранного значения, необходимо принять соответствующие меры.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

Доступ к календарям
  • calendars (iOS 6.0) Свойство

    Календари связались с хранилищем события как массив EKCalendar объекты. (только для чтения)

    Объявление

    Objective C

    @property(nonatomic, readonly) NSArray *calendars

    Специальные замечания

    Оператор импорта

    Objective C

    @import EventKit;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    – calendarsForEntityType:

  • defaultCalendarForNewEvents Свойство

    Календарь, что события добавляются к по умолчанию, как указано пользовательскими настройками. (только для чтения)

    Объявление

    Swift

    var defaultCalendarForNewEvents: EKCalendar! { get }

    Objective C

    @property(nonatomic, readonly) EKCalendar *defaultCalendarForNewEvents

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

  • defaultCalendarForNewReminders () defaultCalendarForNewReminders Свойство

    Календарь, что события добавляются к по умолчанию, как указано пользовательскими настройками. (только для чтения)

    Объявление

    Swift

    func defaultCalendarForNewReminders() -> EKCalendar!

    Objective C

    - (EKCalendar *)defaultCalendarForNewReminders

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • calendarWithIdentifier (_:) - calendarWithIdentifier:

    Возвращает календарь с указанным идентификатором.

    Объявление

    Swift

    func calendarWithIdentifier(_ identifier: String!) -> EKCalendar!

    Objective C

    - (EKCalendar *)calendarWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Уникальный идентификатор календаря.

    Возвращаемое значение

    Календарь с указанным идентификатором.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • calendarsForEntityType (_:) - calendarsForEntityType:

    Календари возвратов, поддерживающие данный тип объекта, такой как напоминания или события.

    Объявление

    Swift

    func calendarsForEntityType(_ entityType: EKEntityType) -> [AnyObject]!

    Objective C

    - (NSArray *)calendarsForEntityType:(EKEntityType)entityType

    Параметры

    entityType

    Тип объекта календаря.

    Возвращаемое значение

    Календарь, поддерживающий указанный тип объекта.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    EKEntityType

Сохранение и удаление календарей
  • saveCalendar (_: commit:error:) - saveCalendar:commit:error:

    Сохраняет календарь к хранилищу события или фиксацией или пакетной обработкой изменений.

    Объявление

    Swift

    func saveCalendar(_ calendar: EKCalendar!, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)saveCalendar:(EKCalendar *)calendar commit:(BOOL)commit error:(NSError **)error

    Параметры

    calendar

    Календарь, который будет сохранен.

    commit

    YEStrue сохранить календарь сразу; иначе, изменение обрабатывается в пакетном режиме до commit: метод вызывается.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    YEStrue если успешный; иначе, NOfalse.

    Обсуждение

    Этот метод повышает исключение если calendar принадлежит другому хранилищу события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    – фиксация:
    – removeCalendar:commit:error:

  • removeCalendar (_: commit:error:) - removeCalendar:commit:error:

    Удаляет календарь из хранилища события или пакетной обработкой или фиксацией изменений.

    Объявление

    Swift

    func removeCalendar(_ calendar: EKCalendar!, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeCalendar:(EKCalendar *)calendar commit:(BOOL)commit error:(NSError **)error

    Параметры

    calendar

    Календарь, который будет удален.

    commit

    YEStrue удалить календарь сразу; иначе, изменение обрабатывается в пакетном режиме до commit: метод вызывается.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    YEStrue если успешный; иначе, NOfalse.

    Обсуждение

    Этот метод повышает исключение если calendar принадлежит другому хранилищу события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    – фиксация:
    – saveCalendar:commit:error:

Доступ к событиям
  • eventWithIdentifier (_:) - eventWithIdentifier:

    Возвращает первое возникновение события с данным идентификатором.

    Объявление

    Swift

    func eventWithIdentifier(_ identifier: String!) -> EKEvent!

    Objective C

    - (EKEvent *)eventWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Идентификатор события.

    Возвращаемое значение

    Соответствие события identifier, или nil если не учреждено никакое мероприятие.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

  • eventsMatchingPredicate (_:) - eventsMatchingPredicate:

    Возвраты все события, соответствующие данный предикат.

    Объявление

    Swift

    func eventsMatchingPredicate(_ predicate: NSPredicate!) -> [AnyObject]!

    Objective C

    - (NSArray *)eventsMatchingPredicate:(NSPredicate *)predicate

    Параметры

    predicate

    Поисковый предикат. Должен быть создан с predicateForEventsWithStartDate:endDate:calendars: метод.

    Возвращаемое значение

    Все события то соответствие predicate, как массив EKEvent объекты.

    Обсуждение

    Только фиксировавшиеся события включены в результаты. События сохранили использование saveEvent:span:commit:error: с commit набор параметра к NOfalse должен вызвать commit: заранее быть включенным.

    Этот метод синхронен. Для асинхронного поведения, выполненного метод на другом потоке с dispatch_async или NSOperation.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – enumerateEventsMatchingPredicate:usingBlock:
    – predicateForEventsWithStartDate:endDate:calendars:

  • enumerateEventsMatchingPredicate (_: usingBlock:) - enumerateEventsMatchingPredicate:usingBlock:

    Находит все события, соответствующие данный предикат, и вызывает данный обратный вызов для каждого учрежденного мероприятия.

    Объявление

    Swift

    func enumerateEventsMatchingPredicate(_ predicate: NSPredicate!, usingBlock block: EKEventSearchCallback!)

    Objective C

    - (void)enumerateEventsMatchingPredicate:(NSPredicate *)predicate usingBlock:(EKEventSearchCallback)block

    Параметры

    predicate

    Поисковый предикат. Должен быть создан с predicateForEventsWithStartDate:endDate:calendars: метод.

    block

    Блочный обратный вызов для требования к каждому событию. Обратный вызов должен соответствовать подпись, определенную EKEventSearchCallback.

    Обсуждение

    Только фиксировавшиеся события включены в перечисление. События сохранили использование saveEvent:span:commit:error: с commit набор параметра к NOfalse должен вызвать commit: заранее быть включенным.

    Этот метод синхронен. Для асинхронного поведения, выполненного метод на другом потоке с dispatch_async или NSOperation.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – eventsMatchingPredicate:
    EKEventSearchCallback
    – predicateForEventsWithStartDate:endDate:calendars:

  • predicateForEventsWithStartDate (_: endDate:calendars:) - predicateForEventsWithStartDate:endDate:calendars:

    Создает и возвращает предикат для нахождения, что события в конечном счете хранят, которые находятся в пределах данного диапазона дат.

    Объявление

    Swift

    func predicateForEventsWithStartDate(_ startDate: NSDate!, endDate endDate: NSDate!, calendars calendars: [AnyObject]!) -> NSPredicate!

    Objective C

    - (NSPredicate *)predicateForEventsWithStartDate:(NSDate *)startDate endDate:(NSDate *)endDate calendars:(NSArray *)calendars

    Параметры

    startDate

    Дата начала диапазона событий выбирается.

    endDate

    Дата окончания диапазона событий выбирается.

    calendars

    Календари для поиска, как массив EKCalendar объекты. Передача nil указывает для поиска всех календарей.

    Возвращаемое значение

    Создаваемый предикат.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – eventsMatchingPredicate:
    – enumerateEventsMatchingPredicate:usingBlock:

Сохранение и удаление событий
  • saveEvent (_: span:error:) - saveEvent:span:error:

    Сохраняет изменения в событии постоянно.

    Объявление

    Swift

    func saveEvent(_ event: EKEvent!, span span: EKSpan, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)saveEvent:(EKEvent *)event span:(EKSpan)span error:(NSError **)error

    Параметры

    event

    Событие, которое будет сохранено.

    span

    Промежуток для использования. Указывает, влияет ли сохранение на будущие экземпляры события в случае повторяющегося события.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    Если событие успешно сохранило, YEStrue; иначе, NOfalse. Также возвраты NOfalse если event не должен быть сохранен, потому что это не было изменено.

    Обсуждение

    Этот метод повышает исключение, если он передается событие от другого хранилища события.

    Когда событие сохраняется, оно обновляется в базе данных Calendar. Любые поля, которые Вы не изменяли, обновляются для отражения нового значения в базе данных. Если событие было удалено из базы данных, оно воссоздается как новое событие.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – saveEvent:span:commit:error:
    – removeEvent:span:error:
    – removeEvent:span:commit:error:

  • saveEvent (_: span:commit:error:) - saveEvent:span:commit:error:

    Сохраняет событие или повторяющиеся события к хранилищу события или пакетной обработкой или фиксацией изменений.

    Объявление

    Swift

    func saveEvent(_ event: EKEvent!, span span: EKSpan, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)saveEvent:(EKEvent *)event span:(EKSpan)span commit:(BOOL)commit error:(NSError **)error

    Параметры

    event

    Событие, которое будет сохранено.

    span

    Промежуток для использования. Указывает, влияет ли сохранение на будущие экземпляры события в случае повторяющегося события.

    commit

    Сохранить событие сразу, передачу YEStrue; иначе, изменение обрабатывается в пакетном режиме до commit: метод вызывается.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    Если успешный, YEStrue; иначе, NOfalse. Также возвраты NOfalse если event не должен быть сохранен, потому что это не было изменено.

    Обсуждение

    Этот метод повышает исключение, если он передается событие от другого хранилища события.

    Когда событие сохраняется, оно обновляется в базе данных Calendar. Любые поля, которые Вы не изменяли, обновляются для отражения нового значения в базе данных. Если событие было удалено из базы данных, оно воссоздается как новое событие.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    – фиксация:
    – saveEvent:span:error:
    – removeEvent:span:error:
    – removeEvent:span:commit:error:

  • removeEvent (_: span:error:) - removeEvent:span:error:

    Удаляет событие из хранилища события.

    Объявление

    Swift

    func removeEvent(_ event: EKEvent!, span span: EKSpan, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeEvent:(EKEvent *)event span:(EKSpan)span error:(NSError **)error

    Параметры

    event

    Событие, которое будет удалено.

    span

    Промежуток для использования. Указывает, удалить ли будущие экземпляры события в случае повторяющегося события.

    error

    Ошибка, если один произошел; иначе, nil.

    Возвращаемое значение

    Если событие успешно удалило, YEStrue; иначе, NOfalse. Также возвраты NOfalse если event не может быть удален, потому что это не в конечном счете хранилище.

    Обсуждение

    Этот метод повышает исключение, если он передается событие от другого хранилища события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – saveEvent:span:error:
    – saveEvent:span:commit:error:
    – removeEvent:span:commit:error:

  • removeEvent (_: span:commit:error:) - removeEvent:span:commit:error:

    Удаляет событие или повторяющиеся события от хранилища события или пакетной обработкой или фиксацией изменений.

    Объявление

    Swift

    func removeEvent(_ event: EKEvent!, span span: EKSpan, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeEvent:(EKEvent *)event span:(EKSpan)span commit:(BOOL)commit error:(NSError **)error

    Параметры

    event

    Событие для удаления.

    span

    Промежуток для использования. Указывает ли удалить экземпляры будущего влияния события в случае повторяющегося события.

    commit

    YEStrue удалить событие сразу; иначе, изменение обрабатывается в пакетном режиме до commit: метод вызывается.

    error

    Ошибка, произошедшая, если кто-либо сделал. Иначе, nil.

    Возвращаемое значение

    Если событие успешно удалило, YEStrue; иначе, NOfalse. Также возвраты NOfalse если event не может быть удален, потому что это не в конечном счете хранилище.

    Обсуждение

    Этот метод повышает исключение, если он передается событие от другого хранилища события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    – фиксация:
    – removeEvent:span:error:
    – saveEvent:span:error:
    – saveEvent:span:commit:error:

Доступ к напоминаниям
  • fetchRemindersMatchingPredicate (_: завершение:) - fetchRemindersMatchingPredicate:completion:

    Напоминания о выборках, соответствующие данный предикат.

    Объявление

    Swift

    func fetchRemindersMatchingPredicate(_ predicate: NSPredicate!, completion completion: (([AnyObject]!) -> Void)!) -> AnyObject!

    Objective C

    - (id)fetchRemindersMatchingPredicate:(NSPredicate *)predicate completion:(void (^)(NSArray *reminders))completion

    Параметры

    predicate

    Поисковый предикат.

    completion

    Массив соответствующих напоминаний передается ссылкой.

    Возвращаемое значение

    Значение, которое будет использоваться в cancelFetchRequest: отменять запрос позже при желании.

    Обсуждение

    Только фиксировавшиеся напоминания включены в результаты. Напоминания сохранили использование saveReminder:commit:error: с commit набор параметра к NOfalse должен вызвать commit: заранее быть включенным.

    Этот метод выбирает напоминания асинхронно.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – predicateForRemindersInCalendars:
    – predicateForIncompleteRemindersWithDueDateStarting:ending:calendars:
    – predicateForCompletedRemindersWithCompletionDateStarting:ending:calendars:

  • predicateForRemindersInCalendars (_:) - predicateForRemindersInCalendars:

    Выборки все напоминания в ряде календарей.

    Объявление

    Swift

    func predicateForRemindersInCalendars(_ calendars: [AnyObject]!) -> NSPredicate!

    Objective C

    - (NSPredicate *)predicateForRemindersInCalendars:(NSArray *)calendars

    Параметры

    calendars

    Массив календарей для поиска.

    Возвращаемое значение

    Создаваемый предикат, который будет использоваться для fetchRemindersMatchingPredicate:completion:.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • predicateForIncompleteRemindersWithDueDateStarting (_: ending:calendars:) - predicateForIncompleteRemindersWithDueDateStarting:ending:calendars:

    Выбирает неполные напоминания в ряде календарей в дополнительном диапазоне.

    Объявление

    Swift

    func predicateForIncompleteRemindersWithDueDateStarting(_ startDate: NSDate!, ending endDate: NSDate!, calendars calendars: [AnyObject]!) -> NSPredicate!

    Objective C

    - (NSPredicate *)predicateForIncompleteRemindersWithDueDateStarting:(NSDate *)startDate ending:(NSDate *)endDate calendars:(NSArray *)calendars

    Параметры

    startDate

    Запуск, обязанный диапазона искать.

    endDate

    Окончание, обязанное диапазона искать.

    calendars

    Массив календарей для поиска.

    Возвращаемое значение

    Создаваемый предикат, который будет использоваться для fetchRemindersMatchingPredicate:completion:.

    Обсуждение

    Передача nil для startDate счесть все напоминания должными прежде endDate. Точно так же передача nil для обоих startDate и endDate получить все неполные напоминания в указанных календарях.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • predicateForCompletedRemindersWithCompletionDateStarting (_: ending:calendars:) - predicateForCompletedRemindersWithCompletionDateStarting:ending:calendars:

    Выборки завершили напоминания в ряде календарей в дополнительном диапазоне.

    Объявление

    Swift

    func predicateForCompletedRemindersWithCompletionDateStarting(_ startDate: NSDate!, ending endDate: NSDate!, calendars calendars: [AnyObject]!) -> NSPredicate!

    Objective C

    - (NSPredicate *)predicateForCompletedRemindersWithCompletionDateStarting:(NSDate *)startDate ending:(NSDate *)endDate calendars:(NSArray *)calendars

    Параметры

    startDate

    Запуск, обязанный диапазона искать.

    endDate

    Окончание, обязанное диапазона искать.

    calendars

    Массив календарей для поиска.

    Возвращаемое значение

    Создаваемый предикат, который будет использоваться для fetchRemindersMatchingPredicate:completion:.

    Обсуждение

    Передача nil для startDate найти все напоминания завершилось прежде endDate. Точно так же передача nil для обоих startDate и endDate получить все полные напоминания в указанных календарях.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • cancelFetchRequest (_:) - cancelFetchRequest:

    Отменяет запрос для выборки напоминаний.

    Объявление

    Swift

    func cancelFetchRequest(_ fetchIdentifier: AnyObject!)

    Objective C

    - (void)cancelFetchRequest:(id)fetchIdentifier

    Параметры

    fetchIdentifier

    Идентификатор запроса, как возвращено fetchRemindersMatchingPredicate:completion:.

    Обсуждение

    После того, как вызванный, блок завершения, указанный в fetchRemindersMatchingPredicate:completion: не будет вызван.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

Сохранение и удаление напоминаний
  • saveReminder (_: commit:error:) - saveReminder:commit:error:

    Сохраняет изменения в напоминании или фиксацией или пакетной обработкой изменений.

    Объявление

    Swift

    func saveReminder(_ reminder: EKReminder!, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)saveReminder:(EKReminder *)reminder commit:(BOOL)commit error:(NSError **)error

    Параметры

    reminder

    Напоминание, которое будет сохранено.

    commit

    Булево значение, указывающее, сохранить ли сразу напоминание или обрабатывать изменения в пакетном режиме; передача NOfalse не передаст изменения в хранилище события до commit: метод вызывается.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    Если успешный, YEStrue; иначе, NOfalse.

    Обсуждение

    Этот метод повышает исключение если reminder принадлежит другому хранилищу события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – фиксация:
    – removeReminder:commit:error:

  • removeReminder (_: commit:error:) - removeReminder:commit:error:

    Удаляет напоминание из хранилища события или фиксацией или пакетной обработкой изменений.

    Объявление

    Swift

    func removeReminder(_ reminder: EKReminder!, commit commit: Bool, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)removeReminder:(EKReminder *)reminder commit:(BOOL)commit error:(NSError **)error

    Параметры

    reminder

    Напоминание, которое будет удалено.

    commit

    Булево значение, указывающее, удалить ли сразу напоминание или обрабатывать удаления в пакетном режиме; передача NOfalse не будет фиксировать удаление из хранилища события до commit: метод вызывается.

    error

    Ошибка, произошедшая, если таковые имеются иначе, nil.

    Возвращаемое значение

    Если успешный, YEStrue; иначе, NOfalse.

    Обсуждение

    Этот метод повышает исключение если reminder принадлежит другому хранилищу события.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – фиксация:
    – saveReminder:commit:error:

Доступ к событиям или напоминаниям
  • calendarItemWithIdentifier (_:) - calendarItemWithIdentifier:

    Возвраты или первое возникновение события или напоминание с указанным идентификатором.

    Объявление

    Swift

    func calendarItemWithIdentifier(_ identifier: String!) -> EKCalendarItem!

    Objective C

    - (EKCalendarItem *)calendarItemWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Уникальный идентификатор объекта календаря.

    Возвращаемое значение

    Напоминание или первое возникновение события с указанным идентификатором.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • calendarItemsWithExternalIdentifier (_:) - calendarItemsWithExternalIdentifier:

    Возвраты или первые случаи события или напоминания с указанным внешним идентификатором.

    Объявление

    Swift

    func calendarItemsWithExternalIdentifier(_ externalIdentifier: String!) -> [AnyObject]!

    Objective C

    - (NSArray *)calendarItemsWithExternalIdentifier:(NSString *)externalIdentifier

    Параметры

    externalIdentifier

    Внешний идентификатор объекта календаря.

    Возвращаемое значение

    Массив объектов календаря с указанным идентификатором.

    Обсуждение

    Внешний идентификатор может быть получен из calendarItemExternalIdentifier свойства. Может быть больше чем один соответствующий объект календаря вследствие причин, обсужденных в calendarItemExternalIdentifier.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

Доступ к источникам
  • источники () - источники

    Возвращает неупорядоченный массив исходных объектов.

    Объявление

    Swift

    func sources() -> [AnyObject]!

    Objective C

    - (NSArray *)sources

    Возвращаемое значение

    Неупорядоченный массив EKSource объекты.

    Обсуждение

    Объект EKSource представляет учетную запись, содержащую календари.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • sourceWithIdentifier (_:) - sourceWithIdentifier:

    Возвращает источник с указанным идентификатором.

    Объявление

    Swift

    func sourceWithIdentifier(_ identifier: String!) -> EKSource!

    Objective C

    - (EKSource *)sourceWithIdentifier:(NSString *)identifier

    Параметры

    identifier

    Уникальный идентификатор источника.

    Возвращаемое значение

    Источник с указанным идентификатором.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

Сохранение и восстановление состояния
  • фиксация (_:) - фиксация:

    Передает все несохраненные изменения в хранилище события.

    Объявление

    Swift

    func commit(_ error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)commit:(NSError **)error

    Параметры

    error

    Указатель на NSError объект. Вы не должны создавать NSError объект. Аварийные прекращения работы работы фиксации после первого отказа, если Вы передаете NULL.

    Возвращаемое значение

    Если работа фиксации успешно выполнилась, YEStrue; иначе, NOfalse. Возвраты YEStrue даже когда нет никаких изменений в фиксации.

    Обсуждение

    Этот метод позволяет Вам сохранять обработанные в пакетном режиме изменения в хранилище события. Например, если Вы передаете NOfalse как commit параметр к saveCalendar:commit:error:, removeCalendar:commit:error:, saveEvent:span:commit:error:, или removeEvent:span:commit:error: методы, изменения не сохраняются, пока этот метод не вызывается. Аналогично, если Вы передаете YEStrue как commit параметр к вышеупомянутым методам, нет никакой потребности вызвать этот метод.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

  • сброс () - сброс

    Возвращает хранилище события его сохраненному состоянию.

    Объявление

    Swift

    func reset()

    Objective C

    - (void)reset

    Обсуждение

    Этот метод обновляет все свойства всех объектов с их соответствующими значениями, в конечном счете хранят. Будут потеряны любые локальные изменения, не сохраненные прежде, чем вызвать этот метод. Все объекты, создававшиеся или получившие использование этого хранилища, разъединяют с ним и нужно считать недопустимыми.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

    См. также

    сброс

  • refreshSourcesIfNecessary () - refreshSourcesIfNecessary

    Вытягивает новые данные из удаленных источников при необходимости.

    Объявление

    Swift

    func refreshSourcesIfNecessary()

    Objective C

    - (void)refreshSourcesIfNecessary

    Обсуждение

    Используйте этот метод для получения по запросу новых данных из удаленных источников, если локальные данные устарели.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 5.0 и позже.

Типы данных

  • EKEventStoreRequestAccessCompletionHandler

    Подпись для блочного объекта, используемого для работы на событиях с requestAccessToEntityType:completion: метод.

    Объявление

    Swift

    typealias EKEventStoreRequestAccessCompletionHandler = (Bool, NSError!) -> Void

    Objective C

    typedef void (^EKEventStoreRequestAccessCompletionHandler)(BOOL granted, NSError *error);

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • EKEventSearchCallback

    Подпись для блочного объекта, используемого для работы на событиях с enumerateEventsMatchingPredicate:usingBlock: метод.

    Объявление

    Swift

    typealias EKEventSearchCallback = (EKEvent!, UnsafeMutablePointer<ObjCBool>) -> Void

    Objective C

    typedef void (^EKEventSearchCallback)(EKEvent *event, BOOL *stop);

    Обсуждение

    event параметром является событие для работы на. Можно установить значение stop параметр YEStrue сказать enumerateEventsMatchingPredicate:usingBlock: метод, чтобы прекратить обрабатывать события, когда возвращается этот блок.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

Константы
  • EKSpan

    Указывает, должны ли модификации примениться к единственному событию или всем будущим событиям повторяющегося события.

    Объявление

    Swift

    struct EKSpan { init(_ value: UInt32) var value: UInt32 }

    Objective C

    typedef enum { EKSpanThisEvent, EKSpanFutureEvents } EKSpan;

    Константы

    • EKSpanThisEvent

      Модификации к этому экземпляру события должны влиять только на этот экземпляр.

      Доступный в iOS 4.0 и позже.

    • EKSpanFutureEvents

      Модификации к этому экземпляру события должны также влиять на будущие экземпляры этого события.

      Доступный в iOS 4.0 и позже.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.

  • EKAuthorizationStatus

    Указывает текущее состояние авторизации для определенного типа объекта.

    Объявление

    Swift

    enum EKAuthorizationStatus : Int { case NotDetermined case Restricted case Denied case Authorized }

    Objective C

    typedef enum { EKAuthorizationStatusNotDetermined = 0, EKAuthorizationStatusRestricted, EKAuthorizationStatusDenied, EKAuthorizationStatusAuthorized } EKAuthorizationStatus;

    Константы

    • NotDetermined

      EKAuthorizationStatusNotDetermined

      Пользователь еще не сделал выбор относительно того, может ли приложение получить доступ к службе.

      Доступный в iOS 6.0 и позже.

    • Restricted

      EKAuthorizationStatusRestricted

      Приложение не разрешено получить доступ к службе. Пользователь не может изменить состояние авторизации этого приложения, возможно вследствие активных ограничений, таких как существующий родительский контроль.

      Доступный в iOS 6.0 и позже.

    • Denied

      EKAuthorizationStatusDenied

      Пользователь явно запретил доступа к службе для приложения.

      Доступный в iOS 6.0 и позже.

    • Authorized

      EKAuthorizationStatusAuthorized

      Приложение разрешено получить доступ к службе.

      Доступный в iOS 6.0 и позже.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 6.0 и позже.

Уведомления
  • EKEventStoreChangedNotification EKEventStoreChangedNotification

    Отправленный каждый раз, когда изменения внесены в базу данных Calendar, включая добавление, удаление и изменение событий или напоминаний. Отдельные изменения не описаны. При получении этого уведомления необходимо повторно выбрать все EKEvent и EKReminder объекты, к которым Вы получили доступ, поскольку их считают устаревшими. Если Вы активно редактируете событие и не хотите повторно выбирать его, если это не абсолютно необходимо для этого, что можно вызвать refresh метод на нем. Если возвращается метод YEStrue, Вы не должны повторно выбирать событие.

    Оператор импорта

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в iOS 4.0 и позже.