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

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

Разработчик

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

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

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

NSOpenPanel

NSOpenPanel класс обеспечивает панель Open для пользовательского интерфейса Какао. Приложения используют панель Open в качестве удобного способа запросить пользователя для имени файла для открытия.

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

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

    Создает и возвращает a NSOpenPanel объект.

    Объявление

    Objective C

    + (NSOpenPanel *)openPanel

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

Конфигурирование панелей
  • canChooseFiles - canChooseFiles

    Возвраты, позволяет ли панель пользователю выбирать файлы для открытия.

    Объявление

    Swift

    var canChooseFiles: Bool

    Objective C

    @property BOOL canChooseFiles

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

    YEStrue если панель позволяет пользователю выбирать файлы; иначе, NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setCanChooseFiles:

  • setCanChooseFiles: - setCanChooseFiles:

    Наборы, может ли пользователь выбрать файлы в браузере панели.

    Объявление

    Swift

    var canChooseFiles: Bool

    Objective C

    @property BOOL canChooseFiles

    Параметры

    flag

    Если YEStrue, панель позволяет пользователю выбирать файлы; если NOfalse, это не делает.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – canChooseFiles

  • canChooseDirectories - canChooseDirectories

    Возвраты, позволяет ли панель пользователю выбирать каталоги для открытия.

    Объявление

    Swift

    var canChooseDirectories: Bool

    Objective C

    @property BOOL canChooseDirectories

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setCanChooseDirectories:

  • setCanChooseDirectories: - setCanChooseDirectories:

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

    Объявление

    Swift

    var canChooseDirectories: Bool

    Objective C

    @property BOOL canChooseDirectories

    Параметры

    flag

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

    Обсуждение

    Когда каталог выбран, кнопка OK включена только если flag YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – canChooseDirectories

  • resolvesAliases - resolvesAliases

    Возвраты, разрешает ли панель псевдонимы.

    Объявление

    Swift

    var resolvesAliases: Bool

    Objective C

    @property BOOL resolvesAliases

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

    YEStrue если панель разрешает псевдонимы; иначе, NOfalse.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setResolvesAliases:

  • setResolvesAliases: - setResolvesAliases:

    Наборы, разрешает ли панель псевдонимы.

    Объявление

    Swift

    var resolvesAliases: Bool

    Objective C

    @property BOOL resolvesAliases

    Параметры

    resolvesAliases

    Если YEStrue, панель разрешает псевдонимы; если NOfalse, это не делает.

    Обсуждение

    Если YEStrue, эффект состоит в том, что отбрасывание псевдонима на панели или выяснении имен файлов или URLs возвращает разрешенные псевдонимы. Установите это значение в NOfalse позволить выбор псевдонимов без разрешения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – resolvesAliases

  • allowsMultipleSelection - allowsMultipleSelection

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

    Объявление

    Swift

    var allowsMultipleSelection: Bool

    Objective C

    @property BOOL allowsMultipleSelection

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

    YEStrue если браузер панели позволяет множественный выбор; иначе, NOfalse.

    Обсуждение

    Если многократные файлы или каталоги позволяются, то filename метод — наследованный от NSSavePanel — возвращается не -nil оцените, только если выбран один и только один файл. В отличие от этого, NSOpenPanel URLs даже если только один файл выбран, метод всегда возвращает URLs выбранных файлов.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    URL (NSSavePanel)
    – URLs
    – setAllowsMultipleSelection:

  • setAllowsMultipleSelection: - setAllowsMultipleSelection:

    Наборы, может ли пользователь выбрать многократные файлы (и каталоги) когда-то для открытия.

    Объявление

    Swift

    var allowsMultipleSelection: Bool

    Objective C

    @property BOOL allowsMultipleSelection

    Параметры

    flag

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – allowsMultipleSelection

