Ссылка на протокол NSApplicationDelegate

Запуск приложений


    
    applicationWillFinishLaunching (_:)
    - applicationWillFinishLaunching:

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

Объявление

Swift

optional func applicationWillFinishLaunching(_ aNotification: NSNotification)

Objective C

- (void)applicationWillFinishLaunching:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillFinishLaunchingNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidFinishLaunching:
– applicationWillBecomeActive:
finishLaunching (NSApplication)


    
    applicationDidFinishLaunching (_:)
    - applicationDidFinishLaunching:

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

Объявление

Swift

optional func applicationDidFinishLaunching(_ aNotification: NSNotification)

Objective C

- (void)applicationDidFinishLaunching:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidFinishLaunchingNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

finishLaunching (NSApplication)
– applicationWillFinishLaunching:
– applicationDidBecomeActive:
– application:openFile:

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

applicationShouldTerminate (_:) - applicationShouldTerminate:

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

Объявление

Swift

optional func applicationShouldTerminate(_ sender: NSApplication) -> NSApplicationTerminateReply

Objective C

- (NSApplicationTerminateReply)applicationShouldTerminate:(NSApplication *)sender

Параметры

sender

Объект приложения, собирающийся быть завершенным.

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

Одно из значений, определенных в NSApplicationTerminateReply константы, указывающие, должно ли завершиться приложение. По причинам совместимости, возвращаемому значению NOfalse эквивалентно NSTerminateCancel, и возвращаемое значение YEStrue эквивалентно NSTerminateNow.

Обсуждение

Этот метод вызывают после того, как пункт меню Quit приложения был выбран, или после terminate: метод вызвали. Обычно необходимо возвратиться NSTerminateNow чтобы позволить завершению завершаться, но можно отменить процесс завершения или задержать его несколько по мере необходимости. Например, Вы могли бы задержать завершение, чтобы закончить обрабатывать некоторые критические данные, но затем завершать приложение, как только Вы сделаны путем вызова replyToApplicationShouldTerminate: метод.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

См. также

terminate: (NSApplication)
– applicationShouldTerminateAfterLastWindowClosed:
– applicationWillTerminate:
applicationShouldTerminateAfterLastWindowClosed (_:) - applicationShouldTerminateAfterLastWindowClosed:

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

Объявление

Swift

optional func applicationShouldTerminateAfterLastWindowClosed(_ theApplication: NSApplication) -> Bool

Objective C

- (BOOL)applicationShouldTerminateAfterLastWindowClosed:(NSApplication *)theApplication

Параметры

theApplication

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

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

NOfalse когда его последнее окно закрывается, если не должно быть завершено приложение; иначе, YEStrue завершать приложение.

Обсуждение

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

Если возвращается Ваша реализация NOfalse, управляйте возвращается к основному циклу событий, и приложение не завершается. Если Вы возвращаетесь YEStrue, Ваш делегат applicationShouldTerminate: метод впоследствии вызывается, чтобы подтвердить, что должно быть завершено приложение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

См. также

оконечный:
– applicationShouldTerminate:


    
    applicationWillTerminate (_:)
    - applicationWillTerminate:

Отправленный уведомлением по умолчанию сразу центрируются, прежде чем приложение завершается.

Объявление

Swift

optional func applicationWillTerminate(_ aNotification: NSNotification)

Objective C

- (void)applicationWillTerminate:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillTerminateNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationShouldTerminate:
terminate: (NSApplication)

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


    
    applicationWillBecomeActive (_:)
    - applicationWillBecomeActive:

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

Объявление

Swift

optional func applicationWillBecomeActive(_ aNotification: NSNotification)

Objective C

- (void)applicationWillBecomeActive:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillBecomeActiveNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidBecomeActive:
– applicationWillFinishLaunching:
– applicationWillResignActive:


    
    applicationDidBecomeActive (_:)
    - applicationDidBecomeActive:

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

Объявление

Swift

optional func applicationDidBecomeActive(_ aNotification: NSNotification)

