NSApplication

Класс сразу

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

NSApplication класс служит центральной основой для выполнения Вашего приложения.

Каждое приложение должно иметь точно один экземпляр NSApplication (или подкласс NSApplication). Ваша программа main() функция должна создать этот экземпляр путем вызова sharedApplication метод класса. После создания NSApplication объект, main() функция должна загрузить основной файл пера Вашего приложения и затем запустить цикл событий путем отправки NSApplication объект a run сообщение. Если Вы создаете проект Приложения в XCode, этом main() функция создается для Вас. main() функциональный XCode создает, начинается путем вызывания названной функции NSApplicationMain(), который функционально подобен следующему:

      void NSApplicationMain(int argc, char *argv[]) {
    [NSApplication sharedApplication];
    [NSBundle loadNibNamed:@"myMain" owner:NSApp];
    [NSApp run];
}


  

sharedApplication метод класса инициализирует среду дисплея и подключает Вашу программу к серверу окна и серверу дисплея. NSApplication объект ведет список весь NSWindow возражает использованию приложения, таким образом, это может получить любое приложение NSView объекты. sharedApplication метод также инициализирует глобальную переменную NSApp, который Вы используете для получения NSApplication экземпляр. sharedApplication только выполняет инициализацию один раз; при вызове его несколько раз это просто возвращается NSApplication возразите, что это создало ранее.

Совместно используемое NSApplication объект выполняет важную задачу получения событий от сервера окна и распределения их к надлежащему NSResponder объекты. NSApp переводит событие в NSEvent объект, затем вперед NSEvent возразите против затронутого NSWindow объект. Все события клавиатуры и события от нажатия мыши переходят непосредственно в NSWindow объект связался с событием. Единственное исключение к этому правилу - то, если Командная клавиша нажимается, когда ключевое вниз событие имеет место; в этом случае, каждый NSWindow объект имеет возможность реагировать на событие. Когда NSWindow объект получает NSEvent объект от NSApp, это распределяет его объектам в его иерархии представления.

NSApplication также ответственно за диспетчеризацию определенных событий Apple, полученных приложением. Например, OS X отправляет события Apple в Ваше приложение неоднократно, такой как тогда, когда приложение запускается или вновь открывается. NSApplication установки обработчики событий Apple для обработки этих событий путем отправки сообщения в надлежащий объект. Можно также использовать NSAppleEventManager класс для регистрации собственных обработчиков событий Apple. applicationWillFinishLaunching: метод обычно является лучшим местом, чтобы сделать так. Для получения дополнительной информации о том, как обрабатываются события и как можно изменить поведение по умолчанию, включая информацию о работе с событиями Apple в scriptable приложениях, посмотрите Как Дескриптор Приложений Какао События Apple в Руководстве по созданию сценариев Какао.

NSApplication класс устанавливает @autorelease блок во время инициализации и в цикле событий — в частности, в его инициализации (или sharedApplication) и run методы. Точно так же методы AppKit добавляют к NSBundle использовать @autorelease блоки во время загрузки файлов пера. Они @autorelease блоки не доступны вне объема соответствующего NSApplication и NSBundle методы. Как правило, приложение создает объекты или в то время как цикл событий работает или загружаемыми объектами от файлов пера, таким образом, это отсутствие доступа обычно не является проблемой. Однако, если действительно необходимо использовать классы Какао в main() функционируйте самостоятельно (кроме загрузить файлы пера или инстанцировать NSApplication), необходимо создать @autorelease блок для содержания кода с помощью классов.

Делегат и уведомления

Можно присвоить делегата в NSApp. Делегат реагирует на определенные сообщения от имени NSApp. Некоторые из этих сообщений, такой как application:openFile:, попросите, чтобы делегат выполнил действие. Другое сообщение, applicationShouldTerminate:, позволяет делегату определить, нужно ли приложению позволить выйти. NSApplication класс отправляет эти сообщения непосредственно его делегату.

NSApp также уведомления сообщений центру уведомления приложения по умолчанию. Любой объект может зарегистрироваться для получения один или больше уведомлений, отправленных NSApp путем отправки сообщения addObserver:selector:name:object: к центру уведомления по умолчанию (экземпляр NSNotificationCenter класс). Делегат NSApp автоматически регистрируется для получения этих уведомлений, если это реализует определенные методы делегата. Например, NSApp уведомления сообщений, когда это собирается быть сделанным, запуская приложение и когда это сделано, запустив приложение (NSApplicationWillFinishLaunchingNotification и NSApplicationDidFinishLaunchingNotification). У делегата есть возможность реагировать на эти уведомления путем реализации методов applicationWillFinishLaunching: и applicationDidFinishLaunching:. Если делегат хочет быть информированным об обоих событиях, это реализует оба метода. Если это должно знать только, когда приложение закончено, запустившись, это реализует только applicationDidFinishLaunching:.

Системные службы

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

Разделение на подклассы примечаний

Редко необходимо находить реальную потребность создать пользовательское NSApplication подкласс. В отличие от некоторых объектно-ориентированных библиотек, Какао не требует, чтобы Вы разделили на подклассы NSApplication настроить поведение приложения. Вместо этого это дает Вам много других способов настроить приложение. В этом разделе рассматриваются обоих некоторые возможные причины разделить на подклассы NSApplication и некоторые причины не разделить на подклассы NSApplication.

Использовать пользовательский подкласс NSApplication, просто отправьте sharedApplication к Вашему подклассу, а не непосредственно к NSApplication. При создании приложения в XCode можно выполнить это путем установки класса пользовательского приложения, чтобы быть основным классом. В XCode дважды щелкните по цели приложения в списке Групп и Файлов для открытия окна Info для цели. Тогда выведите на экран область Properties окна и замените «NSApplication» в поле Principal Class с именем Вашего пользовательского класса. NSApplicationMain функция отправляет sharedApplication к основному классу для получения глобального экземпляра приложения (NSApp) — который в этом случае будет экземпляром Вашего пользовательского подкласса NSApplication.

Методы для переопределения

Обычно Вы разделяете на подклассы NSApplication обеспечить Ваши собственные специальные ответы на сообщения, обычно отправляющиеся в глобальный объект приложения (NSApp). NSApplication не имеет примитивных методов в смысле методов, которые необходимо переопределить в подклассе. Вот четыре метода, которые являются возможными кандидатами на переопределение:

Переопределение run если Вы хотите, чтобы приложение управляло основным циклом событий по-другому, чем это делает по умолчанию. (Это критическая и сложная задача, однако, которого необходимо только делать попытку с серьезным основанием.)
Переопределение sendEvent: если Вы хотите измениться, как события диспетчеризируются или выполняют некоторую обработку специального мероприятия.
Переопределение requestUserAttention: если Вы хотите изменить, как Ваше приложение привлекает внимание пользователя (например, предлагая альтернативу возвращаемому значку приложения в Прикреплении).
Переопределение targetForAction: заменять другим объектом цель сообщения действия.

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

Глобальное приложение возражает использованию @autorelease блоки в run метод; при переопределении этого метода необходимо будет создать собственное @autorelease блоки.

Не переопределять sharedApplication. Реализация по умолчанию, которая важна для поведения приложения, слишком сложна для дублирования самостоятельно.

Альтернативы разделению на подклассы

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

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

NSObject
NSResponder
NSApplication
REPLApplication

NSObject
NSResponder
NSApplication

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Получение объекта общего приложения

sharedApplication () + sharedApplication

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

Объявление

Swift

class func sharedApplication() -> NSApplication

Objective C

+ (NSApplication *)sharedApplication

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

Объект общего приложения.

Обсуждение

Этот метод также делает соединение с сервером окна и завершает другую инициализацию. Ваша программа должна вызвать этот метод как один из первых операторов в main(); если Вы создаете свое приложение с XCode, этот вызов сделан для Вас. Получать NSApplication экземпляр после того, как это было создано, использует глобальную переменную NSApp или вызовите этот метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– выполненный
– оконечный:

Конфигурирование приложения

finishLaunching () - finishLaunching

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

Объявление

Swift

func finishLaunching()

Objective C

- (void)finishLaunching

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

applicationWillFinishLaunching: (NSApplicationDelegate)
applicationDidFinishLaunching: (NSApplicationDelegate)
делегат делегат Свойство

Делегат приложения объект.

Объявление

Swift

unowned(unsafe) var delegate: NSApplicationDelegate?

Objective C

@property(assign) id< NSApplicationDelegate > delegate

Обсуждение

Объект приложения и приложение делегируют работу в тандеме для управления полным поведением приложения. Как правило, делегат сконфигурирован автоматически шаблонами проекта XCode.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

var applicationIconImage: NSImage!

Objective C

@property(strong) NSImage *applicationIconImage

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Завершение приложения


    
    оконечный (_:)
    - оконечный:

Завершает получатель.

Объявление

Swift

func terminate(_ sender: AnyObject?)

Objective C

- (void)terminate:(id)sender

Параметры


      sender

Как правило, этот параметр содержит объект, подавший заявку завершения.

Обсуждение

Когда пользователь выбирает Quit или Exit из меню приложения, этот метод обычно вызывается.

Когда вызвано, этот метод выполняет несколько шагов для обработки запроса завершения. Во-первых, это спрашивает контроллер документа приложения (если Вы существуете) сохранить любые несохраненные изменения в его документах. Во время этого процесса контроллер документа может отменить завершение в ответ на ввод от пользователя. Если контроллер документа не отменяет работу, этот метод тогда вызывает делегата applicationShouldTerminate: метод. Если applicationShouldTerminate: возвраты NSTerminateCancel, процесс завершения прерывается, и управление возвращено основному циклу событий. Если возвращается метод NSTerminateLater, выполнение приложения его цикл выполнения в NSModalPanelRunLoopMode режим до replyToApplicationShouldTerminate: метод вызывают со значением YEStrue или NOfalse. Если applicationShouldTerminate: возвраты метода NSTerminateNow, этот метод отправляет a NSApplicationWillTerminateNotification уведомление центру уведомления по умолчанию.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– выполненный
– остановка:
applicationShouldTerminate: (NSApplicationDelegate)
applicationWillTerminate: (NSApplicationDelegate)
– replyToApplicationShouldTerminate:
NSApplicationWillTerminateNotification


    
    replyToApplicationShouldTerminate (_:)
    - replyToApplicationShouldTerminate:

Отвечает на NSTerminateLater как только приложение знает, может ли оно завершиться.

Объявление

Swift

func replyToApplicationShouldTerminate(_ shouldTerminate: Bool)

Objective C

- (void)replyToApplicationShouldTerminate:(BOOL)shouldTerminate

Параметры


      shouldTerminate

Указать YEStrue если Вы хотите, чтобы завершилось приложение; иначе, указать NOfalse.

Обсуждение

Если возвращается Ваш делегат приложения NSTerminateLater от applicationShouldTerminate: метод, Ваш код должен впоследствии вызвать этот метод для разрешения NSApplication объект знает, может ли он фактически завершить себя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Обработка событий

currentEvent currentEvent Свойство

Последний объект-событие, что приложение получено от очереди событий. (только для чтения)

Объявление

Swift

var currentEvent: NSEvent? { get }

Objective C

@property(readonly, strong) NSEvent *currentEvent

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– discardEventsMatchingMask:beforeEvent:
– postEvent:atStart:
– sendEvent:


    
    nextEventMatchingMask (_: untilDate:inMode:dequeue:)
    - nextEventMatchingMask:untilDate:inMode:dequeue:

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

Объявление

Swift

func nextEventMatchingMask(_ mask: Int, untilDate expiration: NSDate?, inMode mode: String, dequeue flag: Bool) -> NSEvent?

Objective C

- (NSEvent *)nextEventMatchingMask:(NSUInteger)mask untilDate:(NSDate *)expiration inMode:(NSString *)mode dequeue:(BOOL)flag

Параметры

`mask`	Содержит один или несколько флагов, указывающих типы событий для возврата. Раздел констант `NSEvent` класс определяет константы, которые можно добавить вместе для создания этой маски. `discardEventsMatchingMask:beforeEvent:` метод также перечисляет несколько из этих констант.
`expiration`	Дата истечения срока запроса текущего события. Указание ноля для этого параметра эквивалентно возврату объекта даты использование `distantPast` метод.
`mode`	Режим цикла выполнения, в котором можно работать при поиске событий. Режим, который Вы указываете также, определяет, какие таймеры и наблюдатели цикла выполнения могут стрелять, в то время как приложение ожидает события.
`flag`	Указать `YEStrue` если Вы хотите событие, удаленное из очереди.

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

Объект-событие, тип которого соответствует одни из типов событий, указанных mask параметр.

Обсуждение

Можно использовать этот метод, чтобы сорвать нормальную диспетчеризацию события и получить собственные события. Например, в то время как ее кнопка снижается, можно хотеть сделать это в ответ на событие mouseDown для отслеживания мыши. (В таком примере Вы передали бы надлежащие типы событий для перетащенного мышью и событий mouseUp к mask параметр и указывает NSEventTrackingRunLoopMode выполненный режим цикла.) События, не соответствующие одни из указанных типов событий, оставляют в очереди.

