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

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

Разработчик

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

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

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

EKEvent

Экземпляр EKEvent класс представляет событие, добавленное к календарю в конечном счете платформа Кита.

Используйте eventWithEventStore: метод для создания нового события. Используйте свойства в классе, чтобы получить и изменить определенную информацию о событии. Другие свойства, такие как заголовок и календарь события, наследованы от родительского класса EKCalendarItem.

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

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

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

Swift

import EventKit

Objective C

@import EventKit;

Доступность

Доступный в OS X v10.8 и позже.

Создание событий
  • init (eventStore:) + eventWithEventStore:

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

    Объявление

    Swift

    init!(eventStore eventStore: EKEventStore!) -> EKEvent

    Objective C

    + (EKEvent *)eventWithEventStore:(EKEventStore *)eventStore

    Параметры

    eventStore

    Хранилище события, которому принадлежит событие.

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

    Создаваемое событие.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

Доступ к свойствам события
  • eventIdentifier eventIdentifier Свойство

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

    Объявление

    Swift

    var eventIdentifier: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *eventIdentifier

    Обсуждение

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

    Если календарь события изменяется, его идентификатор наиболее вероятно изменяется также.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • доступность доступность Свойство

    Установка доступности для события.

    Объявление

    Swift

    var availability: EKEventAvailability

    Objective C

    @property(nonatomic) EKEventAvailability availability

    Обсуждение

    Эта установка используется CalDAV и серверами Exchange, чтобы указать, как событие нужно лечить от планирования целей.

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

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

    См. также

    EKEventAvailability

  • startDate startDate Свойство

    Дата начала события.

    Объявление

    Swift

    @NSCopying var startDate: NSDate!

    Objective C

    @property(nonatomic, copy) NSDate *startDate

    Обсуждение

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

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • endDate endDate Свойство

    Дата окончания события.

    Объявление

    Swift

    @NSCopying var endDate: NSDate!

    Objective C

    @property(nonatomic, copy) NSDate *endDate

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • действующий на протяжении всего дня действующий на протяжении всего дня Свойство

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

    Объявление

    Swift

    var allDay: Bool

    Objective C

    @property(nonatomic, getter=isAllDay) BOOL allDay

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • occurrenceDate occurrenceDate Свойство

    Исходная дата возникновения события, если это - часть повторяющегося ряда. (только для чтения)

    Объявление

    Swift

    var occurrenceDate: NSDate! { get }

    Objective C

    @property(nonatomic, readonly) NSDate *occurrenceDate

    Обсуждение

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

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

    Это свойство не доступно на iOS.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • isDetached isDetached Свойство

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

    Объявление

    Swift

    var isDetached: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL isDetached

    Обсуждение

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

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • организатор организатор Свойство

    Организатор связался с событием. (только для чтения)

    Объявление

    Swift

    var organizer: EKParticipant! { get }

    Objective C

    @property(nonatomic, readonly) EKParticipant *organizer

    Обсуждение

    Это свойство nil если событие не имеет никакого организатора.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • состояние состояние Свойство

    Состояние события. (только для чтения)

    Объявление

    Swift

    var status: EKEventStatus { get }

    Objective C

    @property(nonatomic, readonly) EKEventStatus status

    Обсуждение

    Необходимо действовать на основе состояния события, только если состояние EKEventStatusCanceled, который указывает, что было отменено событие. Другие состояния нужно считать информационными.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

    См. также

    EKEventStatus

  • birthdayPersonUniqueID birthdayPersonUniqueID Свойство

    Идентификатор записи платформы Адресной книги лица для этого события дня рождения. (только для чтения)

    Объявление

    Swift

    var birthdayPersonUniqueID: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *birthdayPersonUniqueID

    Обсуждение

    Это свойство только установлено, если это - событие дня рождения; иначе свойство nil.

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

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

Сравнение событий
  • compareStartDateWithEvent (_:) - compareStartDateWithEvent:

    Сравнивает дату начала события получения с датой начала другого события.

    Объявление

    Swift

    func compareStartDateWithEvent(_ other: EKEvent!) -> NSComparisonResult

    Objective C

    - (NSComparisonResult)compareStartDateWithEvent:(EKEvent *)other

    Параметры

    other

    Событие для сравнения с.

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

    • NSOrderedAscending если дата начала получателя предшествует дате начала other.

    • NSOrderedSame если даты начала этих двух событий идентичны.

    • NSOrderedDescending если дата начала получателя прибывает после даты начала other.

    Обсуждение

    Можно передать селектор для этого метода к методу NSArray sortedArrayUsingSelector: создать массив событий, сортированных датой начала.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

Обновление данных о событии
  • обновление () - обновление

    Обновляет данные события с текущей информацией в базе данных Calendar.

    Объявление

    Swift

    func refresh() -> Bool

    Objective C

    - (BOOL)refresh

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

    Если событие было успешно обновлено, YEStrue; иначе, NOfalse.

    Обсуждение

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

    Этот метод не заменяет значения никаких свойств, которые Вы изменили.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

Типы данных

  • EKEventAvailability EKEventAvailability

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

    Объявление

    Swift

    struct EKEventAvailability { init(_ value: Int32) var value: Int32 }

    Objective C

    typedef enum { EKEventAvailabilityNotSupported = -1, EKEventAvailabilityBusy = 0, EKEventAvailabilityFree, EKEventAvailabilityTentative, EKEventAvailabilityUnavailable } EKEventAvailability;

    Константы

    • EKEventAvailabilityNotSupported

      EKEventAvailabilityNotSupported

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

      Доступный в OS X v10.8 и позже.

    • EKEventAvailabilityBusy

      EKEventAvailabilityBusy

      Событие имеет занятую установку доступности.

      Доступный в OS X v10.8 и позже.

    • EKEventAvailabilityFree

      EKEventAvailabilityFree

      Событие имеет свободную установку доступности.

      Доступный в OS X v10.8 и позже.

    • EKEventAvailabilityTentative

      EKEventAvailabilityTentative

      Событие имеет предварительную установку доступности.

      Доступный в OS X v10.8 и позже.

    • EKEventAvailabilityUnavailable

      EKEventAvailabilityUnavailable

      Событие имеет недоступную установку доступности.

      Доступный в OS X v10.8 и позже.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.

  • EKEventStatus EKEventStatus

    Состояние события.

    Объявление

    Swift

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

    Objective C

    typedef enum { EKEventStatusNone = 0, EKEventStatusConfirmed, EKEventStatusTentative, EKEventStatusCanceled, } EKEventStatus;

    Константы

    • EKEventStatusNone

      EKEventStatusNone

      Событие не имеет никакого состояния.

      Доступный в OS X v10.8 и позже.

    • EKEventStatusConfirmed

      EKEventStatusConfirmed

      Событие подтверждено.

      Доступный в OS X v10.8 и позже.

    • EKEventStatusTentative

      EKEventStatusTentative

      Событие является предварительным.

      Доступный в OS X v10.8 и позже.

    • EKEventStatusCanceled

      EKEventStatusCanceled

      Событие отменяется.

      Доступный в OS X v10.8 и позже.

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

    Objective C

    @import EventKit;

    Swift

    import EventKit

    Доступность

    Доступный в OS X v10.8 и позже.