Objective C

- (void)applicationDidBecomeActive:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidBecomeActiveNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidFinishLaunching:
– applicationDidResignActive:
– applicationWillBecomeActive:


    
    applicationWillResignActive (_:)
    - applicationWillResignActive:

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

Объявление

Swift

optional func applicationWillResignActive(_ aNotification: NSNotification)

Objective C

- (void)applicationWillResignActive:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillResignActiveNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationWillBecomeActive:
– applicationDidResignActive:


    
    applicationDidResignActive (_:)
    - applicationDidResignActive:

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

Объявление

Swift

optional func applicationDidResignActive(_ aNotification: NSNotification)

Objective C

- (void)applicationDidResignActive:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidResignActiveNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidBecomeActive:
– applicationWillResignActive:

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


    
    applicationWillHide (_:)
    - applicationWillHide:

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

Объявление

Swift

optional func applicationWillHide(_ aNotification: NSNotification)

Objective C

- (void)applicationWillHide:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillHideNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidHide:
hide: (NSApplication)


    
    applicationDidHide (_:)
    - applicationDidHide:

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

Объявление

Swift

optional func applicationDidHide(_ aNotification: NSNotification)

Objective C

- (void)applicationDidHide:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidHideNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationWillHide:
– applicationDidHide:
unhide: (NSApplication)


    
    applicationWillUnhide (_:)
    - applicationWillUnhide:

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

Объявление

Swift

optional func applicationWillUnhide(_ aNotification: NSNotification)

Objective C

- (void)applicationWillUnhide:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillUnhideNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

unhide: (NSApplication)
– applicationDidUnhide:
– applicationWillHide:


    
    applicationDidUnhide (_:)
    - applicationDidUnhide:

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

Объявление

Swift

optional func applicationDidUnhide(_ aNotification: NSNotification)

Objective C

- (void)applicationDidUnhide:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidUnhideNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidHide:
– applicationWillUnhide:
unhide: (NSApplication)

Управление Windows


    
    applicationWillUpdate (_:)
    - applicationWillUpdate:

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

Объявление

Swift

optional func applicationWillUpdate(_ aNotification: NSNotification)

Objective C

- (void)applicationWillUpdate:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationWillUpdateNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationDidUpdate:
updateWindows (NSApplication)


    
    applicationDidUpdate (_:)
    - applicationDidUpdate:

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

Объявление

Swift

optional func applicationDidUpdate(_ aNotification: NSNotification)

Objective C

- (void)applicationDidUpdate:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidUpdateNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– applicationWillUpdate:
updateWindows (NSApplication)


    
    applicationShouldHandleReopen (_: hasVisibleWindows:)
    - applicationShouldHandleReopen:hasVisibleWindows:

Отправленный приложением делегату до поведения по умолчанию вновь открыться (rapp) AppleEvents.

Объявление

Swift

optional func applicationShouldHandleReopen(_ theApplication: NSApplication, hasVisibleWindows flag: Bool) -> Bool

Objective C

- (BOOL)applicationShouldHandleReopen:(NSApplication *)theApplication hasVisibleWindows:(BOOL)flag

Параметры

`theApplication`	Объект приложения.
`flag`	Указывает ли `NSApplication` объект нашел любые видимые окна в Вашем приложении. Можно использовать это значение в качестве индикации относительно того, сделало ли бы приложение что-нибудь, если Вы возвращаетесь `YEStrue`.

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

YEStrue если Вы хотите, чтобы приложение выполнило свои нормальные задачи или NOfalse если Вы хотите, чтобы приложение ничего не сделало.

Обсуждение

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

По умолчанию Набор Приложения обработает это событие путем проверки, существует ли кто-либо видимый NSWindow (нет NSPanel) объекты, и, если нет ни одного, это проходит через стандартное создание документа без названия (то же, как это делает если theApplication запускается без любого документа для открытия). Для большинства основанных на документе приложений будет создаваться документ без названия.

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