Можно указать один из режимов цикла выполнения, определенных AppKit или пользовательским режимом цикла выполнения, используемым в частности приложением. AppKit определяет следующие режимы цикла выполнения:

NSDefaultRunLoopMode
NSEventTrackingRunLoopMode
NSModalPanelRunLoopMode
NSConnectionReplyMode

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– postEvent:atStart:
– выполненный
– runModalForWindow:


    
    discardEventsMatchingMask (_: beforeEvent:)
    - discardEventsMatchingMask:beforeEvent:

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

Объявление

Swift

func discardEventsMatchingMask(_ mask: Int, beforeEvent lastEvent: NSEvent?)

Objective C

- (void)discardEventsMatchingMask:(NSUInteger)mask beforeEvent:(NSEvent *)lastEvent

Параметры


      mask

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


      lastEvent

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

Обсуждение

Используйте этот метод для игнорирования любых событий, произошедших перед определенным событием. Например, предположите, что Ваше приложение имеет цикл отслеживания, из которого Вы выходите когда разъединения абонентом кнопка мыши. Вы могли использовать этот метод, указывая NSAnyEventMask как параметр маски и конечное событие mouseUp как lastEvent параметр, для отбрасывания всех событий, произошедших, в то время как Вы отслеживали движения мыши в своем цикле. Передача события mouseUp как lastEvent гарантирует, что не отбрасываются любые события, которые, возможно, произошли после события mouseUp (т.е. которые появляются в очереди после события mouseUp).

Для mask параметр, можно добавить вместе константы типа события, такие как следующее:

NSLeftMouseDownMask
NSLeftMouseUpMask
NSRightMouseDownMask
NSRightMouseUpMask
NSMouseMovedMask
NSLeftMouseDraggedMask
NSRightMouseDraggedMask
NSMouseEnteredMask
NSMouseExitedMask
NSKeyDownMask
NSKeyUpMask
NSFlagsChangedMask
NSPeriodicMask
NSCursorUpdateMask
NSAnyEventMask

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– nextEventMatchingMask:untilDate:inMode:dequeue:

Управление циклом событий

выполнение выполнение Свойство

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

Объявление

Swift

var running: Bool { get }

Objective C

@property(getter=isRunning, readonly) BOOL running

Обсуждение

Значение этого свойства YEStrue когда основной цикл событий работает или NOfalse когда это не. Вызов stop: метод устанавливает значение в NOfalse.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– выполненный
– оконечный:
выполненный () - выполненный

Запускает основной цикл событий.

Объявление

Swift

func run()

Objective C

- (void)run

Обсуждение

Цикл продолжается до a stop: или terminate: сообщение получено. После каждой итерации через цикл следующее доступное событие от сервера окна сохранено и затем диспетчеризируется путем отправки его в NSApp использование sendEvent:.

После создания NSApplication объект, main функция должна загрузить основной файл пера Вашего приложения и затем запустить цикл событий путем отправки NSApplication объект a run сообщение. Если Вы создаете проект приложения Какао в XCode, этом main функция реализована для Вас.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– runModalForWindow:
– runModalSession:
applicationDidFinishLaunching: (NSApplicationDelegate)
остановитесь (_:) - остановка:

Останавливает основной цикл событий.

Объявление

Swift

func stop(_ sender: AnyObject?)

Objective C

- (void)stop:(id)sender

Параметры

sender

Объект, отправивший это сообщение.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– выполненный
– runModalForWindow:
– runModalSession:
– оконечный:
sendEvent (_:) - sendEvent:

Диспетчеризирует событие другим объектам.

Объявление

Swift

func sendEvent(_ anEvent: NSEvent)

Objective C

- (void)sendEvent:(NSEvent *)anEvent

Параметры

anEvent

Объект-событие для диспетчеризации.

Обсуждение

Вы редко вызываете sendEvent: непосредственно, несмотря на то, что Вы могли бы хотеть переопределить этот метод для выполнения некоторого действия с каждым событием. sendEvent: сообщения отправляются от основного цикла событий ( run метод). sendEvent: метод, диспетчеризирующий события соответствующим респондентам —NSApp события приложения дескрипторов, NSWindow объект указал в конечном счете, что запись обрабатывает связанные с окном события, и события от нажатия мыши и ключевые события передаются надлежащему NSWindow объект для дальнейшей диспетчеризации.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

currentEvent
– postEvent:atStart:


    
    постсобытие (_: atStart:)
    - postEvent:atStart:

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

Объявление

Swift

func postEvent(_ anEvent: NSEvent, atStart flag: Bool)

Objective C

- (void)postEvent:(NSEvent *)anEvent atStart:(BOOL)flag

Параметры

`anEvent`	Объект-событие для регистрации на очередь.
`flag`	Указать `YEStrue` добавить событие к передней стороне очереди; иначе, указать `NOfalse` добавить событие к концу очереди.

Обсуждение

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

currentEvent
– sendEvent:

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

enabledRemoteNotificationTypes enabledRemoteNotificationTypes Свойство

Типы уведомлений нажатия, которые принимает приложение. (только для чтения)

Объявление

Swift

var enabledRemoteNotificationTypes: NSRemoteNotificationType { get }

Objective C

@property(readonly) NSRemoteNotificationType enabledRemoteNotificationTypes

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

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

Обсуждение

Это свойство содержит битовую маску, значения которой указывают типы уведомлений нажатия, которые запросило приложение. Вы не устанавливаете это свойство непосредственно. Вызовите registerForRemoteNotificationTypes: метод, чтобы зарегистрировать Ваше приложение в Службе Уведомления Нажатия Apple и запросить уведомление вводит Ваши поддержки приложений. OS X поставляет только уведомления о типах что поддержки приложений. Для списка возможных значений посмотрите NSRemoteNotificationType.

Примечание:

В настоящее время единственный тип уведомления, поддерживаемый для незапущенных приложений, является применением идентификационных знаков значков приложения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerForRemoteNotificationTypes:
– unregisterForRemoteNotifications


    
    registerForRemoteNotificationTypes (_:)
    - registerForRemoteNotificationTypes:

Регистр для получения уведомлений об указанных типах от провайдера через службу Apple Push Notification.

Объявление

Swift

func registerForRemoteNotificationTypes(_ types: NSRemoteNotificationType)

Objective C

- (void)registerForRemoteNotificationTypes:(NSRemoteNotificationType)types

Параметры


      types

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

Обсуждение

При отправке этого сообщения устройство инициирует процесс регистрации со Службой Уведомления Нажатия Apple. Если это успешно выполняется, делегат приложения получает маркер устройства в application:didRegisterForRemoteNotificationsWithDeviceToken: метод; если регистрация не успешно выполняется, делегату сообщают через application:didFailToRegisterForRemoteNotificationsWithError: метод. Если делегат приложения получает маркер устройства, он должен соединиться с его провайдером и передать его маркер.

Примечание:

В настоящее время единственный тип уведомления, поддерживаемый в Mac OS X для незапущенных приложений, является применением идентификационных знаков значка. Однако полезная нагрузка JSON, которая может содержать информацию, связанную со звуками и предупреждениями, передается запущенному приложению в application:didReceiveRemoteNotification:. Приложение может сделать то, что оно хочет с той информацией (например, выведите на экран предупреждение или играйте звук).

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– enabledRemoteNotificationTypes
– unregisterForRemoteNotifications

unregisterForRemoteNotifications () - unregisterForRemoteNotifications

Нерегистр для уведомлений получен от службы Apple Push Notification.

Объявление

Swift

func unregisterForRemoteNotifications()

Objective C

- (void)unregisterForRemoteNotifications

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– enabledRemoteNotificationTypes
– registerForRemoteNotificationTypes:

Управление модальным Windows


    
    runModalForWindow (_:)
    - runModalForWindow:

Запускает модальный цикл событий для данного окна.

Объявление

Swift

func runModalForWindow(_ aWindow: NSWindow) -> Int

Objective C

- (NSInteger)runModalForWindow:(NSWindow *)aWindow

Параметры


      aWindow

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

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

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

Обсуждение

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

Можно выйти из модального цикла путем вызова stopModal, stopModalWithCode:, или abortModal методы от Вашего модального кода окна. Если Вы используете stopModalWithCode: метод для остановки модального цикла событий этот метод возвращается, параметр передал stopModalWithCode:. Если Вы используете stopModal вместо этого, этот метод возвращает константу NSModalResponseStop. Если Вы используете abortModal, этот метод возвращает константу NSModalResponseAbort.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– выполненный
– runModalSession:

stopModal () - stopModal

Останавливает модальный цикл событий.

Объявление

Swift

func stopModal()

Objective C

- (void)stopModal

Обсуждение

Этот метод должен всегда соединяться с предыдущим вызовом runModalForWindow: или beginModalSessionForWindow:. Когда runModalForWindow: останавливается с этим методом, он возвращается NSModalResponseStop. Этот метод останавливает цикл, только если это выполняется кодом, отвечающим на событие. Если необходимо остановить a runModalForWindow: цикл за пределами одного из его обратных вызовов события (например, метод, неоднократно вызываемый NSTimer возразите или метод, работающий в различном потоке), используйте abortModal метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– runModalSession:
– stopModalWithCode:


    
    stopModalWithCode (_:)
    - stopModalWithCode:

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

Объявление

Swift

func stopModalWithCode(_ returnCode: Int)

Objective C

- (void)stopModalWithCode:(NSInteger)returnCode

Параметры


      returnCode

Код результата, который Вы хотите, возвратился из runModalForWindow: или runModalSession: метод. Значение этого кода результата ваше дело.

Обсуждение

Этот метод должен всегда соединяться с предыдущим вызовом runModalForWindow: или beginModalSessionForWindow:. Когда runModalForWindow: останавливается с этим методом, он возвращает данный returnCode. Этот метод останавливает цикл, только если это выполняется кодом, отвечающим на событие. Если необходимо остановить a runModalForWindow: цикл за пределами одного из его обратных вызовов события (например, метод, неоднократно вызываемый NSTimer возразите или метод, работающий в различном потоке), используйте abortModal метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– abortModal
– runModalForWindow:

abortModal () - abortModal

Прерывает цикл событий, запущенный runModalForWindow: или runModalSession:.

Объявление

Swift

func abortModal()

Objective C

- (void)abortModal

Обсуждение

Когда остановлено с этим методом, runModalForWindow: и runModalSession: возвратиться NSModalResponseAbort.

abortModal должен использоваться вместо stopModal или stopModalWithCode: когда необходимо остановить модальный цикл событий отовсюду кроме выноски от того цикла событий. Другими словами, если Вы хотите остановить цикл в ответ на действия пользователя в модальном окне, использовать stopModal; иначе, использовать abortModal. Например, использовать abortModal при выполнении в различном потоке от основного потока AppKit или при ответе на NSTimer то, что Вы добавили к NSModalPanelRunLoopMode режим значения по умолчанию NSRunLoop.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– endModalSession:
beginModalSessionForWindow (_:) - beginModalSessionForWindow:

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

Объявление

Swift

func beginModalSessionForWindow(_ aWindow: NSWindow) -> NSModalSession

Objective C

- (NSModalSession)beginModalSessionForWindow:(NSWindow *)aWindow

Параметры

aWindow

Окно для сеанса.

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

NSModalSession структура, представляющая сеанс.

Обсуждение

В модальном сеансе приложение получает события от нажатия мыши, только если они происходят в aWindow. Если не уже видимый помещается на экране с помощью, окно сделано ключевым, и NSWindow метод center.

beginModalSessionForWindow: метод только устанавливает модальный сеанс. Для фактического выполнения сеанса использовать runModalSession:. beginModalSessionForWindow: должен быть сбалансирован endModalSession:. Удостоверьтесь, что эти два сообщения отправляются в том же объеме обработки исключений. Т.е. если Вы отправляете beginModalSessionForWindow: в NS_DURING создайте, необходимо отправить endModalSession: прежде NS_ENDHANDLER.

Если исключение повышено, beginModalSessionForWindow: устраивает надлежащую очистку. Не использовать NS_DURING конструкции для отправки endModalSession: сообщение в случае исключения.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    runModalSession (_:)
    - runModalSession:

Выполняет данный модальный сеанс, как определено в предыдущем вызове beginModalSessionForWindow:.

Объявление

Swift

func runModalSession(_ session: NSModalSession) -> Int

Objective C

- (NSInteger)runModalSession:(NSModalSession)session

Параметры


      session

Модальная структура сеанса, возвращенная beginModalSessionForWindow: метод для окна, которое будет выведено на экран.

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

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

Обсуждение

