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

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

Разработчик

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

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

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

NSDocumentController

NSDocumentController объект управляет документами приложения. Как цель первого респондента команд меню New и Open, это создает и открывает документы и отслеживает их всюду по сеансу приложения. Когда вводные документы, NSDocumentController выполнения и управляют модальной панелью Open. NSDocumentController объекты также поддерживают и управляют отображениями типов документов, расширениями, и NSDocument подклассы, как указано в CFBundleDocumentTypes свойство загрузилось от информационного списка свойств (Info.plist).

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

В некоторых ситуациях стоит разделить на подклассы NSDocumentController в не -NSDocument- основанные приложения для получения некоторых его функций. Например, NSDocumentController управление меню Open Recent полезно в приложениях, не использующих подклассы NSDocument.

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Получение совместно используемого контроллера документа
  • sharedDocumentController () + sharedDocumentController

    Возвращает совместно используемое NSDocumentController экземпляр.

    Объявление

    Swift

    class func sharedDocumentController() -> AnyObject

    Objective C

    + (id)sharedDocumentController

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

    Совместно используемое NSDocumentController экземпляр.

    Обсуждение

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

    Инициализация читает в типах документов из CFBundleDocumentTypes список свойств (в Info.plist), регистрирует экземпляр для NSWorkspaceWillPowerOffNotifications, и включает флаг, указывающий, что пользовательские интерфейсы документа должны быть видимы. Необходимо всегда получать приложение NSDocumentController использование этого метода.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – setShouldCreateUI:

Инициализация нового NSDocumentController
  • init () - init Определяемый инициализатор

    Этот метод является определяемым инициализатором для NSDocumentController.

    Объявление

    Swift

    init()

    Objective C

    - (instancetype)init

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

    Инициализированный объект контроллера документа.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Создание и вводные документы
  • documentForURL (_:) - documentForURL:

    Возвраты, для данного URL, открытый документ, пакет файла или файла которого расположен URL, или nil если нет такого открытого документа.

    Объявление

    Swift

    func documentForURL(_ absoluteURL: NSURL) -> AnyObject?

    Objective C

    - (id)documentForURL:(NSURL *)absoluteURL

    Параметры

    absoluteURL

    URL документа Вы хотите искать.

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

    Недавно создаваемый NSDocument объект, или nil если не мог бы быть создан документ.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • duplicateDocumentWithContentsOfURL (_: copying:displayName:error:) - duplicateDocumentWithContentsOfURL:copying:displayName:error:

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

    Объявление

    Swift

    func duplicateDocumentWithContentsOfURL(_ url: NSURL, copying duplicateByCopying: Bool, displayName displayNameOrNil: String?, error outError: NSErrorPointer) -> NSDocument?

    Objective C

    - (NSDocument *)duplicateDocumentWithContentsOfURL:(NSURL *)url copying:(BOOL)duplicateByCopying displayName:(NSString *)displayNameOrNil error:(NSError **)outError

    Параметры

    url

    URL, определяющий местоположение документа, с которого копируется содержание нового документа.

    duplicateByCopying

    Если YEStrue, содержание, расположенное в переданном - в URL, копируется в файл, расположенный в каталоге, используемом для сохраненного автоматически содержания документов без названия.

    displayNameOrNil

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

    outError

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

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

    Недавно создаваемый NSDocument объект, или nil если не мог бы быть создан документ.

    Обсуждение

    Реализация по умолчанию этого метода копирует файл, если указано, определяет тип документа, вызовов makeDocumentForURL:withContentsOfURL:ofType:error: для инстанцирования его, отправляет документ setDisplayName: назвать его если displayNameOrNil не nil, вызовы addDocument: записывать его открытие, и отправляет документ makeWindowControllers и showWindows сообщения.

    Реализация по умолчанию этого метода использует механизм координации файла, представленный в OS X v10.7. Это передает документ NSFileCoordinator метод addFilePresenter: сразу после вызова addDocument: метод. (Балансирующийся вызов NSFileCoordinator метод removeFilePresenter: находится в NSDocument метод close.)

    Можно переопределить этот метод, чтобы настроить, как дублированы документы. Это вызывают NSDocument метод duplicateAndReturnError:. Это можно также вызвать от других мест в AppKit.

    В большинстве случаев приложение не должно вызывать этот метод непосредственно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • openDocumentWithContentsOfURL (_: display:completionHandler:) - openDocumentWithContentsOfURL:display:completionHandler:

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

    Объявление

    Swift

    func openDocumentWithContentsOfURL(_ url: NSURL, display displayDocument: Bool, completionHandler completionHandler: (NSDocument!, Bool, NSError!) -> Void)

    Objective C

    - (void)openDocumentWithContentsOfURL:(NSURL *)url display:(BOOL)displayDocument completionHandler:(void (^)(NSDocument *document, BOOL documentWasAlreadyOpen, NSError *error))completionHandler

    Параметры

    url

    URL, определяющий местоположение документа для открытия.

    displayDocument

    Если YEStrue, выводит на экран пользовательский интерфейс документа.

    completionHandler

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

    Блок берет три параметра:

    document

    Документ, открытый, в случае успеха. Иначе, nil.

    documentWasAlreadyOpen

    Когда этот метод вызвали, был ли документ уже открыт или открыл.

    error

    Если не успешный, NSError объект, инкапсулирующий причину, почему не мог быть открыт документ.

    Обсуждение

    Реализация по умолчанию этого метода проверки, чтобы видеть, открыт ли документ уже или быть открытым, и если это не, определяет тип документа, вызовов makeDocumentWithContentsOfURL:ofType:error: инстанцировать его, и вызовы addDocument: записывать его открытие. Если displayDocument YEStrue и документ не уже открыт, вызовы реализации по умолчанию makeWindowControllers и showWindows. Если документ уже открыт, реализация просто вызывает showWindows если displayDocument YEStrue. Если возвращается класс релевантного документа YEStrue когда отправлено canConcurrentlyReadDocumentsOfType: тогда вызов makeDocumentWithContentsOfURL:ofType:error: сделан на потоке кроме основного, и когда это возвратилось, остальная часть работы сделана на основном потоке.

    Реализация по умолчанию этого метода использует механизм координации файла, добавленный к платформе Основы в OS X v10.7. Вся работа, которую это выполняет, является одним большим скоординированным чтением, и это передает документ NSFileCoordinator метод addFilePresenter: прямо после вызова addDocument:. (Балансирующийся вызов NSFileCoordinator метод removeFilePresenter: находится в NSDocument метод close.)

    Можно переопределить этот метод, чтобы настроить, как открыты документы. Его реализация, однако, несколько сложна, таким образом, необходимо обычно исследовать переопределение одного из методов, которые это вызывает вместо этого. Однако можно переопределить этот метод для выполнения дополнительной работы перед обращением к базовому методу super. Можно также обратиться к базовому методу super с пользовательским обработчиком завершения, выполняющим дополнительную работу прежде, чем вызвать исходный обработчик завершения. При переопределении этого метода, необходимо заняться расследованиями, необходимо ли также переопределить reopenDocumentForURL:withContentsOfURL:display:completionHandler: применять ту же настройку. В любом случае заботьтесь, чтобы всегда вызвать обработчик завершения на основном потоке.

    Можно вызвать этот метод для открытия документа.

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

    Для обратной совместимости на уровне двоичных кодов с OS X v10.6 и ранее, реализация по умолчанию этого вызовы метода [self openDocumentWithContentsOfURL:url display:displayDocument error:&anError] если тот метод или еще более старое openDocumentWithContentsOfFile:display: метод переопределяется, и этот не вместо вызова makeDocumentWithContentsOfURL:ofType:error: и все остальные.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • openUntitledDocumentAndDisplay (_: ошибка:) - openUntitledDocumentAndDisplay:error:

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

    Объявление

    Swift

    func openUntitledDocumentAndDisplay(_ displayDocument: Bool, error outError: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)openUntitledDocumentAndDisplay:(BOOL)displayDocument error:(NSError **)outError

    Параметры

    displayDocument

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

    outError

    По возврату, ошибка, если документ не мог бы быть создан, иначе nil.

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

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

    Обсуждение

    Реализация по умолчанию этого вызовы метода defaultType определить тип нового документа для создания, вызовы makeUntitledDocumentOfType:error: для создания его, затем вызывает addDocument: записывать его открытие. Если displayDocument YEStrue, это тогда отправляет новый документ makeWindowControllers и showWindows сообщения.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • makeDocumentForURL (_: withContentsOfURL:ofType:error:) - makeDocumentForURL:withContentsOfURL:ofType:error:

    Инстанцирует документа, расположенного URL, указанного типа, но путем чтения содержания для документа от другого URL, и возвращает его в случае успеха.

    Объявление

    Swift

    func makeDocumentForURL(_ absoluteDocumentURL: NSURL?, withContentsOfURL absoluteDocumentContentsURL: NSURL, ofType typeName: String, error outError: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)makeDocumentForURL:(NSURL *)absoluteDocumentURL withContentsOfURL:(NSURL *)absoluteDocumentContentsURL ofType:(NSString *)typeName error:(NSError **)outError

    Параметры

    absoluteDocumentURL

    Расположение нового объекта документа.

    absoluteDocumentContentsURL

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

    typeName

    Тип документа.

    outError

    По возврату, ошибка, если документ не мог бы быть создан, иначе nil.

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

    Недавно создаваемый NSDocument объект, или nil если не мог бы быть создан документ.

    Обсуждение

    URL указан absoluteDocumentURL, тип typeName, и другой URL, обеспечивающий содержание absoluteDocumentContentsURL. Если не успешный, возвраты метода nil после установки outError указать на NSError объект, инкапсулирующий причину, почему нельзя было инстанцировать документ. Реализация по умолчанию этого вызовы метода documentClassForType: узнать класс документа для инстанцирования, выделяет объект документа и инициализирует его путем отправки его initForURL:withContentsOfURL:ofType:error: сообщение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • makeDocumentWithContentsOfURL (_: ofType:error:) - makeDocumentWithContentsOfURL:ofType:error:

    Инстанцирует документа, расположенного URL, указанного типа, и возвращает его в случае успеха.

    Объявление

    Swift

    func makeDocumentWithContentsOfURL(_ absoluteURL: NSURL, ofType typeName: String, error outError: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)makeDocumentWithContentsOfURL:(NSURL *)absoluteURL ofType:(NSString *)typeName error:(NSError **)outError

    Параметры

    absoluteURL

    Расположение нового объекта документа.

    typeName

    Тип документа.

    outError

    По возврату, ошибка, если документ не мог бы быть создан, иначе nil.

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

    Недавно создаваемый NSDocument объект, или nil если не мог бы быть создан документ.

    Обсуждение

    URL указан absoluteURL и тип документа typeName. Если не успешный, возвраты метода nil после установки outError указать на NSError, инкапсулирующий причину, почему нельзя было инстанцировать документ. Реализация по умолчанию этого вызовы метода documentClassForType: узнать класс документа для инстанцирования, выделяет объект документа и инициализирует его путем отправки его initWithContentsOfURL:ofType:error: сообщение.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • makeUntitledDocumentOfType (_: ошибка:) - makeUntitledDocumentOfType:error:

    Инстанцирует нового документа без названия указанного типа и возвращает его в случае успеха.

    Объявление

    Swift

    func makeUntitledDocumentOfType(_ typeName: String, error outError: NSErrorPointer) -> AnyObject?

    Objective C

    - (id)makeUntitledDocumentOfType:(NSString *)typeName error:(NSError **)outError

    Обсуждение

    Тип документа указан typeName. Если не успешный, возвраты метода nil после установки outError указать на NSError объект, инкапсулирующий причину, почему нельзя было инстанцировать новый документ без названия. Реализация по умолчанию этого вызовы метода documentClassForType: узнать класс документа для инстанцирования, затем выделяет и инициализирует документ путем отправки его initWithType:error:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • reopenDocumentForURL (_: withContentsOfURL:display:completionHandler:) - reopenDocumentForURL:withContentsOfURL:display:completionHandler:

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

    Объявление

    Swift

    func reopenDocumentForURL(_ urlOrNil: NSURL?, withContentsOfURL contentsURL: NSURL, display displayDocument: Bool, completionHandler completionHandler: (NSDocument!, Bool, NSError!) -> Void)

    Objective C

    - (void)reopenDocumentForURL:(NSURL *)urlOrNil withContentsOfURL:(NSURL *)contentsURL display:(BOOL)displayDocument completionHandler:(void (^)(NSDocument *document, BOOL documentWasAlreadyOpen, NSError *error))completionHandler

    Параметры

    urlOrNil

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

    contentsURL

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

    displayDocument

    Если YEStrue, выводит на экран пользовательский интерфейс документа.

    completionHandler

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

    Блок берет три параметра:

    document

    Документ, открытый, в случае успеха. Иначе, nil.

    documentWasAlreadyOpen

    Когда этот метод вызвали, был ли документ уже открыт или открыл.

    error

    Если не успешный, NSError объект, инкапсулирующий причину, почему не мог быть открыт документ.

    Обсуждение

    Реализация по умолчанию этого метода очень подобна openDocumentWithContentsOfURL:display:completionHandler:, главная разница, являющаяся этим, это вызывает makeDocumentForURL:withContentsOfURL:ofType:error: вместо makeDocumentWithContentsOfURL:ofType:error:.

    Можно переопределить этот метод, чтобы настроить, как документы вновь открываются во время приложения, запускающегося восстановимым механизмом состояния, представленным в OS X v10.7. Его реализация, однако, несколько сложна, таким образом, необходимо обычно исследовать переопределение одного из методов, которые это вызывает вместо этого. Однако можно переопределить этот метод для выполнения дополнительной работы перед обращением к базовому методу super. Можно также обратиться к базовому методу super с пользовательским обработчиком завершения, выполняющим дополнительную работу прежде, чем вызвать исходный обработчик завершения.

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

    Для обратной совместимости на уровне двоичных кодов с OS X v10.6 и ранее, реализация по умолчанию этого вызовы метода [self reopenDocumentForURL:url withContentsOfURL:contentsURL error:&anError] если тот метод переопределяется, и этот не вместо вызова makeDocumentForURL:withContentsOfURL:ofType:error: и все остальные.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление документами
  • документы документы Свойство

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

    Объявление

    Swift

    var documents: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *documents

    Обсуждение

    Массив содержит нуль или больше NSDocument объекты.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    currentDocument
    – documentForFileName:
    – documentForWindow:

  • addDocument (_:) - addDocument:

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

    Объявление

    Swift

    func addDocument(_ document: NSDocument)

    Objective C

    - (void)addDocument:(NSDocument *)document

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • currentDocument currentDocument Свойство

    Объект документа связался с главным окном. (только для чтения)

    Объявление

    Swift

    var currentDocument: AnyObject? { get }

    Objective C

    @property(readonly, strong) id currentDocument

    Обсуждение

    Значение этого свойства nil когда приложение не активно, если это вызывают. Это может произойти во время обработки работы перетаскивания, например, в реализации readSelectionFromPasteboard:. В таком случае отправьте следующее сообщение вместо этого от NSView подкласс связался с документом:

    • [[[self window] windowController] document];

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – documentForFileName:
    – documentForWindow:
    документы

  • documentForWindow (_:) - documentForWindow:

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

    Объявление

    Swift

    func documentForWindow(_ window: NSWindow) -> AnyObject?

    Objective C

    - (id)documentForWindow:(NSWindow *)window

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

    Объект документа, контроллеру окна которого принадлежит window. Возвраты nil если window nil, если window если контроллер окна не имеет связи с экземпляром, не имеет никакого контроллера окна, или NSDocument.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    currentDocument
    – documentForFileName:
    документы

  • hasEditedDocuments hasEditedDocuments Свойство

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

    Объявление

    Swift

    var hasEditedDocuments: Bool { get }

    Objective C

    @property(readonly) BOOL hasEditedDocuments

    Обсуждение

    Значение этого свойства YEStrue если контроллер документа содержит документы с несохраненными изменениями; иначе, значение NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    документы

  • removeDocument (_:) - removeDocument:

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

    Объявление

    Swift

    func removeDocument(_ document: NSDocument)

    Objective C

    - (void)removeDocument:(NSDocument *)document

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление типами документов
  • documentClassNames documentClassNames Свойство

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

    Объявление

    Swift

    var documentClassNames: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *documentClassNames

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • defaultType () - defaultType

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

    Объявление

    Swift

    func defaultType() -> String?

    Objective C

    - (NSString *)defaultType

    Обсуждение

    Реализация по умолчанию этого метода возвращает первый тип Редактора, объявленный CFBundleDocumentTypes массив в приложении Info.plist, или возвраты nil если не объявляется никакой тип Редактора. Можно переопределить его для настройки типа документа, создающегося, когда, например, пользователь выбирает New в меню File.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • documentClassForType (_:) - documentClassForType:

    Возвраты NSDocument подкласс связался с данным типом документа.

    Объявление

    Swift

    func documentClassForType(_ documentTypeName: String) -> AnyClass?

    Objective C

    - (Class)documentClassForType:(NSString *)documentTypeName

    Параметры

    documentTypeName

    Имя типа документа, указанного CFBundleTypeName в приложении Info.plist файл.

    Тип документа должен быть одним, получатель может читать.

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

    Возвраты NSDocument подкласс связался с documentTypeName. Если класс не может быть найден, возвраты nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – displayNameForType:

  • displayNameForType (_:) - displayNameForType:

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

    Объявление

    Swift

    func displayNameForType(_ documentTypeName: String) -> String?

    Objective C

    - (NSString *)displayNameForType:(NSString *)documentTypeName

    Параметры

    documentTypeName

    Имя типа документа, указанного CFBundleTypeName в приложении Info.plist файл.

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

    Описательное имя для типа документа, указанного documentTypeName. Если нет никакого описательного имени, возвратов documentTypeName.

    Обсуждение

    Для основанного на документе приложения поддерживаемые типы документов указаны в Info.plist файл CFBundleDocumentTypes массив. Каждый тип документа указывает словарь в этом массиве и называют CFBundleTypeName атрибут. Можно обеспечить дескриптивное, локализованный, представление этого имени путем обеспечения соответствующей записи в InfoPlist.strings файл (ы). Например, данный Info.plist файл, содержащий следующий фрагмент:

    • <dict>
    • <key>CFBundleDocumentTypes</key>
    • <array>
    • <dict>
    • <key>CFBundleTypeName</key>
    • <string>BinaryFile</string>
    • <key>CFBundleTypeExtensions</key>
    • <array>
    • <string>binary</string>
    • </array>

    Вы могли обеспечить описательное имя путем включения записи InfoPlist.strings файл:

    • BinaryFile = "Binary file format";

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • typeForContentsOfURL (_: ошибка:) - typeForContentsOfURL:error:

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

    Объявление

    Swift

    func typeForContentsOfURL(_ url: NSURL, error outError: NSErrorPointer) -> String?

    Objective C

    - (NSString *)typeForContentsOfURL:(NSURL *)url error:(NSError **)outError

    Обсуждение

    URL представлен absoluteURL. Если не успешный, возвраты метода nil после установки outError указать на NSError объект, инкапсулирующий причину, почему тип документа не мог быть определен, или факт, что тип документа является нераспознанным.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Автоматическое сохранение
  • autosavingDelay autosavingDelay Свойство

    Временной интервал (в секундах) для периодического автоматического сохранения.

    Объявление

    Swift

    var autosavingDelay: NSTimeInterval

    Objective C

    @property NSTimeInterval autosavingDelay

    Обсуждение

    Значение 0 указывает, что периодическое автоматическое сохранение не должно быть сделано вообще. NSDocumentController возразите использует это число в качестве количества времени для ожидания между обнаружением, что документ не сохранил автоматически изменения и отправку документа autosaveDocumentWithDelegate:didAutosaveSelector:contextInfo: сообщение. Значение по умолчанию 0.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Заключительные документы
  • closeAllDocumentsWithDelegate (_: didCloseAllSelector:contextInfo:) - closeAllDocumentsWithDelegate:didCloseAllSelector:contextInfo:

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

    Объявление

    Swift

    func closeAllDocumentsWithDelegate(_ delegate: AnyObject?, didCloseAllSelector didCloseAllSelector: Selector, contextInfo contextInfo: UnsafeMutablePointer<Void>)

    Objective C

    - (void)closeAllDocumentsWithDelegate:(id)delegate didCloseAllSelector:(SEL)didCloseAllSelector contextInfo:(void *)contextInfo

    Обсуждение

    Каждый NSDocument объект отправляется canCloseDocumentWithDelegate:shouldCloseSelector:contextInfo:, который, если документ грязен, дает ему шанс отказаться закрывать или сохранять себя сначала. Этот метод может спросить, сохранить ли или выполнять сохранение.

    didCloseAllSelector с методом обратного вызова вызывают YEStrue если все документы закрываются, и NOfalse иначе. Передайте contextInfo объект с обратным вызовом. didCloseAllSelector метод обратного вызова должен иметь следующую подпись:

    • - (void)documentController:(NSDocumentController *)docController didCloseAll: (BOOL)didCloseAll contextInfo:(void *)contextInfo

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • reviewUnsavedDocumentsWithAlertTitle (_: cancellable:delegate:didReviewAllSelector:contextInfo:) - reviewUnsavedDocumentsWithAlertTitle:cancellable:delegate:didReviewAllSelector:contextInfo:

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

    Объявление

    Swift

    func reviewUnsavedDocumentsWithAlertTitle(_ title: String?, cancellable cancellable: Bool, delegate delegate: AnyObject?, didReviewAllSelector didReviewAllSelector: Selector, contextInfo contextInfo: UnsafeMutablePointer<Void>)

    Objective C

    - (void)reviewUnsavedDocumentsWithAlertTitle:(NSString *)title cancellable:(BOOL)cancellable delegate:(id)delegate didReviewAllSelector:(SEL)didReviewAllSelector contextInfo:(void *)contextInfo

    Обсуждение

    Присваивается delegate к панели. Вызовы didReviewAllSelector с YEStrue при отсутствии грязных документов, и, если завершенный без сохранения выбран или NOfalse иначе. Если пользователь выбирает опцию «Review Unsaved», closeAllDocumentsWithDelegate:didCloseAllSelector:contextInfo: вызывается. Этот метод вызывают, когда пользователь выбирает команду меню Quit, и также когда выключается производительность компьютера. Обратите внимание на то, что title проигнорирован. Передайте contextInfo объект с обратным вызовом.

    didReviewAllSelector метод обратного вызова должен иметь следующую подпись:

    • - (void)documentController:(NSDocumentController *)docController didReviewAll: (BOOL)didReviewAll contextInfo:(void *)contextInfo

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Ответ на сообщения действия
  • newDocument (_:) - newDocument:

    Метод действия, вызванный командой меню New, этот метод создает новое NSDocument возразите и добавляет его к списку таких объектов, которыми управляет контроллер документа.

    Объявление

    Swift

    @IBAction func newDocument(_ sender: AnyObject?)

    Objective C

    - (IBAction)newDocument:(id)sender

    Обсуждение

    Это вызовы метода openUntitledDocumentAndDisplay:error:.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – openDocument:

  • openDocument (_:) - openDocument:

    Метод действия, вызванный командой меню Open, это выполняет модальную панель Open и, на основе выбранных имен файлов, создает один или больше NSDocument объекты от содержания файлов.

    Объявление

    Swift

    @IBAction func openDocument(_ sender: AnyObject?)

    Objective C

    - (IBAction)openDocument:(id)sender

    Обсуждение

    Метод добавляет недавно созданные объекты к списку NSDocument объекты, которыми управляет контроллер документа. Это вызовы метода openDocumentWithContentsOfURL:display:completionHandler:, который фактически создает NSDocument объекты.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – fileNamesFromRunningOpenPanel
    – newDocument:

  • saveAllDocuments (_:) - saveAllDocuments:

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

    Объявление

    Swift

    @IBAction func saveAllDocuments(_ sender: AnyObject?)

    Objective C

    - (IBAction)saveAllDocuments:(id)sender

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    saveDocument: (NSDocument)