Миниатюризированные окна, окна в Прикреплении, считают видимыми этот метод и причина flag возвратиться YEStrue, несмотря на то, что возвращаются миниатюризированные окна NOfalse когда отправлено isVisible сообщение.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

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

applicationDockMenu (_:) - applicationDockMenu:

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

Объявление

Swift

optional func applicationDockMenu(_ sender: NSApplication) -> NSMenu?

Objective C

- (NSMenu *)applicationDockMenu:(NSApplication *)sender

Параметры

sender

Объект приложения связался с делегатом.

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

Меню для отображения в прикреплении.

Обсуждение

Можно также соединить меню в Интерфейсном Разработчике к dockMenu выход. Третий путь к Вашему приложению для указания меню прикрепления состоит в том, чтобы обеспечить NSMenu в пере.

Если этот метод возвращает меню, это меню имеет приоритет по dockMenu в пере.

Цель и действие для каждого пункта меню передаются прикреплению. На выборе пункта меню прикрепление передает Ваше приложение, которое должно вызвать [NSApp sendAction:selector to:target from:nil].

Указать NSMenu в пере Вы добавляете имя пера к info.plist, использование ключа AppleDockMenu. Имя пера указано без расширения. Вы тогда создаете соединение из объекта владельца файла (который по умолчанию является NSApplication) к меню. Подключите меню с dockMenu выход NSApplication. Меню находится в своем собственном файле пера, таким образом, оно может быть загружено лениво когда dockMenu требуется, а не во время запуска.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.1 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

Отображение ошибок


    
    приложение (_: willPresentError:)
    - application:willPresentError:

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

Объявление

Swift

optional func application(_ application: NSApplication, willPresentError error: NSError) -> NSError

Objective C

- (NSError *)application:(NSApplication *)application willPresentError:(NSError *)error

Параметры

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

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

Ошибочный объект вывести на экран.

Обсуждение

Можно реализовать этот метод делегата настроить представление любой ошибки, представленной приложением, пока никакой код в приложении не переопределяет ни один из NSResponder методы presentError:modalForWindow:delegate:didPresentSelector:contextInfo: или presentError: в пути, препятствующем ошибкам быть переданным цепочка респондента к объекту приложения.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

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


    
    applicationDidChangeScreenParameters (_:)
    - applicationDidChangeScreenParameters:

Отправленный уведомлением по умолчанию центрируются, когда конфигурация дисплеев, присоединенных к компьютеру, изменяется (или программно или когда пользователь изменяет настройки в панели управления Дисплеев).

Объявление

Swift

optional func applicationDidChangeScreenParameters(_ aNotification: NSNotification)

Objective C

- (void)applicationDidChangeScreenParameters:(NSNotification *)aNotification

Параметры


      aNotification

Уведомление называют NSApplicationDidChangeScreenParametersNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

Вводные файлы


    
    приложение (_: openFile:)
    - application:openFile:

Говорит делегату открывать единственный файл.

Объявление

Swift

optional func application(_ theApplication: NSApplication, openFile filename: String) -> Bool

Objective C

- (BOOL)application:(NSApplication *)theApplication openFile:(NSString *)filename

Параметры

`theApplication`	Объект приложения связался с делегатом.
`filename`	Имя файла для открытия.

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

YEStrue если файл был успешно открыт или NOfalse если это не было.

Обсуждение

Отправленный непосредственно theApplication делегату. Метод должен открыть файл filename, возврат YEStrue если файл успешно открыт, и NOfalse иначе. Если пользователь запустил приложение путем двойного щелчка по файлу, делегат получает application:openFile: сообщение перед получением applicationDidFinishLaunching:. (applicationWillFinishLaunching: отправляется прежде application:openFile:.)

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– application:openFileWithoutUI:
– application:openTempFile:
– applicationOpenUntitledFile:


    
    приложение (_: openFileWithoutUI:)
    - application:openFileWithoutUI:

Говорит делегату открывать файл программно.

Объявление

Swift