Рабочие панели
  • beginForDirectory:file:types:modelessDelegate:didEndSelector:contextInfo: - beginForDirectory:file:types:modelessDelegate:didEndSelector:contextInfo: (OS X v10.6)

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

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

    Использовать beginWithCompletionHandler: вместо этого. Можно установить absoluteDirectoryPath использование setDirectoryURL:, и можно установить fileTypes использование setAllowedFileTypes:.

    Объявление

    Objective C

    - (void)beginForDirectory:(NSString *)absoluteDirectoryPath file:(NSString *)filename types:(NSArray *)fileTypes modelessDelegate:(id)modelessDelegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo

    Параметры

    absoluteDirectoryPath

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

    filename

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

    fileTypes

    Массив расширений файла и/или типов файлов HFS. Указывает файлы, которые панель позволяет пользователю выбирать. nil делает все файлы в absoluteDirectoryPath можно выбрать пользователем. Массив типов передал в, здесь переопределит использование набора того setAllowedFileTypes:.

    modelessDelegate

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

    didEndSelector

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

    • - (void)openPanelDidEnd:(NSOpenPanel *)panel returnCode:(int)returnCode contextInfo:(void *)contextInfo

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

    contextInfo

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

    Обсуждение

    Подобный beginSheetForDirectory:file:types:modalForWindow:modalDelegate:didEndSelector:contextInfo:, но допускает немодальную работу панели.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    beginWithCompletionHandler:

  • beginSheetForDirectory:file:types:modalForWindow:modalDelegate:didEndSelector:contextInfo: - beginSheetForDirectory:file:types:modalForWindow:modalDelegate:didEndSelector:contextInfo: (OS X v10.6)

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

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

    Использовать beginSheetModalForWindow:completionHandler: вместо этого. Можно установить absoluteDirectoryPath использование setDirectoryURL:, и можно установить fileTypes использование setAllowedFileTypes:.

    Объявление

    Objective C

    - (void)beginSheetForDirectory:(NSString *)absoluteDirectoryPath file:(NSString *)filename types:(NSArray *)fileTypes modalForWindow:(NSWindow *)docWindow modalDelegate:(id)modalDelegate didEndSelector:(SEL)didEndSelector contextInfo:(void *)contextInfo

    Параметры

    absoluteDirectoryPath

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

    filename

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

    fileTypes

    Массив расширений файла и/или типов файлов HFS. Указывает файлы, которые панель позволяет пользователю выбирать. ноль делает все файлы в absoluteDirectoryPath можно выбрать пользователем. Массив типов передал в, здесь переопределит использование набора того setAllowedFileTypes:.

    docWindow

    Окно для открытия листа на.

    modalDelegate

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

    didEndSelector

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

    • - (void)openPanelDidEnd:(NSOpenPanel *)panel 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:

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

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

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

    Использовать runModal вместо этого. Можно установить path использование setDirectoryURL:, и можно установить fileTypes использование setAllowedFileTypes:.

    Объявление

    Objective C

    - (NSInteger)runModalForDirectory:(NSString *)absoluteDirectoryPath file:(NSString *)filename types:(NSArray *)fileTypes

    Параметры

    absoluteDirectoryPath

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

    filename

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

    fileTypes

    Массив расширений файла и/или типов файлов HFS. Указывает файлы, которые панель позволяет пользователю выбирать. nil делает все файлы в absoluteDirectoryPath можно выбрать пользователем. Массив типов передал в, здесь переопределит использование набора того setAllowedFileTypes:.

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

    Кнопка, нажатая для отклонения диалогового окна: NSOKButton для кнопки OK и NSCancelButton для Кнопки отмены.

    Обсуждение

    Можно управлять, появляются ли каталоги и файлы в браузере с setCanChooseDirectories: и setCanChooseFiles: методы.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    runModal

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

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

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

    Использовать runModal вместо этого. Можно установить fileTypes использование setAllowedFileTypes:.

    Объявление

    Objective C

    - (NSInteger)runModalForTypes:(NSArray *)fileTypes

    Параметры

    fileTypes

    Массив расширений файла и/или типов файлов HFS. Указывает файлы, которые панель позволяет пользователю выбирать. nil делает все файлы можно выбрать пользователем. Массив типов передал в, здесь переопределит использование набора того setAllowedFileTypes:.

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

    Кнопка раньше отклоняла диалоговое окно: NSOKButton для кнопки OK и NSCancelButton для Кнопки отмены.

    Обсуждение

    Этот удобный метод отправляет runModalForDirectory:nil file:nil types:fileTypes к панели. Посмотрите runModalForDirectory:file:types: для дополнительных подробных данных.

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    runModal

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

    Возвращает массив, содержащий абсолютные пути (как объекты NSString) выбранных файлов и каталогов.

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

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

    Объявление

    Objective C

    - (NSArray *)filenames

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

    Массив имен файлов.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

    См. также

    – URLs

  • URLs - URLs

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

    Объявление

    Swift

    var URLs: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *URLs

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

    Массив URLs.

    Обсуждение

    Если множественные выборы не позволяются, массив содержит единственное имя.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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