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

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

Разработчик

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

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

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

NSSavePanel

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

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

NSSavePanel объект может иметь делегата. Методы это делегаты NSSavePanel может реализовать указаны NSOpenSavePanelDelegate протокол.

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Создание панелей
  • savePanel + savePanel

    Возвращает панель Save, инициализированную со значениями по умолчанию.

    Объявление

    Objective C

    + (NSSavePanel *)savePanel

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

    Инициализированная панель Save.

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

    Objective C

    @import AppKit;

    Доступность

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

Конфигурирование панелей
  • accessoryView accessoryView Свойство

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

    Объявление

    Swift

    var accessoryView: NSView?

    Objective C

    @property(strong) NSView *accessoryView

    Обсуждение

    Можно настроить панель путем добавления пользовательского представления. Добавляющийся пользовательский объект появляется чуть выше OK и Кнопок отмены у основания панели. NSSavePanel объект автоматически изменяет размеры себя для размещения accessoryView. Можно использовать это свойство для изменения вспомогательного представление по мере необходимости. Если accessoryView nil, панель Save удаляет ток, вспомогательный представление.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • заголовок заголовок Свойство

    Заголовок панели.

    Объявление

    Swift

    var title: String?

    Objective C

    @property(copy) NSString *title

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • подсказка подсказка Свойство

    Подсказка кнопки по умолчанию.

    Объявление

    Swift

    var prompt: String?

    Objective C

    @property(copy) NSString *prompt

    Обсуждение

    Подсказка появляется на всех NSSavePanel объекты (или все NSOpenPanel объекты, если это свойство идет NSOpenPanel экземпляр) в Вашем приложении. По умолчанию текст в кнопке по умолчанию «Открыт» для панели Open, и «Сохраните» для панели Save.

    Это предназначается, что короткие слова или фразы, такой как «Открытые», «Сохраняют», «Набор», или «Выбирают», использоваться на кнопке. Кнопка не изменена для размещения долгих подсказок.

    Так как этот метод ранее влиял на поле заголовка, любое двоеточие в конце prompt удален.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • nameFieldLabel nameFieldLabel Свойство

    Строка выведена на экран перед текстовым полем имени файла.

    Объявление

    Swift

    var nameFieldLabel: String?

    Objective C

    @property(copy) NSString *nameFieldLabel

    Обсуждение

    Значение по умолчанию этого свойства, “Сохраняют Как”:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • сообщение сообщение Свойство

    Текст сообщения, выведенный на экран в панели сохранения.

    Объявление

    Swift

    var message: String?

    Objective C

    @property(copy) NSString *message

    Обсуждение

    Эта подсказка появляется на всех NSSavePanel объекты (или все NSOpenPanel объекты, если это свойство идет NSOpenPanel экземпляр) в Вашем приложении. Текст сообщения по умолчанию является пустой строкой.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • canCreateDirectories canCreateDirectories Свойство

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

    Объявление

    Swift

    var canCreateDirectories: Bool

    Objective C

    @property BOOL canCreateDirectories

    Обсуждение

    Когда значение этого свойства YEStrue, панель позволяет пользователю создавать каталоги; если NOfalse, панель не делает.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • showsHiddenFiles showsHiddenFiles Свойство

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

    Объявление

    Swift

    var showsHiddenFiles: Bool

    Objective C

    @property BOOL showsHiddenFiles

    Обсуждение

    Когда значение этого свойства YEStrue, панель выводит на экран скрытые файлы; если NOfalse, это не делает. Значение по умолчанию NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • делегат делегат Свойство

    Делегат панели.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSOpenSavePanelDelegate?

    Objective C

    @property(assign) id< NSOpenSavePanelDelegate > delegate

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • showsTagField showsTagField Свойство

    Булево значение, указывающее, выводит ли панель на экран поле Tags.

    Объявление

    Swift

    var showsTagField: Bool

    Objective C

    @property BOOL showsTagField

    Обсуждение

    Когда значение этого свойства YEStrue, панель выводит на экран поле Tags; если NOfalse, панель не выводит на экран поле Tags. Значение по умолчанию YEStrue. (Обратите внимание на то, что поле Tags является надлежащим только в панели Save.)

    Если Вы устанавливаете это свойство в YEStrue, Вы ответственны за установку имен тега на получающемся файле после того, как сохранение будет завершено. Если Вы не установите это свойство, то OS X автоматически покажет поле метки и попытается применить теги к файлу. (Установить наклеивает файлы, используйте NSURLTagNamesKey, описанный в Common File System Resource Keys.)

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • tagNames tagNames Свойство

    Имена тега для установки на файле пользователя сохранили.

    Объявление

    Swift

    var tagNames: [AnyObject]?

    Objective C

    @property(copy) NSArray *tagNames

    Обсуждение

    Когда значение showsTagField YEStrue, используйте это свойство для обеспечения массива строк, представляющих inital набор имен тега для отображения в панели. Если Вы устанавливаете свойство в nil или пустой массив, никакие начальные имена тега не выведены на экран в панели. (Обратите внимание на то, что поле Tags является надлежащим только в панели Save.)

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Конфигурирование содержания панели
  • extensionHidden extensionHidden Свойство

    Булево значение, указывающее, видим ли скрывающий расширение флажок и проверен.

    Объявление

    Swift

    var extensionHidden: Bool

    Objective C

    @property(getter=isExtensionHidden) BOOL extensionHidden

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • requiredFileType - requiredFileType (OS X v10.6)

    Возвращает требуемый тип файла (если таковые имеются).

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

    Использовать allowedFileTypes вместо этого.

    Объявление

    Objective C

    - (NSString *)requiredFileType

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

    Требуемый тип файла (если таковые имеются).

    Обсуждение

    Файл, указанный в панели Save, сохранен с определяемым именем файла и этим типом файла как расширение. Примерами типов общего файла является «rtf», «размолвка» и «PS». Строки типа файла, кодирующие типы файлов HFS, не являются допустимыми значениями для этого атрибута. nil возвращаемое значение указывает, что пользователь может сохранить к любому файлу ASCII.

    Этот метод эквивалентен использованию allowedFileTypes и возврат первого элемента списка позволенных типов, или nil если нет ни одного.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    allowedFileTypes

  • setRequiredFileType: - setRequiredFileType: (OS X v10.6)

    Указывает тип файла (как расширение) или UTI.

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

    Использовать allowedFileTypes вместо этого.

    Объявление

    Objective C

    - (void)setRequiredFileType:(NSString *)type

    Параметры

    type

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

    Обсуждение

    Если type расширение, оно не должно включать период, начинающий расширение. Передача nil указать любой тип. Строки типа файла, кодирующие типы файлов HFS, не являются допустимыми значениями для этого атрибута. Необходимо вызвать этот метод каждый раз, когда панель Save используется для другого типа файла в приложении.

    Этот метод эквивалентен использованию allowedFileTypes с массивом, содержащим только type (если type ноль, и затем это эквивалентно установке свойства к nil).

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    allowedFileTypes

  • directoryURL directoryURL Свойство

    Каталог, показанный в панели как URL.

    Объявление

    Swift

    @NSCopying var directoryURL: NSURL?

    Objective C

    @property(copy) NSURL *directoryURL

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • setDirectory: - setDirectory: (OS X v10.6)

    Устанавливает текущий путь в браузере панели.

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

    Использовать directoryURL вместо этого.

    Объявление

    Objective C

    - (void)setDirectory:(NSString *)path

    Параметры

    path

    Строка для установки как текущий путь панели.

    Обсуждение

    path параметром должен быть абсолютный путь.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    directoryURL

  • canSelectHiddenExtension canSelectHiddenExtension Свойство

    Булево значение, указывающее, позволяет ли панель пользователю скрывать или показывать расширения файла.

    Объявление

    Swift

    var canSelectHiddenExtension: Bool

    Objective C

    @property BOOL canSelectHiddenExtension

    Обсуждение

    Когда значение этого свойства YEStrue, панель позволяет пользователю скрывать или показывать расширения; если NOfalse, это не делает. Значение по умолчанию NOfalse.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • allowedFileTypes allowedFileTypes Свойство

    Массив NSString объекты, указывающие позволенные типы файлов для панели.

    Объявление

    Swift

    var allowedFileTypes: [AnyObject]?

    Objective C

    @property(copy) NSArray *allowedFileTypes

    Обсуждение

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

    Если никакое расширение не дано пользователем, первым элементом в allowedFileTypes массив будет использоваться в качестве расширения для панели сохранения. Если пользователь указывает тип не в массиве, и allowsOtherFileTypes YEStrue, им подарят другое диалоговое окно, когда запрошено для сохранения.

    NSOpenPanel: В версиях OS X ранее, чем v10.6, проигнорировано это свойство. Для приложений, соединяющихся против v10.6 и выше, это свойство определяет, какие файлы должны быть включены в открытой панели. Вы не должны использовать устаревшие методы показать открытую панель (т.е. методы, берущие a types: параметр), потому что они перезапишут это значение. В то время как панель работает (например, от вспомогательного представление), позволенные типы файлов могут быть изменены. Это также известно как “включенные типы файлов”. A nil значение указывает, что должны быть включены все файлы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • allowsOtherFileTypes allowsOtherFileTypes Свойство

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

    Объявление

    Swift

    var allowsOtherFileTypes: Bool

    Objective C

    @property BOOL allowsOtherFileTypes

    Обсуждение

    Когда значение этого свойства YEStrue, панель позволяет пользователю сохранить файлы с расширением, это не находится в списке позволенных типов. Значение по умолчанию NOfalse.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • treatsFilePackagesAsDirectories treatsFilePackagesAsDirectories Свойство

    Булево значение, указывающее, выводит ли панель на экран пакеты файла как каталоги.

    Объявление

    Swift

    var treatsFilePackagesAsDirectories: Bool

    Objective C

    @property BOOL treatsFilePackagesAsDirectories

    Обсуждение

    Когда значение этого свойства YEStrue, панель выводит на экран пакеты файла как каталоги; если NOfalse, это не будет.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Рабочие панели
  • beginSheetForDirectory:file:modalForWindow:modalDelegate:didEndSelector:contextInfo: - beginSheetForDirectory:file:modalForWindow:modalDelegate:didEndSelector:contextInfo: (OS X v10.6)

    Представляет панель Save как лист с указанным путем и, дополнительно, указанным файлом по тому пути.

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

    Использовать beginSheetModalForWindow:completionHandler: вместо этого.

    Объявление

    Objective C

    - (void)beginSheetForDirectory:(NSString *)path file:(NSString *)name modalForWindow:(NSWindow *)docWindow modalDelegate:(id)modalDelegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo

    Параметры

    path

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

    name

    Указывает определенный файл в path когда панель Save представлена пользователю, это выбрано. Когда nil, никакой файл первоначально не выбран.

    docWindow

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

    modalDelegate

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

    didEndSelector

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

    • - (void)savePanelDidEnd:(NSSavePanel *)sheet returnCode:(int)returnCode contextInfo:(void *)contextInfo;

    Значение передало как returnCode также NSCancelButton или NSOKButton.

    contextInfo

    Контекстная информация передала modalDelegate в didEndSelector сообщение.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – beginSheetModalForWindow:completionHandler:

  • beginSheetModalForWindow (_: completionHandler:) - beginSheetModalForWindow:completionHandler:

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

    Объявление

    Swift

    func beginSheetModalForWindow(_ window: NSWindow, completionHandler handler: (Int) -> Void)

    Objective C

    - (void)beginSheetModalForWindow:(NSWindow *)window completionHandler:(void (^)(NSInteger result))handler

    Параметры

    window

    Окно, в котором будет представлена панель.

    handler

    Блок, вызванный после пользователя, отклоняет панель. Параметр передал в, будет NSFileHandlingPanelOKButton если пользователь выбрал кнопку OK или NSFileHandlingPanelCancelButton если пользователь выбрал Кнопку отмены.

    Обсуждение

    Любые свойства панели, которую Вы хотите установить, должны быть установлены прежде, чем вызвать этот метод. Несмотря на то, что блок обработчика завершения вызывают после того, как пользователь отклоняет панель, лист панели может все еще быть видим на экране. Если необходимо удалить лист из экрана — например, если блок завершения выводит на экран предупреждение — сначала вызывают [savePanel orderOut:nil] закрыть лист.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • beginWithCompletionHandler (_:) - beginWithCompletionHandler:

    Представляет панель как немодальное окно.

    Объявление

    Swift

    func beginWithCompletionHandler(_ handler: (Int) -> Void)

    Objective C

    - (void)beginWithCompletionHandler:(void (^)(NSInteger result))handler

    Параметры

    handler

    Блок, вызванный после пользователя, закрыл панель. Параметр передал в, будет NSFileHandlingPanelOKButton если пользователь выбрал кнопку OK или NSFileHandlingPanelCancelButton если пользователь выбрал Кнопку отмены.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • runModal () - runModal

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

    Объявление

    Swift

    func runModal() -> Int

    Objective C

    - (NSInteger)runModal

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

    NSFileHandlingPanelOKButton (если пользователь щелкает по кнопке OK), или NSFileHandlingPanelCancelButton (если пользователь щелкает по Кнопке отмены).

    Обсуждение

    Этот метод вызывает NSApplication runModalForWindow: метод с self как параметр.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    runModalForWindow: (NSApplication)

  • runModalForDirectory:file: - runModalForDirectory:file: (OS X v10.6)

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

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

    Использовать runModal вместо этого.

    Объявление

    Objective C

    - (NSInteger)runModalForDirectory:(NSString *)path file:(NSString *)filename

    Параметры

    path

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

    filename

    Указывает определенный файл в path когда панель Save представлена пользователю, это выбрано. Когда nil, никакой файл первоначально не выбран.

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

    NSFileHandlingPanelOKButton (если пользователь щелкает по кнопке OK), или NSFileHandlingPanelCancelButton (если пользователь щелкает по Кнопке отмены).

    Обсуждение

    Этот метод вызывает NSApplication runModalForWindow: метод с self как параметр.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – runModal
    runModalForWindow: (NSApplication)

  • panel:compareFilename:with:caseSensitive: panel:compareFilename:with:caseSensitive: (OS X v10.6)

    Управляет упорядочиванием файлов, представленных NSSavePanel объект указан.

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

    Нет никакой замены.

    Объявление

    Objective C

    - (NSComparisonResult)panel:(id)sender compareFilename:(NSString *)fileName1 with:(NSString *)fileName2 caseSensitive:(BOOL)flag

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • panel:isValidFilename: panel:isValidFilename: (OS X v10.6)

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

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

    Использовать panel:validateURL:error: (NSOpenSavePanelDelegate) вместо этого. Если оба метода будут реализованы, то версию URL вызовут.

    Объявление

    Objective C

    - (BOOL)panel:(id)sender isValidFilename:(NSString *)filename

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    panel:validateURL:error: (NSOpenSavePanelDelegate)

  • validateVisibleColumns () - validateVisibleColumns

    Проверяет и возможно перезагружает столбцы браузера, видимые в панели путем вызова метода делегата panel:shouldShowFilename:.

    Объявление

    Swift

    func validateVisibleColumns()

    Objective C

    - (void)validateVisibleColumns

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • panel:shouldShowFilename: panel:shouldShowFilename: (OS X v10.6)

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

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

    Использовать panel:shouldEnableURL: (NSOpenSavePanelDelegate).

    Объявление

    Objective C

    - (BOOL)panel:(id)sender shouldShowFilename:(NSString *)filename

    Обсуждение

    NSSavePanel объект sender отправляет это сообщение делегату панели к каждому файлу или каталогу (имя файла), это собирается загрузиться в браузере.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    panel:shouldEnableURL: (NSOpenSavePanelDelegate).

  • panel:directoryDidChange: panel:directoryDidChange: (OS X v10.6)

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

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

    Использовать panel:didChangeToDirectoryURL: (NSOpenSavePanelDelegate) вместо этого.

    Объявление

    Objective C

    - (void)panel:(id)sender directoryDidChange:(NSString *)path

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    panel:didChangeToDirectoryURL: (NSOpenSavePanelDelegate)