Цикл, использующий этот метод, подобен до некоторой степени модальному циклу событий, выполненному с runModalForWindow:, кроме с этим методом Ваш код может выполнить некоторую дополнительную работу между вызовами метода. Когда Вы вызываете этот метод, события для NSWindow объект этого сеанса диспетчеризируется как нормальный. Когда больше нет событий, этот метод возвращается. Необходимо вызывать этот метод достаточно часто в цикле, что окно остается быстро реагирующим к событиям. Однако Вы не должны вызывать этот метод в жестком цикле, потому что он сразу возвращается, при отсутствии событий, и следовательно Вы могли бы закончить тем, что опросили относительно событий вместо блокирования.

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

Следующий код показывает демонстрационный цикл, который можно использовать в коде:

      NSModalSession session = [NSApp beginModalSessionForWindow:theWindow];
for (;;) {
    if ([NSApp runModalSession:session] != NSModalResponseContinue)
        break;
    [self doSomeWork];
}
[NSApp endModalSession:session];


  

Если модальный сеанс не был остановлен, этот метод возвраты NSModalResponseContinue. В этой точке Ваше приложение может выполнить некоторую работу перед следующим вызовом runModalSession: (как обозначено в примере doSomeWork вызовите). Если stopModal был вызван как результат обработки событий, runModalSession: возвраты NSModalResponseStop. Если stopModalWithCode: был вызван, этот метод возвращается, значение передало stopModalWithCode:. Если abortModal был вызван, этот метод возвраты NSModalResponseAbort.

Окно помещается в экран и делается ключом в результате runModalSession: сообщение. Не отправляйте отдельное makeKeyAndOrderFront: сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– beginModalSessionForWindow:
– endModalSession:
– выполненный
– runModalForWindow:

modalWindow modalWindow Свойство

Модальное окно выведено на экран приложением. (только для чтения)

Объявление

Swift

var modalWindow: NSWindow? { get }

Objective C

@property(readonly, strong) NSWindow *modalWindow

Обсуждение

Если никакое модальное окно не выводится на экран, это свойство содержит текущее автономное модальное окно или ноль. Это свойство не содержит листы, которые присоединены к другим окнам. Для получения листа используйте attachedSheet метод NSWindow.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    endModalSession (_:)
    - endModalSession:

Заканчивает модальный сеанс.

Объявление

Swift

func endModalSession(_ session: NSModalSession)

Objective C

- (void)endModalSession:(NSModalSession)session

Параметры


      session

Модальная структура сеанса, возвращенная предыдущим вызовом beginModalSessionForWindow:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– beginModalSessionForWindow:
– runModalSession:

Управление панелями

orderFrontColorPanel (_:) - orderFrontColorPanel:

Переводит в рабочее состояние цветную панель, экземпляр NSColorPanel.

Объявление

Swift

func orderFrontColorPanel(_ sender: AnyObject?)

Objective C

- (void)orderFrontColorPanel:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

Если NSColorPanel объект еще не существует, этот метод создает тот. Когда пользователь выбирает Colors из меню, этот метод обычно вызывается.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
orderFrontStandardAboutPanel (_:) - orderFrontStandardAboutPanel:

Выводит на экран стандартное окно About.

Объявление

Swift

func orderFrontStandardAboutPanel(_ sender: AnyObject?)

Objective C

- (void)orderFrontStandardAboutPanel:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

Это вызовы метода orderFrontStandardAboutPanelWithOptions: с a nil параметр. Посмотрите orderFrontStandardAboutPanelWithOptions: для описания того, что выведено на экран.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    orderFrontStandardAboutPanelWithOptions (_:)
    - orderFrontStandardAboutPanelWithOptions:

Выводит на экран стандартное окно About с информацией из данного словаря опций.

Объявление

Swift

func orderFrontStandardAboutPanelWithOptions(_ optionsDictionary: [NSObject : AnyObject])

Objective C

- (void)orderFrontStandardAboutPanelWithOptions:(NSDictionary *)optionsDictionary

Параметры


      optionsDictionary

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

Обсуждение

Следующие строки являются ключами, которые могут произойти в optionsDictionary:

@"Credits": NSAttributedString выведен на экран в информационной области панели. Если не указанный, этот метод тогда ищет названный файл “Credits.html”, “Credits.rtf”, и “Credits.rtfd”, в том порядке, в пакете, возвращенном NSBundle метод класса mainBundle. Первый найденный файл используется. Если ни один не найден, информационная область оставлена незаполненная.
@"ApplicationName": NSString объект, выведенный на экран как имя приложения. Если не указанный, этот метод тогда использует значение CFBundleName (локализуемый). Если ни один не найден, этот метод использование [[NSProcessInfo processInfo] processName].
@"ApplicationIcon": NSImage объект, выведенный на экран как значок приложения. Если не указанный, этот метод тогда ищет названное изображение “NSApplicationIcon”, использование [NSImage imageNamed:@"NSApplicationIcon"]. Если ни один не доступен, этот метод использует значок универсального приложения.
@"Version": NSString объект с числом версии сборки приложения («58.4»), выведенного на экран как “(v58.4)”. Если не указанный, получите из CFBundleVersion ключ infoDictionary; если не указанный, оставьте незаполненный (“(v)”, не выведен на экран).
@"Copyright": NSString объект со строкой информации об авторском праве. Если не указанный, этот метод тогда ищет значение NSHumanReadableCopyright в локализованной версии infoDictionary. Если ни один не доступен, этот метод оставляет незаполненное пространство.
@"ApplicationVersion": NSString объект с версией приложения («Mac OS X», «3», “WebObjects 4.5”, «AppleWorks 6»...). Если не указанный, получите из CFBundleShortVersionString ключ infoDictionary. Если ни один не доступен, версия сборки, при наличии, распечатана одна, как “Версия x.x”.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– orderFrontStandardAboutPanel:

orderFrontCharacterPalette (_:) - orderFrontCharacterPalette:

Открывает палитру символов.

Объявление

Swift

func orderFrontCharacterPalette(_ sender: AnyObject?)

Objective C

- (void)orderFrontCharacterPalette:(id)sender

Параметры

sender

Объект, отправивший команду.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
runPageLayout (_:) - runPageLayout:

Выводит на экран панель макета страницы получателя, экземпляр NSPageLayout.

Объявление

Swift

func runPageLayout(_ sender: AnyObject?)

Objective C

- (void)runPageLayout:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

Если NSPageLayout экземпляр не существует, этот метод создает тот. Когда пользователь выбирает Page Setup из меню File приложения, этот метод обычно вызывается.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Восстановление окна

extendStateRestoration () - extendStateRestoration

Позволяет приложению расширять свой период восстановления состояния.

Объявление

Swift

func extendStateRestoration()

Objective C

- (void)extendStateRestoration

Обсуждение

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

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

Вы вызываете extendStateRestoration в Вашей реализации restoreWindowWithIdentifier:state:completionHandler:. Вы тогда вызвали бы completeStateRestoration некоторое время после окна полностью восстанавливается. Если сбои приложения тем временем, то это может предложить отбрасывать восстановимое состояние на следующем запуске.

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

Этот метод ориентирован на многопотоковое исполнение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– completeStateRestoration
completeStateRestoration () - completeStateRestoration

Завершает расширенное восстановление состояния.

Объявление

Swift

func completeStateRestoration()

Objective C

- (void)completeStateRestoration

Обсуждение

Этот метод сообщает приложению, что расширенное восстановление состояния завершается для балансирования.

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

Вы вызываете extendStateRestoration в Вашей реализации restoreWindowWithIdentifier:state:completionHandler:. Вы тогда вызвали бы completeStateRestoration некоторое время после окна полностью восстанавливается. Если сбои приложения тем временем, то это может предложить отбрасывать восстановимое состояние на следующем запуске.

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

Этот метод ориентирован на многопотоковое исполнение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– extendStateRestoration


    
    restoreWindowWithIdentifier (_: state:completionHandler:)
    - restoreWindowWithIdentifier:state:completionHandler:

Вызванный, чтобы запросить, что окно быть восстановленным.

Объявление

Swift

func restoreWindowWithIdentifier(_ identifier: String, state state: NSCoder, completionHandler completionHandler: (NSWindow!, NSError!) -> Void) -> Bool

Objective C

- (BOOL)restoreWindowWithIdentifier:(NSString *)identifier state:(NSCoder *)state completionHandler:(void (^)(NSWindow *, NSError *))completionHandler

Параметры

`identifier`	Уникальная интерфейсная строка идентификатора элемента, ранее связанная с окном. Используйте эту строку для определения который окно создать.
`state`	Объект кодера, содержащий информацию о статусе окна. Этот объект кодера содержит объединенное восстановимое состояние окна, которое может включать состояние окна, его делегата, контроллера окна и объекта документа. Можно использовать это состояние для определения который окно создать.
`completionHandler`	Блочный объект выполниться с результатами создания окна. Вы должны выполнить этот блок в некоторый момент, но можете сделать так после возвратов метода в случае необходимости. Этот блок берет следующие параметры: Окно, создававшееся или ноль, если не могло бы быть создано окно. Ошибочный объект, если окно не было распознано или не могло бы быть создано по любой причине; иначе, указать `nil`. В OS X v10.7, проигнорирован параметр ошибок.

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

YEStrue если было восстановлено окно; иначе NOfalse.

Обсуждение

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

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

Примечание:

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Направление макета интерфейса пользователя

userInterfaceLayoutDirection userInterfaceLayoutDirection Свойство

Направление макета пользовательского интерфейса. (только для чтения)

Объявление

Swift

var userInterfaceLayoutDirection: NSUserInterfaceLayoutDirection { get }

Objective C

@property(readonly) NSUserInterfaceLayoutDirection userInterfaceLayoutDirection

Обсуждение

Это свойство содержит направления потока расположения интерфейса обычного пользователя. Для списка возможных значений посмотрите NSUserInterfaceLayoutDirection.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление Windows

keyWindow keyWindow Свойство

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

Объявление

Swift

unowned(unsafe) var keyWindow: NSWindow? { get }

Objective C

@property(readonly, assign) NSWindow *keyWindow

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

mainWindow
isKeyWindow (NSWindow)
mainWindow mainWindow Свойство

Главное окно приложения. (только для чтения)

Объявление

Swift

unowned(unsafe) var mainWindow: NSWindow? { get }

Objective C

@property(readonly, assign) NSWindow *mainWindow

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

keyWindow
isMainWindow (NSWindow)
windowWithWindowNumber (_:) - windowWithWindowNumber:

Возвращает окно, соответствующее указанному числу окна.

Объявление

Swift

func windowWithWindowNumber(_ windowNum: Int) -> NSWindow?

Objective C

- (NSWindow *)windowWithWindowNumber:(NSInteger)windowNum

Параметры

windowNum

Уникальное число окна связалось с желаемым NSWindow объект.

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

Желаемый объект окна или nil если не могло бы быть найдено окно.

Обсуждение

windowWithWindowNumber: может возвратиться nil для окна числа нашел использование windowNumbersWithOptions: если нет никакого соответствующего объекта окна, принадлежавшего Вашему приложению — например, строка меню.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Массив объектов окна приложения. (только для чтения)

Объявление

Swift

var windows: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *windows

Обсуждение

Это свойство содержит массив NSWindow объекты, соответствующие всем в настоящее время существующим окнам для приложения. Массив включает все экранные и внеэкранные окна, видимы ли они на каком-либо пространстве. Нет никакой гарантии порядка окон в массиве.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    makeWindowsPerform (_: inOrder:)
    - makeWindowsPerform:inOrder:

Отправляет указанное сообщение в каждый из объектов окна приложения, пока каждый не возвращается не -nil значение.

Объявление

Swift

func makeWindowsPerform(_ aSelector: Selector, inOrder flag: Bool) -> NSWindow?

Objective C

- (NSWindow *)makeWindowsPerform:(SEL)aSelector inOrder:(BOOL)flag

Параметры


      aSelector

Селектор для выполнения на каждом окне. Этот метод не должен брать параметры и должен возвратить значение, тип которого, который может быть по сравнению с nil.


      flag

Если YEStrue, aSelector сообщение отправляется в каждое из экранных окон сервера окна, входя в z-порядок, пока каждый не возвращается не -nil значение. Минимизируемое окно не считается экранным для этой проверки. Если NOfalse, сообщение отправляется во все окна в NSAppсписок окна, независимо от того, являются ли они экранными. Этот порядок является неуказанным.

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

Окно, возвратившееся не -nil значение или nil если все окна возвратили ноль из aSelector.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sendAction:to:from:
– tryToPerform:with:
окна

Минимизация Windows

miniaturizeAll (_:) - miniaturizeAll:

Миниатюризирует окна всего получателя.

Объявление

Swift

func miniaturizeAll(_ sender: AnyObject?)

Objective C

- (void)miniaturizeAll:(id)sender

Параметры

sender

Объект, отправивший команду.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– скройтесь:

Сокрытие Windows

скрытый скрытый Свойство

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

Объявление

Swift

var hidden: Bool { get }

Objective C

@property(getter=isHidden, readonly) BOOL hidden

