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

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

Разработчик

Ссылка платформы основы ссылка класса NSExtensionContext

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

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

NSExtensionContext

NSExtensionContext объект представляет контекст приложения узла, от которого вызывается расширение приложения.

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

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

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

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Обрабатывание запросов
  • cancelRequestWithError (_:) - cancelRequestWithError:

    Говорит приложению узла отменять запрос расширения приложения, с предоставленной ошибкой.

    Объявление

    Swift

    func cancelRequestWithError(_ error: NSError)

    Objective C

    - (void)cancelRequestWithError:(NSError *)error

    Параметры

    error

    Ошибочный объект возвратиться. Это должно быть не -nil.

    Обсуждение

    По возврату, userInfo словарь NSError объект содержит названный ключ NSExtensionItemsAndErrorsKey который имеет как его значение словарь NSExtensionItem объекты и связанный NSError экземпляры.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • completeRequestReturningItems (_: completionHandler:) - completeRequestReturningItems:completionHandler:

    Говорит приложению узла завершать запрос расширения приложения с массивом элементов результата.

    Объявление

    Swift

    func completeRequestReturningItems(_ items: [AnyObject]?, completionHandler completionHandler: ((Bool) -> Void)?)

    Objective C

    - (void)completeRequestReturningItems:(NSArray *)items completionHandler:(void (^)(BOOL expired))completionHandler

    Параметры

    items

    Массив элементов результата, каждый NSExtensionItem объект, для возврата к приложению узла.

    completionHandler

    Дополнительный блок, который вызовут, когда запрос завершается, выполняемый как фоновая приоритетная задача.

    Блок берет следующий параметр:

    expired

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

    Этот параметр YEStrue когда система преждевременно завершает a completionHandler блок, ранее вызванный и иначе не истекший.

    Обсуждение

    Вызов этого метода в конечном счете отклоняет контроллер представления расширения приложения.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Открытие URLs
  • openURL (_: completionHandler:) - openURL:completionHandler:

    Просит система открывать URL от имени расширения в настоящее время запущенного приложения.

    Объявление

    Swift

    func openURL(_ URL: NSURL, completionHandler completionHandler: ((Bool) -> Void)?)

    Objective C

    - (void)openURL:(NSURL *)URL completionHandler:(void (^)(BOOL success))completionHandler

    Параметры

    URL

    URL для открытия.

    completionHandler

    Блок, который вызовут, когда открылся URL.

    Блок берет следующий параметр:

    success

    Булево значение, указывающее, была ли операция открытия успешна.

    Обсуждение

    Каждая точка расширения определяет, поддерживать ли этот метод, или под который условия поддерживать этот метод. В iOS 8 только Сегодня точка расширения (используемый для создания Сегодня виджетов) поддерживает этот метод.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Хранение дополнительных элементов
  • inputItems inputItems Свойство

    Список ввода NSExtensionItem объекты связались с контекстом. (только для чтения)

    Объявление

    Swift

    var inputItems: [AnyObject] { get }

    Objective C

    @property(readonly, copy, atomic) NSArray *inputItems

    Обсуждение

    Если контекст не имеет никаких входных элементов, этот массив пуст.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Константы
  • Дополнительный ключ элементов и ошибок

    Этот ключ используется в userInfo словарь NSError объект, возвращенный cancelRequestWithError:.

    Объявление

    Swift

    let NSExtensionItemsAndErrorsKey: NSString!

    Objective C

    NSString *const NSExtensionItemsAndErrorsKey;

    Константы

    • NSExtensionItemsAndErrorsKey

      NSExtensionItemsAndErrorsKey

      Ключ, значение которого является словарем NSExtensionItem объекты и связанный NSError экземпляры.

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