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

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

Разработчик

Ссылка платформы NotificationCenter ссылка на протокол NCWidgetProviding

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

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

NCWidgetProviding

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

Не применимый

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

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

Swift

import NotificationCenter

Objective C

@import NotificationCenter;

Доступность

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

NCWidgetProviding протокол позволяет Вам настроить часть появления, и поведение виджета (виджет является расширением в представлении Today).

Настройка граничных вставок
  • widgetMarginInsetsForProposedMarginInsets (_:) - widgetMarginInsetsForProposedMarginInsets:

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

    Объявление

    Swift

    optional func widgetMarginInsetsForProposedMarginInsets(_ defaultMarginInsets: UIEdgeInsets) -> UIEdgeInsets

    Objective C

    - (UIEdgeInsets)widgetMarginInsetsForProposedMarginInsets:(UIEdgeInsets)defaultMarginInsets

    Параметры

    defaultMarginInsets

    Граничные вставки по умолчанию, которые доступны виджету.

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

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

    Обсуждение

    Виджет может реализовать этот метод для возврата пользовательских граничных значений вставки для использования вместо значений по умолчанию, указанных в defaultMarginInsets. (Если виджет не должен использовать пользовательские значения, он должен возвратить неизменные значения по умолчанию в своей реализации.), Если виджет не реализует этот метод, он автоматически получает граничные значения вставки по умолчанию.

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

    Objective C

    @import NotificationCenter;

    Swift

    import NotificationCenter

    Доступность

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

Обновление содержания виджета
  • widgetPerformUpdateWithCompletionHandler (_:) - widgetPerformUpdateWithCompletionHandler:

    Вызванный, чтобы дать виджету возможность обновить ее содержание.

    Объявление

    Swift

    optional func widgetPerformUpdateWithCompletionHandler(_ completionHandler: ((NCUpdateResult) -> Void)!)

    Objective C

    - (void)widgetPerformUpdateWithCompletionHandler:(void (^)(NCUpdateResult result))completionHandler

    Параметры

    completionHandler

    Блок, который вызовут, когда было обновлено содержание виджета.

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

    result

    Значение типа NCUpdateResult это описывает результат процедуры обновления. (Коды Результата обновления перечисляют возможные значения result.)

    Обсуждение

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

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

    Objective C

    @import NotificationCenter;

    Swift

    import NotificationCenter

    Доступность

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

Константы
  • Коды результата обновления

    Указывает возможные результаты обновления состояния виджета.

    Объявление

    Swift

    enum NCUpdateResult : UInt { case NewData case NoData case Failed }

    Objective C

    typedef enum : NSUInteger { NCUpdateResultNewData, NCUpdateResultNoData, NCUpdateResultFailed } NCUpdateResult;

    Константы

    • NewData

      NCUpdateResultNewData

      Обновление привело к новым данным для отображения. Когда новые данные доступны, виджету, возможно, придется обновить его расположение.

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

    • NoData

      NCUpdateResultNoData

      Обновление не приводило ни к каким новым данным начиная с последнего обновления.

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

    • Failed

      NCUpdateResultFailed

      Попытка обновления перестала работать.

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

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

    Objective C

    @import NotificationCenter;

    Swift

    import NotificationCenter

    Доступность

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