Выбор зарегистрированного пользователя
  • каталог - каталог (OS X v10.6)

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

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

    Использовать directoryURL вместо этого.

    Объявление

    Objective C

    - (NSString *)directory

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    directoryURL

  • имя файла - имя файла (OS X v10.6)

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

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

    Использовать URL вместо этого.

    Объявление

    Objective C

    - (NSString *)filename

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

    Абсолютный путь файла.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    URL

  • URL URL Свойство

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

    Объявление

    Swift

    @NSCopying var URL: NSURL? { get }

    Objective C

    @property(readonly, copy) NSURL *URL

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • расширенный расширенный Свойство

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

    Объявление

    Swift

    var expanded: Bool { get }

    Objective C

    @property(getter=isExpanded, readonly) BOOL expanded

    Обсуждение

    Значение этого свойства YEStrue если расширена панель; иначе, NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • nameFieldStringValue nameFieldStringValue Свойство

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

    Объявление

    Swift

    var nameFieldStringValue: String

    Objective C

    @property(copy) NSString *nameFieldStringValue

    Обсуждение

    Значение этого свойства не должно быть nil. Обратите внимание на то, что имя файла может не вывести на экран расширение если значение extensionHidden YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • selectText: - selectText: (OS X v10.3)

    Этот метод был осужден.

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

    Нет никакой замены.

    Объявление

    Objective C

    - (IBAction)selectText:(id)sender

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

    Objective C

    @import AppKit;

    Доступность

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

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