optional func application(_ sender: AnyObject, openFileWithoutUI filename: String) -> Bool

Objective C

- (BOOL)application:(id)sender openFileWithoutUI:(NSString *)filename

Параметры

`sender`	Объект, отправивший команду.
`filename`	Имя файла для открытия.

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

YEStrue если файл был успешно открыт или NOfalse если это не было.

Обсуждение

Отправленный непосредственно sender делегату, чтобы запросить, что файл filename будьте открыты как соединенный файл. Метод должен открыть файл, не поднимая пользовательский интерфейс его приложения — т.е. работа с файлом находится под программируемым контролем sender, вместо под управлением клавиатурой пользователя.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– application:openFile:
– application:openTempFile:
– applicationOpenUntitledFile:
– application:printFile:


    
    приложение (_: openTempFile:)
    - application:openTempFile:

Говорит делегату открывать временный файл.

Объявление

Swift

optional func application(_ theApplication: NSApplication, openTempFile filename: String) -> Bool

Objective C

- (BOOL)application:(NSApplication *)theApplication openTempFile:(NSString *)filename

Параметры

`theApplication`	Объект приложения связался с делегатом.
`filename`	Имя временного файла для открытия.

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

YEStrue если файл был успешно открыт или NOfalse если это не было.

Обсуждение

Отправленный непосредственно theApplication делегату. Метод должен попытаться открыть файл filename, возврат YEStrue если файл успешно открыт, и NOfalse иначе.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– application:openFile:
– application:openFileWithoutUI:
– applicationOpenUntitledFile:


    
    приложение (_: openFiles:)
    - application:openFiles:

Говорит делегату открывать многократные файлы.

Объявление

Swift

optional func application(_ sender: NSApplication, openFiles filenames: [AnyObject])

Objective C

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

Параметры

`sender`	Объект приложения связался с делегатом.
`filenames`	Массив `NSString` объекты, содержащие имена файлов для открытия..

Обсуждение

Идентичный application:openFile: за исключением того, что получатель открывает многократные файлы, соответствующие именам файлов в filenames массив. Делегаты должны вызвать replyToOpenOrPrint: метод на успешность или неуспешность, или когда пользователь отменяет работу.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

applicationOpenUntitledFile (_:) - applicationOpenUntitledFile:

Говорит делегату открывать неназванный файл.

Объявление

Swift

optional func applicationOpenUntitledFile(_ theApplication: NSApplication) -> Bool

Objective C

- (BOOL)applicationOpenUntitledFile:(NSApplication *)theApplication

Параметры

theApplication

Объект приложения связался с делегатом.

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

YEStrue если файл был успешно открыт или NOfalse если это не было.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

См. также

– application:openFile:
– application:openFileWithoutUI:
– application:openTempFile:
applicationShouldOpenUntitledFile (_:) - applicationShouldOpenUntitledFile:

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

Объявление

Swift

optional func applicationShouldOpenUntitledFile(_ sender: NSApplication) -> Bool

Objective C

- (BOOL)applicationShouldOpenUntitledFile:(NSApplication *)sender

Параметры

sender

Объект приложения связался с делегатом.

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

YEStrue если приложение должно открыть новый неназванный файл или NOfalse если это не должно.

Обсуждение

Используйте этот метод, чтобы решить, должно ли приложение открыть новый, неназванный файл. Обратите внимание на то, что applicationOpenUntitledFile: если этот метод возвращается, вызывается YEStrue.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

Печать


    
    приложение (_: printFile:)
    - application:printFile:

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

Объявление

Swift

optional func application(_ theApplication: NSApplication, printFile filename: String) -> Bool

Objective C

- (BOOL)application:(NSApplication *)theApplication printFile:(NSString *)filename

Параметры

`theApplication`	Объект приложения, обрабатывающий печать.
`filename`	Имя файла для печати.

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

YEStrue если файл был успешно распечатан или NOfalse если это не было.

Обсуждение

Это сообщение отправляется непосредственно theApplication делегату. Приложение завершается (использование terminate: метод) после этого метода возвраты.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