Обсуждение

Значение этого свойства YEStrue если приложение скрыто или NOfalse если это не.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– скройтесь:
– выведите на экран:
– unhideWithoutActivation
скройтесь (_:) - скройтесь:

Скрывает окна всего получателя, и следующее приложение в строке активируется.

Объявление

Swift

func hide(_ sender: AnyObject?)

Objective C

- (void)hide:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– miniaturizeAll:
– выведите на экран:
– unhideWithoutActivation
applicationDidHide: (NSApplicationDelegate)
applicationWillHide: (NSApplicationDelegate)
выведите на экран (_:) - выведите на экран:

Восстановления скрытые окна на экран и делают получатель активным.

Объявление

Swift

func unhide(_ sender: AnyObject?)

Objective C

- (void)unhide:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

Вызывает unhideWithoutActivation.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activateIgnoringOtherApps:
– скройтесь:
unhideWithoutActivation () - unhideWithoutActivation

Восстановления скрытые окна, не активируя их владельца (получатель).

Объявление

Swift

func unhideWithoutActivation()

Objective C

- (void)unhideWithoutActivation

Обсуждение

Когда этот метод начинается, он отправляет NSApplicationWillUnhideNotification к центру уведомления по умолчанию. Если это завершается успешно, это отправляет NSApplicationDidUnhideNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activateIgnoringOtherApps:
– скройтесь:
applicationDidUnhide: (NSApplicationDelegate)
applicationWillUnhide: (NSApplicationDelegate)

Обновление Windows

updateWindows () - updateWindows

Отправляет update обменивайтесь сообщениями к каждому экранному окну.

Объявление

Swift

func updateWindows()

Objective C

- (void)updateWindows

Обсуждение

Этот метод вызывается автоматически в основном цикле событий после каждого события при выполнении в NSDefaultRunLoopMode или NSModalRunLoopMode. Этот метод не вызывается автоматически при выполнении в NSEventTrackingRunLoopMode.

Когда этот метод начинается, он отправляет NSApplicationWillUpdateNotification к центру уведомления по умолчанию. Когда это успешно завершается, это отправляет NSApplicationDidUpdateNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

update (NSWindow)
– setWindowsNeedUpdate:
applicationDidUpdate: (NSApplicationDelegate)
applicationWillUpdate: (NSApplicationDelegate)


    
    setWindowsNeedUpdate (_:)
    - setWindowsNeedUpdate:

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

Объявление

Swift

func setWindowsNeedUpdate(_ flag: Bool)

Objective C

- (void)setWindowsNeedUpdate:(BOOL)flag

Параметры


      flag

Если YEStrue, окна получателя обновляются после того, как событие обрабатывается.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– updateWindows

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

preventWindowOrdering () - preventWindowOrdering

Подавляет обычное упорядочивание окна в обработке нового события mouseDown.

Объявление

Swift

func preventWindowOrdering()

Objective C

- (void)preventWindowOrdering

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
arrangeInFront (_:) - arrangeInFront:

Окна расположений перечислены в Меню окна перед всеми другими окнами.

Объявление

Swift

func arrangeInFront(_ sender: AnyObject?)

Objective C

- (void)arrangeInFront:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addWindowsItem:title:filename:
– removeWindowsItem:
makeKeyAndOrderFront: (NSWindow)

Доступ к главному меню

mainMenu mainMenu Свойство

Строка главного меню приложения.

Объявление

Swift

var mainMenu: NSMenu?

Objective C

@property(strong) NSMenu *mainMenu

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление меню окна

windowsMenu windowsMenu Свойство

Меню окна приложения.

Объявление

Swift

var windowsMenu: NSMenu?

Objective C

@property(strong) NSMenu *windowsMenu

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

Меню окна или nil если такое меню не существует или еще не было создано.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    addWindowsItem (_: title:filename:)
    - addWindowsItem:title:filename:

Добавляет элемент к Меню окна для данного окна.

Объявление

Swift

func addWindowsItem(_ aWindow: NSWindow, title aString: String, filename isFilename: Bool)

Objective C

- (void)addWindowsItem:(NSWindow *)aWindow title:(NSString *)aString filename:(BOOL)isFilename

Параметры

`aWindow`	Окно, добавляемое к меню. Если этот объект окна уже существует в Меню окна, этот метод не имеет никакого эффекта.
`aString`	Строка для отображения для пункта меню окна. То, как строка интерпретируется, зависит от значения в `isFilename` параметр.
`isFilename`	Если `NOfalse`, `aString` появляется буквально в меню; иначе, `aString` как предполагается, преобразованный путь с именем файла, предшествующего пути (путь `NSWindow` метод `setTitleWithRepresentedFilename:` показывает заголовок),

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– changeWindowsItem:title:filename:
setTitle: (NSWindow)


    
    changeWindowsItem (_: title:filename:)
    - changeWindowsItem:title:filename:

Изменяет элемент для данного окна в Меню окна к данной строке.

Объявление

Swift

func changeWindowsItem(_ aWindow: NSWindow, title aString: String, filename isFilename: Bool)

Objective C

- (void)changeWindowsItem:(NSWindow *)aWindow title:(NSString *)aString filename:(BOOL)isFilename

Параметры

`aWindow`	Окно, заголовок которого Вы хотите изменить в Меню окна. Если `aWindow` не находится в Меню окна, этот метод добавляет его.
`aString`	Строка для отображения для пункта меню окна. То, как строка интерпретируется, зависит от значения в `isFilename` параметр.
`isFilename`	Если `NOfalse`, `aString` появляется буквально в меню; иначе, `aString` как предполагается, преобразованный путь с именем файла, предшествующего пути (путь `NSWindow` метод `setTitleWithRepresentedFilename:` показывает заголовок),

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addWindowsItem:title:filename:
– removeWindowsItem:
setTitle: (NSWindow)

removeWindowsItem (_:) - removeWindowsItem:

Удаляет элемент Меню окна для данного окна.

Объявление

Swift

func removeWindowsItem(_ aWindow: NSWindow)

Objective C

- (void)removeWindowsItem:(NSWindow *)aWindow

Параметры

aWindow

Окно, пункт меню которого должен быть удален.

Обсуждение

Этот метод не препятствует тому, чтобы элемент был автоматически добавлен снова. Используйте setExcludedFromWindowsMenu: метод NSWindow если Вы хотите, чтобы элемент остался исключенным из Меню окна.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– addWindowsItem:title:filename:
– changeWindowsItem:title:filename:
updateWindowsItem (_:) - updateWindowsItem:

Обновляет элемент Меню окна для данного окна для отражения отредактированного состояния того окна.

Объявление

Swift

func updateWindowsItem(_ aWindow: NSWindow)

Objective C

- (void)updateWindowsItem:(NSWindow *)aWindow

Параметры

aWindow

Окно, пункт меню которого должен быть обновлен.

Обсуждение

Редко необходимо вызывать этот метод, потому что он вызывается автоматически когда состояние редактирования NSWindow объект установлен.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– changeWindowsItem:title:filename:
setDocumentEdited: (NSWindow)

Доступ к мозаике прикрепления

dockTile dockTile Свойство

Мозаика Прикрепления приложения. (только для чтения)

Объявление

Swift

var dockTile: NSDockTile { get }

Objective C

@property(readonly, strong) NSDockTile *dockTile

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление меню служб


    
    registerServicesMenuSendTypes (_: returnTypes:)
    - registerServicesMenuSendTypes:returnTypes:

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

Объявление

Swift

func registerServicesMenuSendTypes(_ sendTypes: [AnyObject], returnTypes returnTypes: [AnyObject])

Objective C

- (void)registerServicesMenuSendTypes:(NSArray *)sendTypes returnTypes:(NSArray *)returnTypes

Параметры

`sendTypes`	Массив `NSString` объекты, каждый из которых соответствует определенному типу области монтажа, который может отправить приложение.
`returnTypes`	Массив `NSString` объекты, каждый из которых соответствует определенному типу области монтажа, который может получить приложение.

Обсуждение

Если получатель имеет меню Services, пункт меню добавляется для каждого поставщика услуг, который может принять один из указанных sendTypes или возвратите один из указанных returnTypes. Во время запуска приложения необходимо обычно вызывать этот метод или когда создается объект, который может использовать службы. Можно вызвать его несколько раз — его цель состоит в том, чтобы гарантировать, что существует пункт меню для каждой службы, которую может использовать приложение. Механизм обработки событий динамично позволит отдельным элементам указать, какие службы являются в настоящее время надлежащими. Весь NSResponder объекты в Вашем приложении (обычно NSView объекты), должен зарегистрировать каждый возможный тип, который они могут отправить и получить путем отправки этого сообщения в NSApp.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– validRequestorForSendType:returnType:
readSelectionFromPasteboard: (Протокол NSServicesRequests)
writeSelectionToPasteboard:types: (Протокол NSServicesRequests)

servicesMenu servicesMenu Свойство

Меню Services приложения.

Объявление

Swift

var servicesMenu: NSMenu?

Objective C

@property(strong) NSMenu *servicesMenu

Обсуждение

Это свойство содержит меню Services приложения или nil если не было создано то меню. Можно присвоить новое значение свойству для установки меню Services для приложения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление состоянием активации приложения

активный активный Свойство

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

Объявление

Swift

var active: Bool { get }

Objective C

@property(getter=isActive, readonly) BOOL active

Обсуждение

Значение этого свойства YEStrue если приложение активно или NOfalse если это не.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activateIgnoringOtherApps:
– деактивироваться


    
    activateIgnoringOtherApps (_:)
    - activateIgnoringOtherApps:

Делает получатель активным приложением.

Объявление

Swift

func activateIgnoringOtherApps(_ flag: Bool)

Objective C

- (void)activateIgnoringOtherApps:(BOOL)flag

Параметры


      flag

Если NOfalse, приложение активируется, только если никакое другое приложение не в настоящее время активно. Если YEStrue, приложение активируется независимо.

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– деактивироваться
активный

деактивируйтесь () - деактивироваться

Деактивировал получатель.

Объявление

Swift

func deactivate()

Objective C

- (void)deactivate

Обсуждение

Обычно, Вы не должны вызывать этот метод — AppKit ответственен за надлежащую деактивацию.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activateIgnoringOtherApps:

Сокрытие приложений

hideOtherApplications (_:) - hideOtherApplications:

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

Объявление

Swift

func hideOtherApplications(_ sender: AnyObject?)

Objective C

- (void)hideOtherApplications:(id)sender

Параметры

sender

Объект, отправивший это сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
unhideAllApplications (_:) - unhideAllApplications:

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

Объявление

Swift

func unhideAllApplications(_ sender: AnyObject?)

Objective C

- (void)unhideAllApplications:(id)sender

Параметры

sender

Объект, отправивший это сообщение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Providing Services


    
    validRequestorForSendType (_: returnType:)
    - validRequestorForSendType:returnType:

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

Объявление

Swift

func validRequestorForSendType(_ sendType: String, returnType returnType: String) -> AnyObject?

Objective C

- (id)validRequestorForSendType:(NSString *)sendType returnType:(NSString *)returnType

Параметры

`sendType`	Тип области монтажа приложение должен отправить.
`returnType`	Тип области монтажа приложение должен получить.

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

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

Обсуждение

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

Получатель передает это сообщение своему делегату, если делегат может ответить (и не NSResponder объект с его собственным следующим респондентом). Если делегат не может ответить или возвращается nil, этот метод возвраты nil. Если делегат может найти объект, который может отправить sendType данные и принимают назад returnType данные, это возвращает тот объект.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerServicesMenuSendTypes:returnTypes:
validRequestorForSendType:returnType: (NSResponder)
readSelectionFromPasteboard: (Протокол NSServicesRequests)
writeSelectionToPasteboard:types: (Протокол NSServicesRequests)

servicesProvider servicesProvider Свойство

Объект, предоставляющий услуги текущее приложение, распространяется в меню Services других приложений.

Объявление

Swift

var servicesProvider: AnyObject?

Objective C

@property(strong) id servicesProvider

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

Объект поставщика услуг приложения.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отображение справки

showHelp (_:) - showHelp:

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

Объявление

Swift

func showHelp(_ sender: AnyObject?)

Objective C

- (void)showHelp:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

Для получения информации о том, как установить Ваш проект использовать в своих интересах наличие Средства просмотра Справки, выведите на экран свою книгу справки, посмотрите Указание Всестороннего Файла справки.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activateContextHelpMode:
activateContextHelpMode (_:) - activateContextHelpMode:

Помещает получатель в контекстно-зависимый режим справки.

Объявление

Swift

func activateContextHelpMode(_ sender: AnyObject?)

Objective C

- (void)activateContextHelpMode:(id)sender

Параметры

sender

Объект, отправивший команду.

Обсуждение

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

Большинство приложений не использует этот метод. Вместо этого приложения переходят к контекстно-зависимому режиму, когда пользователь нажимает Клавишу вызова справки. Приложения выходят из контекстно-зависимого режима справки на первое событие после того, как окно справки будет выведено на экран.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– showHelp:
helpMenu helpMenu Свойство

