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

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

Разработчик

Ссылка платформы AppKit ссылка на протокол NSOpenSavePanelDelegate

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

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

NSOpenSavePanelDelegate

NSOpenSavePanelDelegate протокол определяет методы что делегат NSOpenPanel или NSSavePanel должен реализовать.

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


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

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


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


Swift

import AppKit

Objective C

@import AppKit;

Доступность


Доступный в OS X v10.6 и позже.
  • Для NSOpenPanel делегаты, спрашивает делегат, должен ли указанный URL быть включен в панели. Этот метод не требуется NSSavePanel делегаты; весь URLs всегда отключается.

    Объявление

    Swift

    optional func panel(_ sender: AnyObject, shouldEnableURL url: NSURL) -> Bool

    Objective C

    - (BOOL)panel:(id)sender shouldEnableURL:(NSURL *)url

    Параметры

    sender

    Панель, спрашивающая, должен ли быть включен URL.

    url

    URL, который будет проверен.

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

    YEStrue позволить URL быть включенным в панели; иначе, NOfalse.

    Обсуждение

    Реализации этого метода должны быть быстрыми, чтобы избежать останавливать пользовательский интерфейс. Использовать panel:validateURL:error: вместо этого, если обработка займет много времени.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Для NSSavePanel когда пользователь выбирает кнопку Save, делегаты, спрашивает делегат к файлу проверку URL. Для NSOpenPanel делегаты, спрашивает делегат к файлу проверку URL один раз для каждого выбранного имени файла (или каталог), когда пользователь выбирает кнопку Open.

    Объявление

    Swift

    optional func panel(_ sender: AnyObject, validateURL url: NSURL, error outError: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)panel:(id)sender validateURL:(NSURL *)url error:(NSError **)outError

    Параметры

    sender

    Панель, запрашивающая проверку URL.

    url

    URL, который будет проверен.

    outError

    Если ошибка произошла во время проверки, произошедшая ошибка.

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

    YEStrue если URL является приемлемый URL, чтобы сохранить к или открыться; иначе, NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Сообщает делегату, что пользователь изменил выбранный каталог на каталог, расположенный в указанном URL. URL Может быть nil если текущий URL не может быть представлен NSURL объект.

    Объявление

    Swift

    optional func panel(_ sender: AnyObject!, didChangeToDirectoryURL url: NSURL?)

    Objective C

    - (void)panel:(id)sender didChangeToDirectoryURL:(NSURL *)url

    Параметры

    sender

    Панель, каталог которой изменился.

    url

    URL нового каталога, или nil если это не может быть представлено NSURL объект.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • Говорит делегату, что пользователь подтвердил выбор имени файла путем щелчка по Save в панели Save.

    Объявление

    Swift

    optional func panel(_ sender: AnyObject, userEnteredFilename filename: String, confirmed okFlag: Bool) -> String?

    Objective C

    - (NSString *)panel:(id)sender userEnteredFilename:(NSString *)filename confirmed:(BOOL)okFlag

    Параметры

    sender

    Панель, сообщая о подтверждении пользователем выбора имени файла.

    filename

    Выбор имени файла пользователя.

    okFlag

    Если YEStrue, пользователь нажал кнопку Save; если NOfalse, пользователь не сделал.

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

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

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

    Объявление

    Swift

    optional func panel(_ sender: AnyObject, willExpand expanding: Bool)

    Objective C

    - (void)panel:(id)sender willExpand:(BOOL)expanding

    Параметры

    sender

    Панель, собирающаяся расшириться или разрушиться.

    expanding

    YEStrue указывает, что расширяется панель; NOfalse указывает, что это разрушается.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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

  • Говорит делегату, что пользователь изменил выбор в указанной панели Save.

    Объявление

    Swift

    optional func panelSelectionDidChange(_ sender: AnyObject?)

    Objective C

    - (void)panelSelectionDidChange:(id)sender

    Параметры

    sender

    Панель, выбор которой изменился.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

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