См. также

– application:openFileWithoutUI:


    
    приложение (_: printFiles:withSettings:showPrintPanels:)
    - application:printFiles:withSettings:showPrintPanels:

Распечатывает группу файлов.

Объявление

Swift

optional func application(_ application: NSApplication, printFiles fileNames: [AnyObject], withSettings printSettings: [NSObject : AnyObject], showPrintPanels showPrintPanels: Bool) -> NSApplicationPrintReply

Objective C

- (NSApplicationPrintReply)application:(NSApplication *)application printFiles:(NSArray *)fileNames withSettings:(NSDictionary *)printSettings showPrintPanels:(BOOL)showPrintPanels

Параметры

`application`	Объект приложения, обрабатывающий печать.
`fileNames`	Массив `NSString` объекты, каждый из которых содержит имя файла для печати.
`printSettings`	Словарь, содержащий `NSPrintInfo`- совместимые атрибуты задания печати.
`showPrintPanels`	Булевская переменная, указывающая, должна ли панель печати быть выведена на экран для каждого распечатанного файла. Даже если это значение будет, индикаторы хода выполнения печати будут представлены `NOfalse`.

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

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

Обсуждение

Возвратиться NSPrintingReplyLater например, если печать вызовет представление листа, если результат печати не может быть сразу возвращен. Если возвращается Ваш метод NSPrintingReplyLater это должно всегда вызывать NSApplication метод replyToOpenOrPrint:] когда вся работа печати была завершена, успешно или нет.

Этот метод делегата замены application:printFiles:, который теперь осуждается. Если Ваш делегат приложения только реализует устаревший метод, он все еще вызывается, и NSApplication использует частную функциональность, чтобы принять меры, чтобы настройки печати вступили в силу.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Доступный как часть неофициального протокола до OS X v10.6.

Обработка уведомлений нажатия


    
    приложение (_: didRegisterForRemoteNotificationsWithDeviceToken:)
    - application:didRegisterForRemoteNotificationsWithDeviceToken:

Отправленный делегату, когда Apple Push Services успешно завершает процесс регистрации.

Объявление

Swift

optional func application(_ application: NSApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: NSData)

Objective C