Меню справки используется приложением.

Объявление

Swift

var helpMenu: NSMenu?

Objective C

@property(strong) NSMenu *helpMenu

Обсуждение

Используйте это свойство для указания Меню справки приложения. Когда это свойство содержит допустимое меню, система устанавливает свои Связанные с центром внимания пункты меню в том меню. Когда значение nil, AppKit устанавливает пункты меню Spotlight в меню его выбора. Для подавления элементов справки Центра внимания в целом укажите меню, не появляющееся в строке меню.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Управление потоками


    
    detachDrawingThread (_: toTarget:withObject:)
    + detachDrawingThread:toTarget:withObject:

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

Объявление

Swift

class func detachDrawingThread(_ selector: Selector, toTarget target: AnyObject, withObject argument: AnyObject?)

Objective C

+ (void)detachDrawingThread:(SEL)selector toTarget:(id)target withObject:(id)argument

Параметры

`selector`	Селектор, код которого Вы хотите выполнить в новом потоке.
`target`	Объект, определяющий указанный селектор.
`argument`	Дополнительный аргумент Вы хотите передать селектору.

Обсуждение

Этот метод является оберткой удобства для detachNewThreadSelector:toTarget:withObject: метод NSThread. Этот метод автоматически создает @autoreleasepool блок для нового потока перед вызовом selector.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Регистрация действий


    
    tryToPerform (_: с:)
    - tryToPerform:with:

Диспетчеризирует сообщение действия указанной цели.

Объявление

Swift

func tryToPerform(_ aSelector: Selector, with anObject: AnyObject?) -> Bool

Objective C

- (BOOL)tryToPerform:(SEL)aSelector with:(id)anObject

Параметры

`aSelector`	Сообщение действия Вы хотите диспетчеризировать.
`anObject`	Целевой объект, определяющий указанный селектор.

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

YEStrue если или получатель или его делегат могут принять указанный селектор; иначе, NOfalse. Этот метод также возвращается NOfalse если aSelector nil.

Обсуждение

Получатель пытается выполнить метод aSelector использование его наследованный tryToPerform:with: метод NSResponder. Если получатель не выполняет aSelector, делегату дают возможность выполнить его с помощью его наследованного performSelector:withObject: метод NSObject.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

respondsToSelector: (NSObject протокол)


    
    sendAction (_: to:from:)
    - sendAction:to:from:

Отправляет данное сообщение действия в данную цель.

Объявление

Swift

func sendAction(_ anAction: Selector, to aTarget: AnyObject?, from sender: AnyObject?) -> Bool

Objective C

- (BOOL)sendAction:(SEL)anAction to:(id)aTarget from:(id)sender

Параметры

`anAction`	Сообщение действия Вы хотите отправить.
`aTarget`	Целевой объект, определяющий указанное сообщение действия.
`sender`	Объект передать для параметра сообщения действия.

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

YEStrue если было успешно отправлено действие; иначе NOfalse. Этот метод также возвращается NOfalse если anAction nil.

Обсуждение

Если aTarget nil, sharedApplication ищет объект, который может реагировать на сообщение — т.е. объект, реализующий соответствие метода anAction. Это начинается с первого респондента ключевого окна. Если первый респондент не может ответить, это судит следующего респондента первого респондента и продолжается после следующего респондента, соединяет цепочку респондента. Если ни один из объектов в цепочке респондента ключевого окна не может обработать сообщение, sharedApplication попытки отправить сообщение делегату ключевого окна.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– targetForAction:
– tryToPerform:with:
– makeWindowsPerform:inOrder:

targetForAction (_:) - targetForAction:

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

Объявление

Swift

func targetForAction(_ aSelector: Selector) -> AnyObject?

Objective C

- (id)targetForAction:(SEL)aSelector

Параметры

aSelector

Желаемое сообщение действия.

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

Объект, который получил бы указанное сообщение действия или nil если никакой целевой объект не получил бы сообщение. Этот метод также возвращается nil если aSelector nil.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sendAction:to:from:
– tryToPerform:with:
– targetForAction:to:from:


    
    targetForAction (_: to:from:)
    - targetForAction:to:from:

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

Объявление

Swift

func targetForAction(_ anAction: Selector, to aTarget: AnyObject?, from sender: AnyObject?) -> AnyObject?

Objective C

- (id)targetForAction:(SEL)anAction to:(id)aTarget from:(id)sender

Параметры

`anAction`	Желаемое сообщение действия. Может быть `nil`, когда возвратится этот метод `nil`.
`aTarget`	Целевой объект для проверки. Указать `nil` если Вы хотите искать цепочку респондента начиная с текущего первого респондента.
`sender`	Потенциальный отправитель для сообщения действия.

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

Объект, который может принять указанное сообщение действия или nil если никакой целевой объект не может получить сообщение от указанного sender. Возвраты nil если anAction nil.

Обсуждение

Система ищет объект, реализующий соответствие метода anAction.

Если aTarget указан, система проверяет, что это - допустимая цель для предоставленного действия и отправителя, возвращаясь aTarget если допустимый, nil иначе.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– sendAction:to:from:
– tryToPerform:with:
– targetForAction:

Окна рисунка

контекст контекст Свойство

Графический контекст связался с приложением. (только для чтения)

Объявление

Swift

var context: NSGraphicsContext? { get }

Objective C

@property(readonly, strong) NSGraphicsContext *context

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Журналирование исключений


    
    reportException (_:)
    - reportException:

Регистрирует данное исключение путем вызова NSLog().

Объявление

Swift

func reportException(_ anException: NSException)

Objective C

- (void)reportException:(NSException *)anException

Параметры


      anException

Исключение, содержание которого Вы хотите записать в файл журнала.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSSetUncaughtExceptionHandler (Функции основы)

Управление пользовательскими запросами внимания


    
    requestUserAttention (_:)
    - requestUserAttention:

Запускает пользовательский запрос внимания.

Объявление

Swift

func requestUserAttention(_ requestType: NSRequestUserAttentionType) -> Int

Objective C

- (NSInteger)requestUserAttention:(NSRequestUserAttentionType)requestType

Параметры


      requestType

Серьезность запроса. Для списка возможных значений посмотрите NSRequestUserAttentionType.

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

Идентификатор для запроса. Можно использовать это значение для отмены запроса позже с помощью cancelUserAttentionRequest: метод.

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– cancelUserAttentionRequest:

cancelUserAttentionRequest (_:) - cancelUserAttentionRequest:

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

Объявление

Swift

func cancelUserAttentionRequest(_ request: Int)

Objective C

- (void)cancelUserAttentionRequest:(NSInteger)request

Параметры

request

Идентификатор запроса, возвращенный requestUserAttention: метод.

Обсуждение

Запрос также отменяется автоматически пользовательской активацией приложения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– requestUserAttention:


    
    replyToOpenOrPrint (_:)
    - replyToOpenOrPrint:

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

Объявление

Swift

func replyToOpenOrPrint(_ reply: NSApplicationDelegateReply)

Objective C

- (void)replyToOpenOrPrint:(NSApplicationDelegateReply)reply

Параметры


      reply

Произошедшая ошибка. Для списка возможных значений посмотрите NSApplicationDelegateReply.

Обсуждение

Если с ошибкой встречаются в, делегаты должны вызвать этот метод application:openFiles: или application:printFiles:withSettings:showPrintPanels: методы делегата.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступность клавиатуры

fullKeyboardAccessEnabled fullKeyboardAccessEnabled Свойство

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

Объявление

Swift

var fullKeyboardAccessEnabled: Bool { get }

Objective C

@property(getter=isFullKeyboardAccessEnabled, readonly) BOOL fullKeyboardAccessEnabled

Обсуждение

Значение этого свойства YEStrue если Полный Доступ Клавиатуры включен или NOfalse если это не. Вы могли бы использовать это значение, чтобы реализовать Ваш собственный ключевой цикл или реализовать в управлении снабжающее вкладками поведение, подобное NSTableView. Из-за природы предпочтительного хранения Вы не будете уведомлены относительно изменений в этом свойстве, при попытке наблюдать его через наблюдение значения ключа; однако, доступ к этому свойству довольно недорог, таким образом, можно получить доступ к нему непосредственно вместо того, чтобы кэшировать его.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Опции представления

currentSystemPresentationOptions currentSystemPresentationOptions Свойство
Набор опций представления приложения, которые являются в настоящее время в действительности для системы. (только для чтения)

Объявление

Swift

var currentSystemPresentationOptions: NSApplicationPresentationOptions { get }

Objective C

@property(readonly) NSApplicationPresentationOptions currentSystemPresentationOptions

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

Опции представления. Константы перечислены в NSApplicationPresentationOptions, и может объединенное использование оператора битового «ИЛИ» C.
Обсуждение

Это свойство содержит опции представления, осуществленные в настоящее время активным приложением. Можно использовать наблюдение значения ключа относительно этого свойства для получения уведомлений когда:
- Клиент является активным приложением и вносит само изменение с помощью любого presentationOptions свойство или SetSystemUIMode функция.
- Другое приложение активно и делает собственные изменения презентации.
- Другое приложение становится активным и вызывает активный набор опций представления измениться.
Уведомления наблюдения значения ключа не отправляются, когда одно из вышеупомянутых условий происходит, но имеет тот же набор опций представления как ранее активное приложение.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

presentationOptions
presentationOptions presentationOptions Свойство

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

Объявление

Swift

var presentationOptions: NSApplicationPresentationOptions

Objective C

@property NSApplicationPresentationOptions presentationOptions

Обсуждение

Это значение содержит битовое «ИЛИ» констант, перечисленных в NSApplicationPresentationOptions. Попытка установить свойство в недопустимую комбинацию флагов опции повышает NSInvalidArgumentException исключение. Посмотрите константы для описания допустимых комбинаций.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

currentSystemPresentationOptions

Политика активации

activationPolicy () - activationPolicy

Возвращает политику активации приложения.

Объявление

Swift

func activationPolicy() -> NSApplicationActivationPolicy

Objective C

- (NSApplicationActivationPolicy)activationPolicy

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

Текущая политика активации приложения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– setActivationPolicy:
setActivationPolicy (_:) - setActivationPolicy:

Попытки изменить политику активации приложения.

Объявление

Swift

func setActivationPolicy(_ activationPolicy: NSApplicationActivationPolicy) -> Bool

Objective C

- (BOOL)setActivationPolicy:(NSApplicationActivationPolicy)activationPolicy

Параметры

activationPolicy

Желаемая политика активации.

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

YEStrue если переключатель политики был успешен, иначе NOfalse.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– activationPolicy

Центр внимания для справки


    
    registerUserInterfaceItemSearchHandler (_:)
    - registerUserInterfaceItemSearchHandler:

Зарегистрируйте объект, предоставляющий данные справки Вашему приложению.

Объявление

Swift

func registerUserInterfaceItemSearchHandler(_ handler: NSUserInterfaceItemSearching)

Objective C

- (void)registerUserInterfaceItemSearchHandler:(id<NSUserInterfaceItemSearching>)handler

Параметры


      handler

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– unregisterUserInterfaceItemSearchHandler:
– searchString:inUserInterfaceItemString:searchRange:foundRange:


    
    searchString (_: inUserInterfaceItemString:searchRange:foundRange:)
    - searchString:inUserInterfaceItemString:searchRange:foundRange:

Поиски строки в пользовательском интерфейсе.

Объявление

Swift

func searchString(_ searchString: String, inUserInterfaceItemString stringToSearch: String, searchRange searchRange: NSRange, foundRange foundRange: UnsafeMutablePointer<NSRange>) -> Bool

Objective C

- (BOOL)searchString:(NSString *)searchString inUserInterfaceItemString:(NSString *)stringToSearch searchRange:(NSRange)searchRange foundRange:(NSRange *)foundRange

Параметры

`searchString`	Строка поиска.
`stringToSearch`	Строка для поиска.
`searchRange`	Поддиапазон `stringToSearch` ограничить поиск.
`foundRange`	Возвраты, ссылкой, диапазон `searchString` в `stringToSearch`.

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

YEStrue если searchString является соответствующим, иначе NOfalse.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerUserInterfaceItemSearchHandler:


    
    unregisterUserInterfaceItemSearchHandler (_:)
    - unregisterUserInterfaceItemSearchHandler:

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

Объявление

Swift

func unregisterUserInterfaceItemSearchHandler(_ handler: NSUserInterfaceItemSearching)

Objective C

- (void)unregisterUserInterfaceItemSearchHandler:(id<NSUserInterfaceItemSearching>)handler

Параметры


      handler

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

Обсуждение

Если Вы не регистрируете тот же экземпляр несколько раз, последующие вызовы проигнорированы. Нерегистрация никогда не регистрировавшегося экземпляра проигнорирована.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– registerUserInterfaceItemSearchHandler:

Управление перезапуском на входе в систему

disableRelaunchOnLogin () - disableRelaunchOnLogin

Отключает перезапуск приложения на входе в систему.

Объявление

Swift

func disableRelaunchOnLogin()

Objective C

- (void)disableRelaunchOnLogin

Обсуждение

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

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

Если Ваше приложение не должно быть повторно запущено, потому что оно инициировало перезапуск, например установщик, то рекомендуемое использование должно сразу вызвать этот метод, прежде чем Вы попытаетесь инициировать перезапуск, и enableRelaunchOnLogin сразу после. Это вызвано тем, что пользователь может отменить перезапуск; если пользователь более поздние перезапуски по другой причине, то Ваше приложение должно быть возвращено.

Это методы ориентировано на многопотоковое исполнение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– enableRelaunchOnLogin
enableRelaunchOnLogin () - enableRelaunchOnLogin

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

Объявление

Swift

func enableRelaunchOnLogin()

Objective C

- (void)enableRelaunchOnLogin

Обсуждение

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

Это методы ориентировано на многопотоковое исполнение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– disableRelaunchOnLogin

Доступ к состоянию поглощения газов

occlusionState occlusionState Свойство

Состояние поглощения газов приложения. (только для чтения)

Объявление

Swift

var occlusionState: NSApplicationOcclusionState { get }

Objective C

@property(readonly) NSApplicationOcclusionState occlusionState

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

NSApplicationDidChangeOcclusionStateNotification

Сценарии

orderedDocuments - orderedDocuments

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

Объявление

Swift

var orderedDocuments: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *orderedDocuments

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

Массив NSDocument объекты, где позиция документа основывается на упорядочивании грудь-спина своего связанного окна.

Обсуждение

Этот метод вызывают во время оценки команды сценария — например, при нахождении документа в операторе сценария the third rectangle in the first document. Для получения информации о том, как Ваше приложение может возвратить свой собственный массив упорядоченных документов, видеть application:delegateHandlesKey:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– orderedWindows
orderedWindows - orderedWindows

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

Объявление

Swift

var orderedWindows: [AnyObject] { get }

Objective C

@property(readonly, copy) NSArray *orderedWindows

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

Массив NSWindow объекты, где позиция каждого окна в массиве соответствует упорядочиванию грудь-спина окон на экране.

Обсуждение

Только окна, которые обычно scriptable, включены в массив. Например, панели не включены. К этому свойству получают доступ во время оценки команды сценария — например, при нахождении окна в операторе сценария close the second window. Для получения информации о том, как Ваше приложение может возвратить свой собственный массив упорядоченных окон, видеть application:delegateHandlesKey:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– orderedDocuments

Осуждаемый

runModalForWindow:relativeToWindow: - runModalForWindow:relativeToWindow: (OS X v10.0)

Оператор осуждения

Использовать beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo: вместо этого.

Объявление

Objective C

- (NSInteger)runModalForWindow:(NSWindow *)theWindow relativeToWindow:(NSWindow *)docWindow

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
beginModalSessionForWindow:relativeToWindow: - beginModalSessionForWindow:relativeToWindow: (OS X v10.0)

Оператор осуждения

Использовать beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo: вместо этого.

Объявление

Objective C

- (NSModalSession)beginModalSessionForWindow:(NSWindow *)theWindow relativeToWindow:(NSWindow *)docWindow

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.0.
application:printFiles: application:printFiles: Доступный в OS X v10.3 через OS X v10.5

Оператор осуждения

Используйте метод делегата application:printFiles:withSettings:showPrintPanels: вместо этого.

Объявление

Objective C

- (void)application:(NSApplication *)sender printFiles:(NSArray *)filenames

Обсуждение

Идентичный application:printFile: за исключением того, что получатель распечатывает многократные файлы, соответствующие именам файлов в filenames массив.

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

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

Objective C

@import AppKit;

Доступность

Доступный в OS X v10.3 через OS X v10.5.
приложение (_: delegateHandlesKey:) application:delegateHandlesKey:
Отправленный встроенными сценариями Какао поддерживают во время выполнения get или set команды сценария, чтобы узнать, может ли делегат обработать операции на указанном ключе значения ключа.

Не реализуйте этот метод.

Объявление

Swift

func application(_ sender: NSApplication, delegateHandlesKey key: String) -> Bool

Objective C

- (BOOL)application:(NSApplication *)sender delegateHandlesKey:(NSString *)key
Обсуждение

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

Например, scriptable приложение, не использующее основанную на документе архитектуру приложения Какао, может реализовать этот метод для предоставления его собственного упорядочивания документа. Такое приложение могло бы хотеть сделать это, потому что типичный делегат приложения ожидает работать с основанным на документе приложением. Приложение TextEdit (чей источник распределяется с инструментами разработчика Mac OS X) обеспечивает следующую реализацию:
return [key isEqualToString:@"orderedDocuments"];
TextEdit тогда реализует orderedDocuments метод в его классе контроллера для возврата упорядоченного списка документов. Приложение с его собственным упорядочиванием окна могло бы добавить тест для ключа orderedWindows так, чтобы его делегат мог обеспечить его собственную версию orderedWindows.

Важный

Сценарии какао не вызывают этот метод для команд сценария кроме get или set. Для получения информации о работе с другими командами посмотрите Команды Сценария в Руководстве по созданию сценариев Какао.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

orderedDocuments (NSApplication)
orderedWindows (NSApplication)


    
    beginSheet (_: modalForWindow:modalDelegate:didEndSelector:contextInfo:)
    - beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:

(OS X v10.10)

Запускает документ модальный сеанс.

Оператор осуждения

Используйте beginSheet:completionHandler: метод NSWindow вместо этого.

Объявление

Swift

func beginSheet(_ sheet: NSWindow, modalForWindow docWindow: NSWindow, modalDelegate modalDelegate: AnyObject?, didEndSelector didEndSelector: Selector, contextInfo contextInfo: UnsafeMutablePointer<Void>)

Objective C

- (void)beginSheet:(NSWindow *)sheet modalForWindow:(NSWindow *)docWindow modalDelegate:(id)modalDelegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo

Параметры

`sheet`	Объект окна, представляющий лист, Вы хотите вывести на экран.
`docWindow`	Объект окна, к которому Вы хотите присоединить лист.
`modalDelegate`	Объект делегата, определяющий Ваш `didEndSelector` метод. Если `nil`, метод в `didEndSelector` не вызывается.
`didEndSelector`	Дополнительный метод для вызова, когда закончился модальный сеанс листа. Этот метод должен быть определен на объекте в `modalDelegate` параметр и имеет следующую подпись: `- (void)sheetDidEnd:(NSWindow )sheet returnCode:(NSInteger)returnCode contextInfo:(void )contextInfo;`
`contextInfo`	Указатель на информацию контекста, которую Вы хотите, передал `didEndSelector` метод, когда заканчивается модальный сеанс листа.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Осуждаемый в OS X v10.10.

См. также

– форзац:
– endSheet:returnCode:

форзац (_:) - форзац: (OS X v10.10)

Заканчивает документ модальный сеанс путем указания окна листа.

Объявление

Swift

func endSheet(_ sheet: NSWindow)

Objective C

- (void)endSheet:(NSWindow *)sheet

Параметры

sheet

Лист, модальный сеанс которого Вы хотите закончить.

Обсуждение

Этот метод заканчивает модальный сеанс кодом возврата NSModalResponseStop.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Осуждаемый в OS X v10.10.

См. также

– beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:
– endSheet:returnCode:


    
    форзац (_: код возврата:)
    - endSheet:returnCode:

(OS X v10.10)

Заканчивает документ модальный сеанс путем указания окна листа.

Объявление

Swift

func endSheet(_ sheet: NSWindow, returnCode returnCode: Int)

Objective C

- (void)endSheet:(NSWindow *)sheet returnCode:(NSInteger)returnCode

Параметры

`sheet`	Лист, модальный сеанс которого Вы хотите закончить.
`returnCode`	Код возврата для отправки делегату. Можно использовать один из кодов возврата, определенных в `NSModalResponse` или пользовательское значение, которое Вы определяете.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Осуждаемый в OS X v10.10.

См. также

– beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:
– форзац:

Типы данных

NSUserInterfaceLayoutDirection NSUserInterfaceLayoutDirection
Указывает направленный поток пользовательского интерфейса. Эти константы возвращаются userInterfaceLayoutDirection.

Объявление

Swift

enum NSUserInterfaceLayoutDirection : Int { case LeftToRight case RightToLeft }

Objective C

enum { NSUserInterfaceLayoutDirectionLeftToRight = 0, NSUserInterfaceLayoutDirectionRightToLeft = 1 }; typedef NSInteger NSUserInterfaceLayoutDirection;

Константы
- LeftToRight
  
  NSUserInterfaceLayoutDirectionLeftToRight
  
  Направление макета слева направо.
  
  Доступный в OS X v10.6 и позже.
- RightToLeft
  
  NSUserInterfaceLayoutDirectionRightToLeft
  
  Направление макета справа налево. Это является надлежащим при выполнении с локализациями, такими как арабский или иврит, который должен иметь источник макета интерфейса пользователя на правом краю системы координат.
  
  Доступный в OS X v10.6 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.
NSModalResponse NSModalResponse
Возвращаемые значения для -runModalForWindow: и runModalSession:.

Объявление

Swift

typealias NSModalResponse = Int

Objective C

enum { NSModalResponseStop = (-1000), NSModalResponseAbort = (-1001), NSModalResponseContinue = (-1002), }; typedef NSInteger NSModalResponse;

Константы
- NSModalResponseStop
  
  NSModalResponseStop
  
  С модальным сеансом порвали stopModal.
  
  Эта константа также используется в качестве ответа по умолчанию для листа.
  
  Доступный в OS X v10.9 и позже.
- NSModalResponseAbort
  
  NSModalResponseAbort
  
  С модальным сеансом порвали abortModal.
  
  Доступный в OS X v10.9 и позже.
- NSModalResponseContinue
  
  NSModalResponseContinue
  
  Модальный сеанс продолжается (возвращенный runModalSession: только).
  
  Доступный в OS X v10.9 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.9 и позже.
NSRequestUserAttentionType NSRequestUserAttentionType
Эти константы указывают, что уровень серьезности пользовательского внимания запрашивает и используется cancelUserAttentionRequest: и requestUserAttention:.

Объявление

Swift

enum NSRequestUserAttentionType : UInt { case CriticalRequest case InformationalRequest }

Objective C

enum { NSCriticalRequest = 0, NSInformationalRequest = 10 } typedef NSUInteger NSRequestUserAttentionType;

Константы
- CriticalRequest
  
  NSCriticalRequest
  
  Пользовательский запрос внимания является критическим запросом.
  
  Значок панелей возвратится, или до приложение становится активным или до запрос, отменяется.
  
  Доступный в OS X v10.1 и позже.
- InformationalRequest
  
  NSInformationalRequest
  
  Пользовательский запрос внимания является информационным запросом.
  
  Значок панелей возвратится в течение одной секунды. Запрос, тем не менее, остается активным, пока или приложение не становится активным или запрос, отменяется.
  
  Доступный в OS X v10.1 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.1 и позже.
NSApplicationDelegateReply NSApplicationDelegateReply
Эти константы указывают, распечатывает ли копия или работу, было успешным, был отменен или отказавшим. Эти константы используются replyToOpenOrPrint: метод.

Объявление

Swift

enum NSApplicationDelegateReply : UInt { case Success case Cancel case Failure }

Objective C

enum NSApplicationDelegateReply { NSApplicationDelegateReplySuccess = 0, NSApplicationDelegateReplyCancel = 1, NSApplicationDelegateReplyFailure = 2 } typedef NSUInteger NSApplicationDelegateReply;

Константы
- Success
  
  NSApplicationDelegateReplySuccess
  
  Указывает работу, за которой следуют.
  
  Доступный в OS X v10.3 и позже.
- Cancel
  
  NSApplicationDelegateReplyCancel
  
  Указывает, что пользователь отменил работу.
  
  Доступный в OS X v10.3 и позже.
- Failure
  
  NSApplicationDelegateReplyFailure
  
  Указывает, что ошибка произошла, обработав работу.
  
  Доступный в OS X v10.3 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.3 и позже.
NSApplicationPresentationOptions NSApplicationPresentationOptions
Константы, управляющие представлением приложения, обычно для полноэкранных приложений, таких как игры или киоски.

Объявление

Swift

struct NSApplicationPresentationOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Default: NSApplicationPresentationOptions { get } static var AutoHideDock: NSApplicationPresentationOptions { get } static var HideDock: NSApplicationPresentationOptions { get } static var AutoHideMenuBar: NSApplicationPresentationOptions { get } static var HideMenuBar: NSApplicationPresentationOptions { get } static var DisableAppleMenu: NSApplicationPresentationOptions { get } static var DisableProcessSwitching: NSApplicationPresentationOptions { get } static var DisableForceQuit: NSApplicationPresentationOptions { get } static var DisableSessionTermination: NSApplicationPresentationOptions { get } static var DisableHideApplication: NSApplicationPresentationOptions { get } static var DisableMenuBarTransparency: NSApplicationPresentationOptions { get } static var FullScreen: NSApplicationPresentationOptions { get } static var AutoHideToolbar: NSApplicationPresentationOptions { get } }

