NSNotificationQueue

Объекты NSNotificationQueue (или просто очереди уведомления) действуют как буферы для центров уведомления (экземпляры NSNotificationCenter). Принимая во внимание, что центр уведомления распределяет уведомления, когда отправлено, уведомления, помещенные в очередь, могут быть задержаны до конца текущей передачи через цикл выполнения или пока цикл выполнения не неактивен. Двойные уведомления могут также быть объединены так, чтобы только одно уведомление было отправлено несмотря на то, что отправляются многократные уведомления. Очередь уведомления поддерживает уведомления (экземпляры NSNotification) обычно в порядке метода «первым пришел - первым вышел» (FIFO). Когда уведомление повышается до передней стороны очереди, очередь отправляет его на центр уведомления, поочередно диспетчеризирующий уведомление всем объектам, зарегистрированным как наблюдатели.

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

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

NSObject
NSNotificationQueue

NSObject
NSNotificationQueue

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Создание очередей уведомления

init (notificationCenter:) - initWithNotificationCenter: Определяемый инициализатор

Инициализирует и возвращает очередь уведомления для указанного центра уведомления.

Объявление

Swift

init(notificationCenter notificationCenter: NSNotificationCenter)

Objective C

- (instancetype)initWithNotificationCenter:(NSNotificationCenter *)notificationCenter

Параметры

notificationCenter

Центр уведомления используется новой очередью уведомления.

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

Недавно инициализированная очередь уведомления.

Обсуждение

Это - определяемый инициализатор для класса NSNotificationQueue.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Получение очереди по умолчанию

defaultQueue () + defaultQueue

Возвращает очередь уведомления по умолчанию для текущего потока.

Объявление

Swift

class func defaultQueue() -> NSNotificationQueue

Objective C

+ (NSNotificationQueue *)defaultQueue

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

Возвращает очередь уведомления по умолчанию для текущего потока. Эта очередь уведомления использует центр уведомления по умолчанию.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Управление уведомлениями


    
    enqueueNotification (_: postingStyle:)
    - enqueueNotification:postingStyle:

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

Объявление

Swift

func enqueueNotification(_ notification: NSNotification, postingStyle postingStyle: NSPostingStyle)

Objective C

- (void)enqueueNotification:(NSNotification *)notification postingStyle:(NSPostingStyle)postingStyle

Параметры

`notification`	Уведомление, чтобы добавить к очереди.
`postingStyle`	Стиль регистрации для уведомления. Когда очередь уведомления должна отправить уведомление своему центру уведомления, стиль регистрации указывает.

Обсуждение

Уведомления, добавленные с этим методом, отправляются с помощью runloop режима NSDefaultRunLoopMode и объединение критериев, которые объединят только уведомления, соответствующие обоим имя и объект уведомления.

Этот метод вызывает enqueueNotification:postingStyle:coalesceMask:forModes:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    enqueueNotification (_: postingStyle:coalesceMask:forModes:)
    - enqueueNotification:postingStyle:coalesceMask:forModes:

Добавляет уведомление очереди уведомления с указанным стилем регистрации, критериями объединения и runloop режимом.

Объявление

Swift

func enqueueNotification(_ notification: NSNotification, postingStyle postingStyle: NSPostingStyle, coalesceMask coalesceMask: Int, forModes modes: [AnyObject]?)

Objective C

- (void)enqueueNotification:(NSNotification *)notification postingStyle:(NSPostingStyle)postingStyle coalesceMask:(NSUInteger)coalesceMask forModes:(NSArray *)modes

Параметры