- (void)application:(NSApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken

Параметры


      application

Приложение, инициировавшее процесс регистрации удаленного уведомления.


      deviceToken

Маркер, идентифицирующий устройство для Apple Push Notification Service (APNS). Маркер является непрозрачным типом данных, потому что это - форма, которую провайдер должен представить серверам APNS, когда это отправляет уведомление устройству. Серверы APNS требуют двоичного формата по причинам производительности.

Размер маркера устройства составляет 32 байта.

Обсуждение

Делегат получает это сообщение после registerForRemoteNotificationTypes:метод NSApplication вызывается и в процессе регистрации нет никакой ошибки. После получения маркера устройства приложение должно соединиться с его провайдером и дать маркер ему. APNS только продвигает уведомления компьютеру приложения, сопровождающиеся с этим маркером.

Для получения дополнительной информации о том, как реализовать уведомления нажатия в Вашем приложении, см. Локальное и Удаленное Руководство по программированию Уведомления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– application:didFailToRegisterForRemoteNotificationsWithError:
– application:didReceiveRemoteNotification:


    
    приложение (_: didFailToRegisterForRemoteNotificationsWithError:)
    - application:didFailToRegisterForRemoteNotificationsWithError:

Отправленный делегату, когда Служба Нажатия Apple не может успешно завершить процесс регистрации.

Объявление

Swift

optional func application(_ application: NSApplication, didFailToRegisterForRemoteNotificationsWithError error: NSError)

Objective C

- (void)application:(NSApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error

Параметры

`application`	Приложение, инициировавшее процесс регистрации удаленного уведомления.
`error`	Объект NSError, инкапсулирующий информацию, почему не успешно выполнялась регистрация. Приложение может вывести на экран эту информацию пользователю.

Обсуждение

Делегат получает это сообщение после registerForRemoteNotificationTypes: метод NSApplication вызывается и в процессе регистрации существует ошибка.

Для получения дополнительной информации о том, как реализовать уведомления нажатия в Вашем приложении, см. Локальное и Удаленное Руководство по программированию Уведомления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    приложение (_: didReceiveRemoteNotification:)
    - application:didReceiveRemoteNotification:

Отправленный делегату, когда запущенное приложение получает удаленное уведомление.

Объявление

Swift

optional func application(_ application: NSApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject])

Objective C

- (void)application:(NSApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo

Параметры


      application

Приложение, получившее удаленное уведомление.


      userInfo

Словарь, содержащий информацию, связанную с удаленным уведомлением, в частности число значка для значка приложения, идентификатора уведомления, и возможно пользовательских данных. Провайдер порождает его как JSON-определенный словарь, который AppKit преобразовывает в NSDictionary объект; словарь может содержать только объекты списка свойств плюс NSNull.

Обсуждение

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

userInfo словарь содержит другой словарь, что можно получить использование aps ключ. Можно получить доступ к содержанию aps словарь с помощью следующих ключей:

badge— Число, указывающее количество элементов данных для получения из провайдера. Это число должно быть выведено на экран на значке приложения. Отсутствие a badge свойство указывает, что должно быть удалено любое число в настоящее время применение идентификационных знаков значок.

Применение идентификационных знаков значка является единственным типом уведомления, поддерживаемым для незапущенных приложений.
alert— Значение может или быть строкой для предупредительного сообщения или словаря с двумя ключами: body и show-view. Значение прежнего является предупредительным сообщением, и последний является булевской переменной (false или true). Можно проигнорировать второй ключ.
sound— Имя звукового файла в комплекте приложений для игры как предупредительный звук. Если «значение по умолчанию» указано, звук по умолчанию должен играться.

userInfo словарю мог также определить пользовательские данные провайдер согласно схеме JSON. Свойства для пользовательских данных должны быть указаны на том же уровне как aps словарь. Однако пользовательски определенные свойства не должны использоваться для транспорта данных большого объема, потому что существует строгий предел размера на уведомление (256 байтов), и поставка не гарантируется.

Если Вы реализуете applicationDidFinishLaunching: и уведомление нажатия для приложения недавно поступило, этот метод не вызывается для того уведомления нажатия. В этом случае можно получить доступ к данным JSON в userInfo словарь переданного - в NSNotification объект.

Для получения дополнительной информации о том, как реализовать уведомления нажатия в Вашем приложении, см. Локальное и Удаленное Руководство по программированию Уведомления.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Приложение восстановимое состояние

приложение (_: didDecodeRestorableState:) - application:didDecodeRestorableState:

Говорит делегату, что приложение извлекло свое восстановимое состояние из данного archiver.

Объявление

Swift

optional func application(_ app: NSApplication, didDecodeRestorableState coder: NSCoder)

Objective C

- (void)application:(NSApplication *)app didDecodeRestorableState:(NSCoder *)coder

Параметры

app

Приложение.

coder

Кодер, извлекающий архив.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.
приложение (_: willEncodeRestorableState:) - application:willEncodeRestorableState:

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

Объявление

Swift

optional func application(_ app: NSApplication, willEncodeRestorableState coder: NSCoder)

Objective C

- (void)application:(NSApplication *)app willEncodeRestorableState:(NSCoder *)coder

Параметры

app

Приложение.

coder

Кодер, извлекающий архив.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Продолжение пользовательских действий


    
    приложение (_: willContinueUserActivityWithType:)
    - application:willContinueUserActivityWithType:

Говорит делегату, что пользователь хочет продолжать действие Ваше приложение.

Объявление

Swift

optional func application(_ application: NSApplication, willContinueUserActivityWithType userActivityType: String) -> Bool

Objective C

- (BOOL)application:(NSApplication *)application willContinueUserActivityWithType:(NSString *)userActivityType

Параметры

`application`	Приложение, продолжающее пользовательское действие.
`userActivityType`	Тип действия, которое будет продолжаться.

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

YEStrue если Вы уведомляете пользователя, что Ваше приложение собирается продолжать действие или NOfalse если Вы хотите, чтобы AppKit уведомил пользователя.

Обсуждение

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

Этот метод вызывают на основном потоке, как только пользователь указывает, что они хотят продолжать действие Ваше приложение. NSUserActivity объект может не быть доступным немедленно, так используйте это в качестве возможности показать пользователю, что действие будет продолжаться вскоре и возвратится YEStrue. Если Вы оставляете этот метод нереализованным или возврат NOfalse, AppKit выводит на экран индикацию по умолчанию.

Для каждого вызова этого метода делегат приложения, как гарантируют, получит точно один вызов application:continueUserActivity:restorationHandler: на успехе, или application:didFailToContinueUserActivityWithType:error: если встретились с ошибкой.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    приложение (_: continueUserActivity:restorationHandler:)
    - application:continueUserActivity:restorationHandler:

Говорит делегату, что данные для продолжения действия доступны.

Объявление

Swift

optional func application(_ application: NSApplication, continueUserActivity userActivity: NSUserActivity, restorationHandler restorationHandler: ([AnyObject]!) -> Void) -> Bool

Objective C

- (BOOL)application:(NSApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray *restorableObjects))restorationHandler

Параметры


      application

Приложение, продолжающее пользовательское действие.


      userActivity

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


      restorationHandler

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


      restorableObjects

Массив NSResponder или NSDocument объекты, которые Вы создали или выбрали для выполнения работы. Системные вызовы restoreUserActivityState: метод каждого объекта в массиве для выполнения работы.

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

YEStrue если этот метод обработал продолжение действия; NOfalse сделать, чтобы AppKit попытался продолжать действие.

Обсуждение

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

Если этот пользовательский объект действия создавался автоматически при наличии NSUbiquitousDocumentUserActivityType в a CFBundleDocumentTypes запись, AppKit может автоматически восстановить NSUserActivity на OS X, если возвращается этот метод NOfalse, или если это не реализовано. Это делает это путем создания документа надлежащего типа с помощью URL, сохраненного в userInfo словарь под NSUserActivityDocumentURLKey. Системные вызовы NSDocument метод restoreUserActivityState: на документе.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    приложение (_: didFailToContinueUserActivityWithType:error:)
    - application:didFailToContinueUserActivityWithType:error:

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

Объявление

Swift

optional func application(_ application: NSApplication, didFailToContinueUserActivityWithType userActivityType: String, error error: NSError)

Objective C

- (void)application:(NSApplication *)application didFailToContinueUserActivityWithType:(NSString *)userActivityType error:(NSError *)error

Параметры

`application`	Приложение, попытавшееся продолжать действие.
`userActivityType`	Опробованный тип действия.
`error`	Ошибочный объект указание причины отказа.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    приложение (_: didUpdateUserActivity:)
    - application:didUpdateUserActivity:

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

Объявление

Swift

optional func application(_ application: NSApplication, didUpdateUserActivity userActivity: NSUserActivity)

Objective C

- (void)application:(NSApplication *)application didUpdateUserActivity:(NSUserActivity *)userActivity

Параметры

`application`	Объект общего приложения.
`userActivity`	Обновленный пользовательский объект действия.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Состояние поглощения газов


    
    applicationDidChangeOcclusionState (_:)
    - applicationDidChangeOcclusionState:

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

Объявление

Swift

optional func applicationDidChangeOcclusionState(_ notification: NSNotification)

Objective C

- (void)applicationDidChangeOcclusionState:(NSNotification *)notification

Параметры


      notification

Уведомление называют NSApplicationDidChangeOcclusionStateNotification. Вызов object метод этого уведомления возвращается NSApplication возразите себе.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

`app`	Приложение.
`coder`	Кодер, извлекающий архив.