Обработка действий
  • хорошо (_:) - хорошо:

    Когда пользователь щелкает по кнопке OK панели, этот метод действия вызывается.

    Объявление

    Swift

    @IBAction func ok(_ sender: AnyObject?)

    Objective C

    - (IBAction)ok:(id)sender

    Параметры

    sender

    NSSavePanel возразите, по чьей кнопке OK щелкнули.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – отмена:

  • отмена (_:) - отмена:

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

    Объявление

    Swift

    @IBAction func cancel(_ sender: AnyObject?)

    Objective C

    - (IBAction)cancel:(id)sender

    Параметры

    sender

    NSSavePanel возразите, по чьей Кнопке отмены щелкнули.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – хорошо:

Константы
  • Теги кнопки

    Теги кнопки, относящиеся к элементам на панели.

    Объявление

    Swift

    var NSFileHandlingPanelCancelButton: Int { get } var NSFileHandlingPanelOKButton: Int { get }

    Objective C

    enum { NSFileHandlingPanelCancelButton = NSCancelButton, NSFileHandlingPanelOKButton = NSOKButton };

    Константы

    • NSFileHandlingPanelCancelButton

      NSFileHandlingPanelCancelButton

      Кнопка отмены.

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

    • NSFileHandlingPanelOKButton

      NSFileHandlingPanelOKButton

      Кнопка OK.

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