Управление открытым диалоговым окном
  • beginOpenPanelWithCompletionHandler (_:) - beginOpenPanelWithCompletionHandler:

    Представляет Открытое диалоговое окно и поставляет результаты к обработчику завершения как массив URLs для выбранных файлов (или nil).

    Объявление

    Swift

    func beginOpenPanelWithCompletionHandler(_ completionHandler: ([AnyObject]!) -> Void)

    Objective C

    - (void)beginOpenPanelWithCompletionHandler:(void (^)(NSArray *))completionHandler

    Параметры

    completionHandler

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

    Обсуждение

    Этот метод представляет или модальную или немодальную открытую панель, в зависимости от которой переопределяются методы. Несмотря на то, что можно вызвать этот метод при других обстоятельствах, этим методом обычно вызывают openDocument: в ответ на пользователя, выбор Open … из меню File.

    Если Вы переопределяете openDocument:, необходимо обычно вызывать этот метод вместо вызова beginOpenPanel:forTypes:completionHandler: или URLsFromRunningOpenPanel непосредственно, потому что этот метод выполняет модальную панель в пути, который назад совместим с подклассами то переопределение runModalOpenPanel:forTypes: без переопределения beginOpenPanel:forTypes:completionHandler:. Кроме того, его обработчик завершения определяет, которые снабжают кнопками нажатого пользователя (чтобы определить, возвратить ли массив или nil) и заказы открытая панель.

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

    Реализация по умолчанию этого вызовы метода также URLsFromRunningOpenPanel выполнять модальную открытую панель или beginOpenPanel:forTypes:completionHandler: начать немодальную открытую панель. Если пользователь принимает решение открыть файлы, реализация по умолчанию вызывает обработчик завершения с a nil параметр массива. Если пользователь отменяет Открытое диалоговое окно, реализация по умолчанию вызывает обработчик завершения с a nil параметр массива.

    При переопределении этого метода метод должен обычно обращаться к базовому методу super из-за дополнительного кода, который это обеспечивает бесплатно. В частности этот метод выполняет модальную панель в пути, который назад совместим с подклассами то переопределение runModalOpenPanel:forTypes: без переопределения beginOpenPanel:forTypes:completionHandler:. Кроме того, его обработчик завершения определяет, которые снабжают кнопками нажатого пользователя (чтобы определить, возвратить ли массив или nil) и заказы открытая панель.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • beginOpenPanel (_: forTypes:completionHandler:) - beginOpenPanel:forTypes:completionHandler:

    Представляет немодальное Открытое диалоговое окно, выводящее на экран файлы, которые могут быть открыты на основе списка UTIs.

    Объявление

    Swift

    func beginOpenPanel(_ openPanel: NSOpenPanel, forTypes inTypes: [AnyObject], completionHandler completionHandler: (Int) -> Void)

    Objective C

    - (void)beginOpenPanel:(NSOpenPanel *)openPanel forTypes:(NSArray *)inTypes completionHandler:(void (^)(NSInteger result))completionHandler

    Параметры

    openPanel

    Открытая панель для представления.

    inTypes

    Список типов файлов, которые пользователю нужно разрешить выбрать в открытой панели.

    completionHandler

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

    Блок берет следующий параметр:

    result

    Также NSOKButton или NSCancelButton, В зависимости от которого снабжают кнопками пользователя, нажатого для отклонения диалогового окна.

    Обсуждение

    Этим методом вызывают openDocument: и beginOpenPanelWithCompletionHandler: выполнять фактическую работу. Вы обычно не вызываете этот метод непосредственно. Можно переопределить этот метод по мере необходимости, чтобы настроить панель Open или изменить список UTIs в inTypes параметр.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • runModalOpenPanel (_: forTypes:) - runModalOpenPanel:forTypes:

    Вызовы NSOpenPanel runModalForTypes: метод, передавая openPanel возразите и файл extensions связанный с типом документа.

    Объявление

    Swift

    func runModalOpenPanel(_ openPanel: NSOpenPanel, forTypes types: [AnyObject]) -> Int

    Objective C

    - (NSInteger)runModalOpenPanel:(NSOpenPanel *)openPanel forTypes:(NSArray *)types

    Обсуждение

    Этот метод вызывают URLsFromRunningOpenPanel метод. extensions параметр может также содержать закодированные типы файлов HFS, а также расширения файла.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • currentDirectory currentDirectory Свойство

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

    Объявление

    Swift

    var currentDirectory: String? { get }

    Objective C

    @property(readonly, copy) NSString *currentDirectory

    Обсуждение

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

    • Расположение каталога, где был в последний раз сохранен текущий документ

    • Последний каталог посещают в панели Open

    • Корневой каталог пользователя

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – documentForFileName:

  • URLsFromRunningOpenPanel URLsFromRunningOpenPanel Свойство

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

    Объявление

    Swift

    var URLsFromRunningOpenPanel: [AnyObject]? { get }

    Objective C

    @property(readonly, copy) NSArray *URLsFromRunningOpenPanel

    Обсуждение

    Доступ к этому свойству создает NSOpenPanel объект и выполнения это с помощью runModalOpenPanel:forTypes: метод. Когда пользователь отклоняет панель, возвращенное значение является массивом URLs, соответствующего файлам, выбранным пользователем. Значение nil если пользователь отменяет панель Open или не делает выбора.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Управление открытым недавним меню
  • maximumRecentDocumentCount maximumRecentDocumentCount Свойство

    Максимальное количество элементов, которые могут быть представлены в стандартном меню Open Recent. (только для чтения)

    Объявление

    Swift

    var maximumRecentDocumentCount: Int { get }

    Objective C

    @property(readonly) NSUInteger maximumRecentDocumentCount

    Обсуждение

    Значение 0 указывает это NSDocumentController не попытается добавить меню Open Recent к меню File Вашего приложения, несмотря на то, что NSDocumentController не попытается удалить любой существующий ранее пункт меню Open Recent. Реализация по умолчанию возвращает значение, которое подвержено изменениям, и можете, или может не быть получен из настройки, установленной пользователем в Установках системы.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • clearRecentDocuments (_:) - clearRecentDocuments:

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

    Объявление

    Swift

    @IBAction func clearRecentDocuments(_ sender: AnyObject?)

    Objective C

    - (IBAction)clearRecentDocuments:(id)sender

    Обсуждение

    Это - действие для команды меню Clear, но это можно вызвать непосредственно при необходимости.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • noteNewRecentDocumentURL (_:) - noteNewRecentDocumentURL:

    Этот метод должны вызвать приложения не на основе NSDocument когда они открывают или сохраняют документы, идентифицированные данным URL.

    Объявление

    Swift

    func noteNewRecentDocumentURL(_ url: NSURL)

    Objective C

    - (void)noteNewRecentDocumentURL:(NSURL *)url

    Обсуждение

    NSDocument автоматически вызовы этот метод в надлежащих случаях для NSDocument- основанные приложения. Приложения не на основе NSDocument должен также реализовать application:openFile: метод в приложении делегирует для обрабатывания запросов от команды меню Open Recent. Можно переопределить этот метод в NSDocument- основанное приложение, чтобы препятствовать тому, чтобы определенные виды документов вошли в список (но необходимо идентифицировать их URL).

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • noteNewRecentDocument (_:) - noteNewRecentDocument:

    Этим методом вызывают NSDocument объекты в подходящее время для управления списком недавних документов.

    Объявление

    Swift

    func noteNewRecentDocument(_ document: NSDocument)

    Objective C

    - (void)noteNewRecentDocument:(NSDocument *)document

    Обсуждение

    Этот метод создает URL и вызовы noteNewRecentDocumentURL:. Подклассы могли бы переопределить этот метод, чтобы препятствовать тому, чтобы определенные документы или виды документов вошли в список.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • recentDocumentURLs recentDocumentURLs Свойство

    Список недавнего документа URLs. (только для чтения)

    Объявление

    Swift

    var recentDocumentURLs: [AnyObject] { get }

    Objective C

    @property(readonly, copy) NSArray *recentDocumentURLs

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Проверка элементов интерфейса пользователя
  • validateUserInterfaceItem (_:) - validateUserInterfaceItem:

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

    Объявление

    Swift

    func validateUserInterfaceItem(_ anItem: NSValidatedUserInterfaceItem) -> Bool

    Objective C

    - (BOOL)validateUserInterfaceItem:(id<NSValidatedUserInterfaceItem>)anItem

    Параметры

    anItem

    Элемент интерфейса пользователя для проверки. Можно отправить anItem action и tag сообщения.

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

    YEStrue если anItem должен быть включен, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Ошибки из-за неправильного обращения
  • presentError (_:) - presentError:

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

    Объявление

    Swift

    func presentError(_ error: NSError) -> Bool

    Objective C

    - (BOOL)presentError:(NSError *)error

    Параметры

    error

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

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

    Возвраты YEStrue если восстановление после ошибки было сделано, NOfalse иначе.

    Обсуждение

    Этот метод не возвращается, пока пользователь не отклоняет предупреждение и, если ошибка имеет опции восстановления и делегата восстановления, делегат восстановления ошибки отправляется attemptRecoveryFromError:optionIndex: сообщение.

    Значение по умолчанию NSDocumentController реализация этого метода эквивалентна тому из NSResponder при обработке объекта приложения как следующего респондента и передаче ошибочных презентационных сообщений ему. (Значение по умолчанию NSDocument реализация этого метода обрабатывает совместно используемое NSDocumentController экземпляр как следующий респондент и передает эти сообщения к нему.) Реализации по умолчанию нескольких NSDocumentController методы вызывают этот метод.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – willPresentError:
    – presentError:modalForWindow:delegate:didPresentSelector:contextInfo:

  • presentError (_: modalForWindow:delegate:didPresentSelector:contextInfo:) - presentError:modalForWindow:delegate:didPresentSelector:contextInfo:

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

    Объявление

    Swift

    func presentError(_ error: NSError, modalForWindow window: NSWindow, delegate delegate: AnyObject?, didPresentSelector didPresentSelector: Selector, contextInfo contextInfo: UnsafeMutablePointer<Void>)

    Objective C

    - (void)presentError:(NSError *)error modalForWindow:(NSWindow *)window delegate:(id)delegate didPresentSelector:(SEL)didPresentSelector contextInfo:(void *)contextInfo

    Обсуждение

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

    • - (void)didPresentErrorWithRecovery:(BOOL)didRecover contextInfo:(void *)contextInfo;

    Значение по умолчанию NSDocumentController реализация этого метода эквивалентна тому из NSResponder при обработке объекта приложения как следующего респондента и передаче ошибочных презентационных сообщений ему. (Значение по умолчанию NSDocument реализация этого метода обрабатывает совместно используемое NSDocumentController экземпляр как следующий респондент и передает эти сообщения к нему.)

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – willPresentError:
    – presentError:

  • willPresentError (_:) - willPresentError:

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

    Объявление

    Swift

    func willPresentError(_ error: NSError) -> NSError

    Objective C

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – presentError:
    – presentError:modalForWindow:delegate:didPresentSelector:contextInfo:

Устаревшие методы
  • documentForFileName: - documentForFileName: (OS X v10.4)

    Возвращает объект документа для файла, в котором хранятся данные документа.

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

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

    Объявление

    Objective C

    - (id)documentForFileName:(NSString *)fileName

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • fileExtensionsFromType: - fileExtensionsFromType: (OS X v10.5)

    Возвращает допустимые расширения файла для данного типа документа.

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

    Используйте NSDocument метод fileNameExtensionForType:saveOperation: вместо этого.

    Объявление

    Objective C

    - (NSArray *)fileExtensionsFromType:(NSString *)documentTypeName

    Параметры

    documentTypeName

    Имя типа документа, указанного CFBundleTypeName в приложении Info.plist файл.

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

    Допустимые расширения файла (как NSString объекты) для documentTypeName.

    Обсуждение

    Расширения типа указаны CFBundleTypeExtensions массив для поданного типа Info.plist файл.

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • fileNamesFromRunningOpenPanel - fileNamesFromRunningOpenPanel (OS X v10.4)

    Возвращает выбор файлов, выбранных пользователем в панели Open.

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

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

    Объявление

    Objective C

    - (NSArray *)fileNamesFromRunningOpenPanel

    Обсуждение

    Каждый файл в возвращенном NSArray полностью определенный путь к расположению файла в файловой системе. Этим методом вызывают openDocument:, и это вызывает runModalOpenPanel:forTypes: после инициализации панели Open (который включает получение начального каталога с currentDirectory). Возвраты nil если пользователь отменяет панель Open или не делает выбора.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • makeUntitledDocumentOfType: - makeUntitledDocumentOfType: (OS X v10.4)

    Создает и возвращает объект документа для типа документа.

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

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

    Объявление

    Objective C

    - (id)makeUntitledDocumentOfType:(NSString *)type

    Обсуждение

    Создает и возвращается NSDocument объект для типа документа type. Возвращенный объект не сохраняется. Возвраты nil если NSDocument подкласс для type если объект не мог бы быть создан, не мог быть определен или. Это вызовы метода NSDocument init методом и вызывают openUntitledDocumentOfType:display:.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • makeDocumentWithContentsOfURL:ofType: - makeDocumentWithContentsOfURL:ofType: (OS X v10.4)

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

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

    Использовать makeDocumentWithContentsOfURL:ofType:error: вместо этого.

    Объявление

    Objective C

    - (id)makeDocumentWithContentsOfURL:(NSURL *)url ofType:(NSString *)type

    Обсуждение

    Создает и возвращается NSDocument объект для типа документа docType от содержания aURL. Возвращенный объект не сохраняется. Возвраты nil если NSDocument подкласс для docType если объект не мог бы быть создан, не мог быть определен или. Это вызовы метода NSDocument метод initWithContentsOfURL:ofType: и вызывают openDocumentWithContentsOfURL:display:.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • makeDocumentWithContentsOfFile:ofType: - makeDocumentWithContentsOfFile:ofType: (OS X v10.4)

    Создает и возвращает объект документа данного типа документа от содержания файла.

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

    Использовать makeDocumentWithContentsOfURL:ofType:error: вместо этого.

    Объявление

    Objective C

    - (id)makeDocumentWithContentsOfFile:(NSString *)fileName ofType:(NSString *)type

    Обсуждение

    Создает и возвращается NSDocument объект для типа документа docType от содержания файла fileName, который должен быть полностью определенным путем. Возвращенный объект не сохраняется. Возвраты nil если NSDocument подкласс для docType если объект не мог бы быть создан, не мог быть определен или. Это вызовы метода NSDocument метод initWithContentsOfFile:ofType: и вызывают openDocumentWithContentsOfFile:display:.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • openDocumentWithContentsOfFile:display: - openDocumentWithContentsOfFile:display: (OS X v10.4)

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

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

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

    Объявление

    Objective C

    - (id)openDocumentWithContentsOfFile:(NSString *)fileName display:(BOOL)display

    Обсуждение

    Возвраты NSDocument объект создается из содержания файла fileName (абсолютный путь) и дисплеи это, если flag YEStrue. Возвращенный объект не сохраняется, но добавляется к списку получателя управляемых документов. Возвраты nil если объект не мог бы быть создан, обычно потому что fileName не указывает на правильный файл или потому что существует нет NSDocument подкласс для типа документа (как обозначено расширением файла или типом файла HFS). Даже если flag YEStrue, документ не выведен на экран если shouldCreateUI возвраты NOfalse. Это вызовы метода makeDocumentWithContentsOfFile:ofType: получить создаваемый объект NSDocument. При переопределении этого метода реализация должна быть подготовлена обработать также YEStrue или NOfalse.

    Для обработки события Open Documents Apple встроенная обработка событий Apple Набора Приложения автоматически вызывает этот метод с путем к файлу для открытия и параметр дисплея.

    Вызванный с параметром дисплея YEStrue вместо NOfalse когда обрабатывается событие Print Documents Apple. Это, возможно, было обработано по-другому в версиях OS X до версии 10.3.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • openDocumentWithContentsOfURL:display: - openDocumentWithContentsOfURL:display: (OS X v10.4)

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

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

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

    Объявление

    Objective C

    - (id)openDocumentWithContentsOfURL:(NSURL *)url display:(BOOL)display

    Обсуждение

    Возвраты NSDocument объект, создаваемый из содержания aURL и дисплеи это, если flag YEStrue. Возвращенный объект не сохраняется, но добавляется к списку получателя управляемых документов. Возвраты nil если объект не мог бы быть создан, обычно потому что aURL не указывает на допустимое расположение или потому что существует нет NSDocument подкласс для типа документа. Даже если flag YEStrue, документ не выведен на экран если shouldCreateUI возвраты NOfalse. Это вызовы метода makeDocumentWithContentsOfURL:ofType: получить создаваемый NSDocument объект.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • openDocumentWithContentsOfURL:display:error: - openDocumentWithContentsOfURL:display:error: (OS X v10.7)

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

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

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

    Объявление

    Objective C

    - (id)openDocumentWithContentsOfURL:(NSURL *)url display:(BOOL)displayDocument error:(NSError **)outError

    Обсуждение

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

    Реализация по умолчанию этого метода проверяет, чтобы видеть, открыт ли документ уже согласно documentForURL:, и если это не открыто, определяет тип документа, вызовов makeDocumentWithContentsOfURL:ofType:error: для инстанцирования его, затем вызывает addDocument: записывать его открытие, и отправляет документ makeWindowControllers и showWindows сообщения, если displayDocument YEStrue. Если документ уже открыт, он просто отправляется a showWindows сообщение, если displayDocument YEStrue.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • openUntitledDocumentOfType:display: - openUntitledDocumentOfType:display: (OS X v10.4)

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

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

    Использовать openUntitledDocumentAndDisplay:error: с defaultType вместо этого.

    Объявление

    Objective C

    - (id)openUntitledDocumentOfType:(NSString *)type display:(BOOL)display

    Обсуждение

    Возвраты NSDocument объект, который инстанцируют от NSDocument подкласс требуется типом документа docType и дисплеи это, если flag YEStrue. Возвращенный объект не сохраняется, но добавляется к списку получателя управляемых документов. Возвраты nil если объект не мог бы быть создан, обычно потому что нет NSDocument подкласс мог быть найден для docType. Даже если flag YEStrue, документ не выведен на экран если shouldCreateUI возвраты NOfalse. Это вызовы метода makeUntitledDocumentOfType: получить создаваемый NSDocument объект.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • reopenDocumentForURL:withContentsOfURL:error: - reopenDocumentForURL:withContentsOfURL:error: (OS X v10.7)

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

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

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

    Объявление

    Objective C

    - (BOOL)reopenDocumentForURL:(NSURL *)url withContentsOfURL:(NSURL *)contentsURL error:(NSError **)outError

    Обсуждение

    Документ расположен absoluteDocumentURL и содержание читается из absoluteDocumentContentsURL. Если не успешный, возвраты метода NOfalse после установки outError указать на NSError объект, инкапсулирующий причину, почему не мог быть вновь открыт документ.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • setShouldCreateUI: - setShouldCreateUI: (OS X v10.4)

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

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

    Используйте параметр дисплея openUntitledDocumentAndDisplay:error: или openDocumentWithContentsOfURL:display:completionHandler: вместо этого.

    Объявление

    Objective C

    - (void)setShouldCreateUI:(BOOL)flag

    Обсуждение

    Наборы, ли контроллеры окна (NSWindowController экземпляры) документа должен быть создан, когда создается документ. Когда контроллер окна создается, он загружает файл пера, содержащий окно, которым он управляет. Часто flag установлен в NOfalse для сценариев или поиска операций, включающих данные документа.

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • shouldCreateUI - shouldCreateUI (OS X v10.4)

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

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

    Используйте display параметр openUntitledDocumentAndDisplay:error: или openDocumentWithContentsOfURL:display:completionHandler: вместо этого.

    Объявление

    Objective C

    - (BOOL)shouldCreateUI

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

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

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

    Objective C

    @import AppKit;

    Доступность

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

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

  • typeFromFileExtension: - typeFromFileExtension: (OS X v10.5)

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

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

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

    Объявление

    Objective C

    - (NSString *)typeFromFileExtension:(NSString *)fileNameExtensionOrHFSFileType

    Обсуждение

    fileExtensionOrHFSFileType параметр может также быть закодированным типом файла HFS, а также расширением файла.

    Этот метод только работает, когда передано расширение файла, используемое в a CFBundleDocumentTypes запись, не имеющая LSItemContentTypes подзапись.

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

    Objective C

    @import AppKit;

    Доступность

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

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