Objective C

enum { NSApplicationPresentationDefault = 0, NSApplicationPresentationAutoHideDock = (1 << 0), NSApplicationPresentationHideDock = (1 << 1), NSApplicationPresentationAutoHideMenuBar = (1 << 2), NSApplicationPresentationHideMenuBar = (1 << 3), NSApplicationPresentationDisableAppleMenu = (1 << 4), NSApplicationPresentationDisableProcessSwitching = (1 << 5), NSApplicationPresentationDisableForceQuit = (1 << 6), NSApplicationPresentationDisableSessionTermination = (1 << 7), NSApplicationPresentationDisableHideApplication = (1 << 8), NSApplicationPresentationDisableMenuBarTransparency = (1 << 9) NSApplicationPresentationFullScreen = (1 << 10), NSApplicationPresentationAutoHideToolbar = (1 << 11) }; typedef NSUInteger NSApplicationPresentationOptions;

Константы
- Default
  
  NSApplicationPresentationDefault
  
  Это - режим презентации по умолчанию. Прикрепление и строка меню выведены на экран, переключение процесса включено, выход силы включен, завершение сеанса включено, скрыть меню включено, и прозрачность строки меню нормальна.
  
  Доступный в OS X v10.6 и позже.
- AutoHideDock
  
  NSApplicationPresentationAutoHideDock
  
  Прикрепление обычно скрыто, но автоматически появляется когда moused рядом.
  
  Доступный в OS X v10.6 и позже.
- HideDock
  
  NSApplicationPresentationHideDock
  
  Прикрепление полностью скрыто и отключено.
  
  Доступный в OS X v10.6 и позже.
- AutoHideMenuBar
  
  NSApplicationPresentationAutoHideMenuBar
  
  Строка меню обычно скрыта, но автоматически появляется когда moused рядом.
  
  Доступный в OS X v10.6 и позже.
- HideMenuBar
  
  NSApplicationPresentationHideMenuBar
  
  Строка меню полностью скрыта и отключена.
  
  Доступный в OS X v10.6 и позже.
- DisableAppleMenu
  
  NSApplicationPresentationDisableAppleMenu
  
  Все элементы Меню Apple отключены.
  
  Доступный в OS X v10.6 и позже.
- DisableProcessSwitching
  
  NSApplicationPresentationDisableProcessSwitching
  
  Пользовательский интерфейс переключения процесса (Команда + Вкладка для циклического повторения через приложения) отключен.
  
  Доступный в OS X v10.6 и позже.
- DisableForceQuit
  
  NSApplicationPresentationDisableForceQuit
  
  Сила вышла из панели (выведенный на экран путем нажатия Command + Опция + Esc), отключен
  
  Доступный в OS X v10.6 и позже.
- DisableSessionTermination
  
  NSApplicationPresentationDisableSessionTermination
  
  Панель, показывающая Перезапуск, Завершение работы и опции Log Out, выведенные на экран в результате продвижения ключа питания, отключена.
  
  Доступный в OS X v10.6 и позже.
- DisableHideApplication
  
  NSApplicationPresentationDisableHideApplication
  
  Пункт меню «Hide» приложения отключен.
  
  Доступный в OS X v10.6 и позже.
- DisableMenuBarTransparency
  
  NSApplicationPresentationDisableMenuBarTransparency
  
  Появление прозрачности строки меню отключено.
  
  Доступный в OS X v10.6 и позже.
- FullScreen
  
  NSApplicationPresentationFullScreen
  
  Приложение находится в полноэкранном режиме.
  
  Доступный в OS X v10.7 и позже.
- AutoHideToolbar
  
  NSApplicationPresentationAutoHideToolbar
  
  Когда в полноэкранном режиме панель инструментов окна отсоединяется из окна и скрывает и показывает с автоскрытой строкой меню.
  
  Доступный в OS X v10.7 и позже.
Обсуждение

Существуют ограничения на комбинацию опций представления, которые могут быть установлены одновременно:
- NSApplicationPresentationAutoHideDock и NSApplicationPresentationHideDock являются взаимоисключающими: можно указать один или другой, но не оба.
- NSApplicationPresentationAutoHideMenuBar и NSApplicationPresentationHideMenuBar являются взаимоисключающими: можно указать один или другой, но не оба.
- Если Вы указываете NSApplicationPresentationHideMenuBar, это должно сопровождаться NSApplicationPresentationHideDock.
- Если Вы указываете NSApplicationPresentationAutoHideMenuBar, это должно сопровождаться также NSApplicationPresentationHideDock или NSApplicationPresentationAutoHideDock.
- Если Вы указываете какой-либо из NSApplicationPresentationDisableProcessSwitching, NSApplicationPresentationDisableForceQuit, NSApplicationPresentationDisableSessionTermination, или NSApplicationPresentationDisableMenuBarTransparency, это должно сопровождаться также NSApplicationPresentationHideDock или NSApplicationPresentationAutoHideDock.
- NSApplicationPresentationAutoHideToolbar может использоваться только когда оба NSApplicationPresentationFullScreen и NSApplicationPresentationAutoHideMenuBar также установлены.
Когда setPresentationOptions: получает значение параметра, не соответствующее этим требованиям, оно повышает NSInvalidArgumentException.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.
NSApplicationTerminateReply NSApplicationTerminateReply
Эти константы определяют, должно ли приложение завершиться и используется методом делегата applicationShouldTerminate:.

Объявление

Swift

enum NSApplicationTerminateReply : UInt { case TerminateCancel case TerminateNow case TerminateLater }

Objective C

enum { NSTerminateCancel = 0, NSTerminateNow = 1, NSTerminateLater = 2 } typedef NSUInteger NSApplicationTerminateReply;

Константы
- TerminateNow
  
  NSTerminateNow
  
  Нормально продолжаться с завершением.
  
  Доступный в OS X v10.0 и позже.
- TerminateCancel
  
  NSTerminateCancel
  
  Приложение не должно быть завершено.
  
  Доступный в OS X v10.0 и позже.
- TerminateLater
  
  NSTerminateLater
  
  Может быть нормально продолжаться с завершением позже. Возврат этого значения заставляет Какао выполнять цикл выполнения в NSModalPanelRunLoopMode пока Ваше приложение впоследствии не вызывает replyToApplicationShouldTerminate: со значением YEStrue или NOfalse. Это возвращаемое значение для делегатов, которые должны обеспечить документ модальные предупреждения (листы), чтобы решить, выйти ли.
  
  Доступный в OS X v10.0 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
NSApplicationPrintReply NSApplicationPrintReply
Эти константы возвращаются методом делегата application:printFiles:withSettings:showPrintPanels:.

Объявление

Swift

enum NSApplicationPrintReply : UInt { case PrintingCancelled case PrintingSuccess case PrintingFailure case PrintingReplyLater }

Objective C

enum { NSPrintingCancelled = 0, NSPrintingSuccess = 1, NSPrintingFailure = 3, NSPrintingReplyLater = 2 } typedef NSUInteger NSApplicationPrintReply;

Константы
- PrintingCancelled
  
  NSPrintingCancelled
  
  Печать была отменена.
  
  Доступный в OS X v10.4 и позже.
- PrintingSuccess
  
  NSPrintingSuccess
  
  Печать была успешна.
  
  Доступный в OS X v10.4 и позже.
- PrintingFailure
  
  NSPrintingFailure
  
  Печать перестала работать.
  
  Доступный в OS X v10.4 и позже.
- PrintingReplyLater
  
  NSPrintingReplyLater
  
  Например, если печать вызовет представление листа, результат печати не может быть сразу возвращен. Если возвращается Ваш метод NSPrintingReplyLater это должно всегда вызывать replyToOpenOrPrint: когда вся работа печати была завершена, успешно или нет.
  
  Доступный в OS X v10.4 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.4 и позже.
NSApplicationOcclusionState NSApplicationOcclusionState
Это, которое указывают константы, видима ли, по крайней мере, часть какого-либо окна, принадлежавшего этому приложению.

Объявление

Swift

struct NSApplicationOcclusionState : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var Visible: NSApplicationOcclusionState { get } }

Objective C

typedef NS_OPTIONS(NSUInteger, NSApplicationOcclusionState) { NSApplicationOcclusionStateVisible = 1UL << 1, }

Константы
- Visible
  
  NSApplicationOcclusionStateVisible
  
  Если установлено, по крайней мере часть любого окна, принадлежавшего этому приложению, видима.
  
  Если не набор, полностью закрываются все части всех окон, принадлежавших этому приложению. Строка меню не рассчитывает как окно принадлежавший этому приложению, поэтому если только строка меню показывает тогда, что приложение считают не видимым. Элементам состояния, однако, принадлежали окна Ваше приложение. Если элемент состояния будет присутствовать в строке меню, то Ваше приложение будут считать видимым, пока строка меню видима.
  
  Доступный в OS X v10.9 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Константы

NSApp
Глобальная константа для экземпляра общего приложения.

Объявление

Swift

var NSApp: AnyObject!

Objective C

id NSApp

Константы
- NSApp
  
  NSApp
  
  Глобальная константа для экземпляра общего приложения. Это совпадает с отправкой NSApplication классифицируйте метод sharedApplication сообщение.
  
  Доступный в OS X v10.0 и позже.
Обсуждение

Эта переменная определяет объект общего приложения, создаваемый sharedApplication методом.
Возвращаемые значения для модальных операций
Исторические возвращаемые значения для runModalForWindow: и runModalSession:.

Объявление

Swift

var NSRunStoppedResponse: Int { get } var NSRunAbortedResponse: Int { get } var NSRunContinuesResponse: Int { get }

Objective C

enum { NSRunStoppedResponse = (-1000), NSRunAbortedResponse = (-1001), NSRunContinuesResponse = (-1002) };

Константы
- NSRunStoppedResponse
  
  NSRunStoppedResponse
  
  С модальным сеансом порвали stopModal.
  Использовать NSModalResponseStop вместо этого.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.10.
- NSRunAbortedResponse
  
  NSRunAbortedResponse
  
  С модальным сеансом порвали abortModal.
  Использовать NSModalResponseAbort вместо этого.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.10.
- NSRunContinuesResponse
  
  NSRunContinuesResponse
  
  Модальный сеанс продолжается (возвращенный runModalSession: только).
  Использовать NSModalResponseContinue вместо этого.
  
  Доступный в OS X v10.0 и позже.
  Осуждаемый в OS X v10.10.
Обсуждение

Система также резервирует все значения ниже их.
NSUpdateWindowsRunLoopOrdering
Эта константа используется NSRunLoop метод performSelector:target:argument:order:modes:.

Объявление

Swift

var NSUpdateWindowsRunLoopOrdering: Int { get }

Objective C

enum { NSUpdateWindowsRunLoopOrdering = 500000 };

Константы
- NSUpdateWindowsRunLoopOrdering
  
  NSUpdateWindowsRunLoopOrdering
  
  Приоритет сообщения цикла выполнения для обработки обновлений окна.
  
  Доступный в OS X v10.0 и позже.
Выполненные режимы цикла
Эти константы режима цикла определяются NSApplication.

Объявление

Swift

var NSEventTrackingRunLoopMode: NSString! var NSModalPanelRunLoopMode: NSString!

Objective C

NSString *NSModalPanelRunLoopMode; NSString *NSEventTrackingRunLoopMode;

Константы
- NSEventTrackingRunLoopMode
  
  NSEventTrackingRunLoopMode
  
  Цикл выполнения должен быть установлен в этот режим при отслеживании событий модально, таких как перетаскивающий мышь цикл.
  
  Доступный в OS X v10.0 и позже.
- NSModalPanelRunLoopMode
  
  NSModalPanelRunLoopMode
  
  Цикл выполнения должен быть установлен в этот режим при ожидании ввода от модальной панели, такой как NSSavePanel или NSOpenPanel.
  
  Доступный в OS X v10.0 и позже.
Пользовательские информационные ключи NSApplicationDidFinishLaunching
Следующие константы определяют ключи, которые могут присутствовать в NSApplicationDidFinishLaunchingNotification.

Объявление

Swift

let NSApplicationLaunchIsDefaultLaunchKey: NSString! let NSApplicationLaunchUserNotificationKey: NSString!

Objective C

NSString * const NSApplicationLaunchRemoteNotificationKey; NSString * const NSApplicationLaunchIsDefaultLaunchKey; NSString * const NSApplicationLaunchUserNotificationKey;