`notification`	Уведомление, чтобы добавить к очереди.
`postingStyle`	Стиль регистрации для уведомления. Когда очередь уведомления должна отправить уведомление своему центру уведомления, стиль регистрации указывает.
`coalesceMask`	Маска, указывающая, что критерии использовать при соответствии атрибутов `notification` к атрибутам уведомлений в очереди. Маска создается путем объединения любой из констант `NSNotificationNoCoalescing`, `NSNotificationCoalescingOnName`, и `NSNotificationCoalescingOnSender`.
`modes`	Список режимов уведомление может быть отправлен в. Если цикл выполнения будет в одном из режимов, предоставленных в массиве, очередь уведомления только отправит уведомление своему центру уведомления. Может быть `nil`, когда это принимает значение по умолчанию к `NSDefaultRunLoopMode`.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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


    
    dequeueNotificationsMatching (_: coalesceMask:)
    - dequeueNotificationsMatching:coalesceMask:

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

Объявление

Swift

func dequeueNotificationsMatching(_ notification: NSNotification, coalesceMask coalesceMask: Int)

Objective C

- (void)dequeueNotificationsMatching:(NSNotification *)notification coalesceMask:(NSUInteger)coalesceMask

Параметры


      notification

Уведомление, используемое для соответствия уведомлений для удаления из очереди уведомления.


      coalesceMask

Маска, указывающая, что критерии использовать при соответствии атрибутов notification к атрибутам уведомлений в очереди. Маска создается путем объединения любой из констант NSNotificationNoCoalescing, NSNotificationCoalescingOnName, и NSNotificationCoalescingOnSender.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

Типы данных

NSNotificationCoalescing NSNotificationCoalescing
Эти константы указывают, как объединяются уведомления.

Объявление

Swift

enum NSNotificationCoalescing : UInt { case NoCoalescing case CoalescingOnName case CoalescingOnSender }

Objective C

typedef enum { NSNotificationNoCoalescing = 0, NSNotificationCoalescingOnName = 1, NSNotificationCoalescingOnSender = 2 } NSNotificationCoalescing;

Константы
- NoCoalescing
  
  NSNotificationNoCoalescing
  
  Не объединяйте уведомления в очереди.
  
  Доступный в OS X v10.0 и позже.
- CoalescingOnName
  
  NSNotificationCoalescingOnName
  
  Объедините уведомления с тем же именем.
  
  Доступный в OS X v10.0 и позже.
- CoalescingOnSender
  
  NSNotificationCoalescingOnSender
  
  Объедините уведомления с тем же объектом.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в третьем параметре enqueueNotification:postingStyle:coalesceMask:forModes:. Вы можете OR их вместе для указания больше чем одного.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

Доступный в OS X v10.0 и позже.
NSPostingStyle NSPostingStyle
Когда уведомления отправляются, эти константы указывают.

Объявление

Swift

enum NSPostingStyle : UInt { case PostWhenIdle case PostASAP case PostNow }

Objective C

typedef enum { NSPostWhenIdle = 1, NSPostASAP = 2, NSPostNow = 3 } NSPostingStyle;

Константы
- PostASAP
  
  NSPostASAP
  
  Уведомление отправляется в конце текущей выноски уведомления или таймера.
  
  Доступный в OS X v10.0 и позже.
- PostWhenIdle
  
  NSPostWhenIdle
  
  Когда цикл выполнения неактивен, уведомление отправляется.
  
  Доступный в OS X v10.0 и позже.
- PostNow
  
  NSPostNow
  
  Уведомление сразу отправляется после объединения.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эти константы используются в обоих enqueueNotification:postingStyle: и enqueueNotification:postingStyle:coalesceMask:forModes:.

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

Objective C

@import Foundation;

Swift

import Foundation

Доступность

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

NSNotificationQueue

Создание очередей уведомления

Объявление

Параметры

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

Обсуждение

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

Доступность

Получение очереди по умолчанию

Объявление

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

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

Доступность

Управление уведомлениями

Объявление

Параметры

Обсуждение

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

Доступность

Объявление

Параметры

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

Доступность

Объявление

Параметры

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

Доступность

Типы данных

Объявление

Константы

Обсуждение

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

Доступность

Объявление

Константы

Обсуждение

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

Доступность