Константы
- NSApplicationLaunchRemoteNotificationKey
  
  NSApplicationLaunchRemoteNotificationKey
  
  Используйте этот ключ для доступа к полезной нагрузке уведомления нажатия JSON от userInfo словарь NSApplicationDidFinishLaunchingNotification уведомление. Это уведомление передается в метод делегата application:didFinishLaunching: объявленный NSApplicationDelegate Protocol протокол для обработки этого уведомления. Для получения информации о словаре полезной нагрузки см. Локальное и Удаленное Руководство по программированию Уведомления.
  
  Доступный в OS X v10.7 и позже.
  Осуждаемый в OS X v10.8.
- NSApplicationLaunchIsDefaultLaunchKey
  
  NSApplicationLaunchIsDefaultLaunchKey
  
  Значение для этого ключа NSNumber содержа булево значение. Значение NOfalse если приложение было запущено, чтобы открыть или распечатать файл, выполнить действие Службы, если приложение сохранило состояние, которое будет восстановлено, или если запуск приложения был в некотором другом смысле не запуск по умолчанию. Иначе его значение будет YEStrue.
  
  Доступный в OS X v10.7 и позже.
- NSApplicationLaunchUserNotificationKey
  
  NSApplicationLaunchUserNotificationKey
  
  Следующий ключ NSUserNotification объект, который будет присутствовать в уведомлении userInfo словарь NSApplicationDidFinishLaunchingNotification уведомление, если Ваше приложение было запущено, потому что пользователь активировал уведомление в Центре Уведомления.
  
  Доступный в OS X v10.8 и позже.
NSRemoteNotificationType
Эти константы определяют, выводят ли приложения, запущенные удаленными уведомлениями, на экран значок.

Объявление

Swift

struct NSRemoteNotificationType : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var None: NSRemoteNotificationType { get } static var Badge: NSRemoteNotificationType { get } static var Sound: NSRemoteNotificationType { get } static var Alert: NSRemoteNotificationType { get } }

Objective C

enum { NSRemoteNotificationTypeNone = 0, NSRemoteNotificationTypeBadge = 1 << 0 NSRemoteNotificationTypeSound = 1 << 1, NSRemoteNotificationTypeAlert = 1 << 2, }; typedef NSUInteger NSRemoteNotificationType;

Константы
- None
  
  NSRemoteNotificationTypeNone
  
  Приложение не должно отображать значок.
  
  Доступный в OS X v10.7 и позже.
- Badge
  
  NSRemoteNotificationTypeBadge
  
  Приложение должно вывести на экран значок.
  
  Доступный в OS X v10.7 и позже.
- Sound
  
  NSRemoteNotificationTypeSound
  
  Приложение должно играть звук.
  
  Доступный в OS X v10.8 и позже.
- Alert
  
  NSRemoteNotificationTypeAlert
  
  Приложение должно вывести на экран предупреждение.
  
  Доступный в OS X v10.8 и позже.
Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
NSAppKitVersionNumber
Эта константа идентифицирует установленную версию платформы AppKit.

Объявление

Swift

let NSAppKitVersionNumber: Double

Objective C

const double NSAppKitVersionNumber;

Константы
- NSAppKitVersionNumber
  
  NSAppKitVersionNumber
  
  Это значение соответствует одной из констант, определенных в номерах версий платформы AppKit.
  
  Доступный в OS X v10.1 и позже.
Номера версий платформы AppKit
Можно использовать следующие константы, чтобы определить, используете ли Вы версию платформы AppKit, более новой, чем версия, поставленная в Mac OS X v10.0.

Объявление

Swift

var NSAppKitVersionNumber10_0: Int32 { get } var NSAppKitVersionNumber10_1: Int32 { get } var NSAppKitVersionNumber10_2: Int32 { get } var NSAppKitVersionNumber10_2_3: Double { get } var NSAppKitVersionNumber10_3: Int32 { get } var NSAppKitVersionNumber10_3_2: Double { get } var NSAppKitVersionNumber10_3_3: Double { get } var NSAppKitVersionNumber10_3_5: Double { get } var NSAppKitVersionNumber10_3_7: Double { get } var NSAppKitVersionNumber10_3_9: Double { get } var NSAppKitVersionNumber10_4: Int32 { get } var NSAppKitVersionNumber10_4_1: Double { get } var NSAppKitVersionNumber10_4_3: Double { get } var NSAppKitVersionNumber10_4_4: Double { get } var NSAppKitVersionNumber10_4_7: Double { get } var NSAppKitVersionNumber10_5: Int32 { get } var NSAppKitVersionNumber10_5_2: Double { get } var NSAppKitVersionNumber10_5_3: Double { get } var NSAppKitVersionNumber10_6: Int32 { get } var NSAppKitVersionNumber10_7: Int32 { get } var NSAppKitVersionNumber10_7_2: Double { get } var NSAppKitVersionNumber10_7_3: Double { get } var NSAppKitVersionNumber10_7_4: Double { get } var NSAppKitVersionNumber10_8: Int32 { get }

Objective C

#define NSAppKitVersionNumber10_0 577 #define NSAppKitVersionNumber10_1 620 #define NSAppKitVersionNumber10_2 663 #define NSAppKitVersionNumber10_2_3 663.6 #define NSAppKitVersionNumber10_3 743 #define NSAppKitVersionNumber10_3_2 743.14 #define NSAppKitVersionNumber10_3_3 743.2 #define NSAppKitVersionNumber10_3_5 743.24 #define NSAppKitVersionNumber10_3_7 743.33 #define NSAppKitVersionNumber10_3_9 743.36 #define NSAppKitVersionNumber10_4 824 #define NSAppKitVersionNumber10_4_1 824.1 #define NSAppKitVersionNumber10_4_3 824.23 #define NSAppKitVersionNumber10_4_4 824.33 #define NSAppKitVersionNumber10_4_7 824.41 #define NSAppKitVersionNumber10_5 949 #define NSAppKitVersionNumber10_5_2 949.27 #define NSAppKitVersionNumber10_5_3 949.33 #define NSAppKitVersionNumber10_6 1038 #define NSAppKitVersionNumber10_7 1138 #define NSAppKitVersionNumber10_7_2 1138.23

Константы
- NSAppKitVersionNumber10_0
  
  NSAppKitVersionNumber10_0
  
  Платформа AppKit, включенная в OS X v10.0.
  
  Доступный в OS X v10.1 и позже.
- NSAppKitVersionNumber10_1
  
  NSAppKitVersionNumber10_1
  
  Платформа AppKit, включенная в OS X v10.1.
  
  Доступный в OS X v10.2 и позже.
- NSAppKitVersionNumber10_2
  
  NSAppKitVersionNumber10_2
  
  Платформа AppKit, включенная в OS X v10.2.
  
  Доступный в OS X v10.3 и позже.
- NSAppKitVersionNumber10_2_3
  
  NSAppKitVersionNumber10_2_3
  
  Платформа AppKit, включенная в OS X v10.2.3.
  
  Доступный в OS X v10.3 и позже.
- NSAppKitVersionNumber10_3
  
  NSAppKitVersionNumber10_3
  
  Платформа AppKit, включенная в OS X v10.3.
  
  Доступный в OS X v10.4 и позже.
- NSAppKitVersionNumber10_3_2
  
  NSAppKitVersionNumber10_3_2
  
  Платформа AppKit, включенная в OS X v10.3.2.
  
  Доступный в OS X v10.4 и позже.
- NSAppKitVersionNumber10_3_3
  
  NSAppKitVersionNumber10_3_3
  
  Платформа AppKit, включенная в OS X v10.3.3.
  
  Доступный в OS X v10.4 и позже.
- NSAppKitVersionNumber10_3_5
  
  NSAppKitVersionNumber10_3_5
  
  Платформа AppKit, включенная в OS X v10.3.5.
  
  Доступный в OS X v10.4 и позже.
- NSAppKitVersionNumber10_3_7
  
  NSAppKitVersionNumber10_3_7
  
  Платформа AppKit, включенная в OS X v10.3.7.
  
  Доступный в OS X v10.5 и позже.
- NSAppKitVersionNumber10_3_9
  
  NSAppKitVersionNumber10_3_9
  
  Платформа AppKit, включенная в OS X v10.3.9.
  
  Доступный в OS X v10.5 и позже.
- NSAppKitVersionNumber10_4
  
  NSAppKitVersionNumber10_4
  
  Платформа AppKit, включенная в OS X v10.4.
  
  Доступный в OS X v10.5 и позже.
- NSAppKitVersionNumber10_4_1
  
  NSAppKitVersionNumber10_4_1
  
  Платформа AppKit, включенная в OS X v10.4.1.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_4_3
  
  NSAppKitVersionNumber10_4_3
  
  Платформа AppKit, включенная в OS X v10.4.3.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_4_4
  
  NSAppKitVersionNumber10_4_4
  
  Платформа AppKit, включенная в OS X v10.4.4.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_4_7
  
  NSAppKitVersionNumber10_4_7
  
  Платформа AppKit, включенная в OS X v10.4.7.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_5
  
  NSAppKitVersionNumber10_5
  
  Платформа AppKit, включенная в OS X v10.5.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_5_2
  
  NSAppKitVersionNumber10_5_2
  
  Платформа AppKit, включенная в OS X v10.5.2.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_5_3
  
  NSAppKitVersionNumber10_5_3
  
  Платформа AppKit, включенная в OS X v10.5.3.
  
  Доступный в OS X v10.6 и позже.
- NSAppKitVersionNumber10_6
  
  NSAppKitVersionNumber10_6
  
  Платформа AppKit, включенная в OS X v10.6.
  
  Доступный в OS X v10.7 и позже.
- NSAppKitVersionNumber10_7
  
  NSAppKitVersionNumber10_7
  
  Платформа AppKit, включенная в OS X v10.7.
  
  Доступный в OS X v10.7 и позже.
- NSAppKitVersionNumber10_7_2
  
  NSAppKitVersionNumber10_7_2
  
  Платформа AppKit, включенная в OS X v10.7.2.
  
  Доступный в OS X v10.7 и позже.
- NSAppKitVersionNumber10_7_3
  
  NSAppKitVersionNumber10_7_3
  
  Платформа AppKit, включенная в OS X v10.7.3.
  
  Доступный в OS X v10.9 и позже.
- NSAppKitVersionNumber10_7_4
  
  NSAppKitVersionNumber10_7_4
  
  Платформа AppKit, включенная в OS X v10.7.4.
  
  Доступный в OS X v10.9 и позже.
- NSAppKitVersionNumber10_8
  
  NSAppKitVersionNumber10_8
  
  Платформа AppKit, включенная в OS X v10.8.
  
  Доступный в OS X v10.9 и позже.

Уведомления

NSApplicationDidBecomeActiveNotification NSApplicationDidBecomeActiveNotification

Отправленный сразу после того, как приложение становится активным.
Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный, когда изменяется конфигурация дисплеев, присоединенных к компьютеру.
Когда пользователь изменяет настройки в панели управления Дисплеев, изменение конфигурации может быть сделано или программно или. Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в конце finishLaunching метод, чтобы указать, что приложение завершило запуск и готово работать.
Объект уведомления sharedApplication. Посмотрите Пользовательские Информационные Ключи NSApplicationDidFinishLaunching для возможного userInfo ключи и значения.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в конце hide: метод, чтобы указать, что теперь скрыто приложение.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный сразу после того, как приложение бросает свое активное состояние к другому приложению.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в конце unhideWithoutActivation метод, чтобы указать, что приложение теперь видимо.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в конце updateWindows метод, чтобы указать, что приложение закончило обновлять свои окна.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный сразу, прежде чем приложение становится активным.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в начале finishLaunching метод, чтобы указать, что приложение завершило свой процесс инициализации и собирается закончить запускаться.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в начале hide: метод, чтобы указать, что приложение собирается быть скрытым.
Объект уведомления NSApp. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный сразу, прежде чем приложение бросает свое активное состояние к другому приложению.
Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный terminate: метод, чтобы указать, что завершится приложение.
Отправленный, только если метод делегата applicationShouldTerminate: возвраты YEStrue. Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в начале unhideWithoutActivation метод, чтобы указать, что приложение собирается стать видимым.
Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный в начале updateWindows метод, чтобы указать, что приложение собирается обновить свои окна.
Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отправленный, когда приложение закончено, восстановив окна.
Когда приложение закончено, восстановив окна, т.е. когда все обработчики завершения от, уведомление отправляется restoreWindowWithIdentifier:state:completionHandler: были вызваны. Это всегда отправляется после NSApplicationWillFinishLaunchingNotification, но может быть отправлен прежде или после NSApplicationDidFinishLaunchingNotificationВ зависимости от того, копируют ли клиенты обработчики завершения и вызывают их позже. Если не было никаких окон для восстановления, то это уведомление все еще отправляется в соответствующей точке в запуске приложения (между NSApplicationWillFinishLaunchingNotification и NSApplicationDidFinishLaunchingNotification).
Объект уведомления sharedApplication. Это уведомление не содержит a userInfo словарь.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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