NSBundle

Набор Приложения расширяет поведение платформы Основы NSBundle класс для поддержки загрузки определенных типов ресурсов.

NSBundle дополнения добавляют поддержку следующих задач:

Загрузка файлов пера
Определение местоположения изображения и звуковых ресурсов
Доступ к контексту помогает от a Help.plist файл

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

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

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Загрузка файлов пера


    
    loadNibFile:externalNameTable:withZone:
    + loadNibFile:externalNameTable:withZone:

(OS X v10.8)

Разархивировал содержание файла пера и соединяет их с объектами в Вашей программе.

Объявление

Objective C

+ (BOOL)loadNibFile:(NSString *)fileName externalNameTable:(NSDictionary *)context withZone:(NSZone *)zone

Параметры

`fileName`	Расположение файла пера, указанного как абсолютный путь в файловой системе.
`context`	Таблица имени, ключи которой идентифицируют объекты, связанные с Вашей программой или файлом пера. Недавно разархивированные объекты от файла пера используют эту таблицу для соединения с объектами в программе. Например, файл пера использует объект, связанный с `NSNibOwner` постоянный как объект владения файла пера. Если Вы связываете пустое `NSMutableArray` объект с `NSNibTopLevelObjects` постоянный, на выводе, массив содержит объекты верхнего уровня от файла пера. Для описаний этих констант см. Ссылку класса NSNib.
`zone`	Зона памяти, в которой можно выделить объекты файла пера.

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

YEStrue если файл пера был загружен успешно; иначе, NOfalse.

Обсуждение

Этот метод объявляется в NSNibLoading.h.

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

Objective C

@import AppKit;

Доступность

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

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


    
    loadNibNamed:owner:
    + loadNibNamed:owner:

(OS X v10.8)

Разархивировал содержание файла пера и соединяет их с определенным объектом владельца.

Объявление

Objective C

+ (BOOL)loadNibNamed:(NSString *)aNibName owner:(id)owner

Параметры

`aNibName`	Имя файла пера, который не должен включать `.nib` расширение. Имя файла не должно включать информацию о пути. Объект в `owner` параметр определяет расположение, в котором можно искать файл пера.
`owner`	Объект присвоиться как Владелец Файла пера. Если класс этого объекта имеет связанный пакет, тот пакет ищется указанный файл пера; иначе, этот метод смотрит в основном пакете.

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

YEStrue если файл пера был загружен успешно; иначе, NOfalse.

Обсуждение

Этот метод объявляется в NSNibLoading.h.

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

Objective C

@import AppKit;

Доступность

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

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

См. также

bundleForClass: (NSBundle)


    
    loadNibFile:externalNameTable:withZone:
    - loadNibFile:externalNameTable:withZone:

(OS X v10.8)

Разархивировал содержание файла пера, расположенного в пакете получателя.

Объявление

Objective C

- (BOOL)loadNibFile:(NSString *)fileName externalNameTable:(NSDictionary *)context withZone:(NSZone *)zone

Параметры

`fileName`	Имя файла пера, который не должен включать `.nib` расширение.
`context`	Таблица имени, ключи которой идентифицируют объекты, связанные с Вашей программой или файлом пера. Недавно разархивированные объекты от файла пера используют эту таблицу для соединения с объектами в программе. Например, файл пера использует объект, связанный с `NSNibOwner` постоянный как объект владения файла пера. Если Вы связываете пустое `NSMutableArray` объект с `NSNibTopLevelObjects` постоянный, на выводе, массив содержит объекты верхнего уровня от файла пера. Для описаний этих констант см. Ссылку класса NSNib.
`zone`	Зона памяти, в которой можно выделить объекты файла пера.

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

YEStrue если файл пера был загружен успешно; иначе, NOfalse.

Обсуждение

Этот метод ищет специфичный для языка проект (.lproj) каталоги для указанного файла пера. Если файл не там, он ищет пакет Resources каталог для нелокализованной версии файла.

Этот метод объявляется в NSNibLoading.h.

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

Objective C

@import AppKit;

Доступность

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

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


    
    loadNibNamed (_: owner:topLevelObjects:)
    - loadNibNamed:owner:topLevelObjects:

Загружает перо из пакета с указанным именем файла и владельцем.

Объявление

Swift

func loadNibNamed(_ nibName: String, owner owner: AnyObject!, topLevelObjects topLevelObjects: AutoreleasingUnsafeMutablePointer<NSArray?>) -> Bool

Objective C

- (BOOL)loadNibNamed:(NSString *)nibName owner:(id)owner topLevelObjects:(NSArray **)topLevelObjects

Параметры

`nibName`	Имя пера.
`owner`	Объект, который будет владельцем пера.
`topLevelObjects`	Это параметром ссылки заполняется с объектами верхнего уровня пера.

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

YEStrue если файл пера был загружен успешно; иначе, NOfalse.

Обсуждение

В отличие от устаревших методов, объекты придерживаются стандартных правил управления памятью какао; необходимо сохранить сильную ссылку им при помощи IBOutlets или содержания ссылки на массив, чтобы препятствовать тому, чтобы было освобождено содержание пера.

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

Для получения дополнительной информации о Перьях см. Ссылку класса NSNib.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    URLForImageResource (_:)
    - URLForImageResource:

Возвращает расположение указанного ресурса изображения как NSURL.

Объявление

Swift

func URLForImageResource(_ name: String) -> NSURL?

Objective C

- (NSURL *)URLForImageResource:(NSString *)name

Параметры


      name

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

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

NSURL для файла ресурсов или nil если не был найден файл.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

– pathForImageResource:


    
    pathForImageResource (_:)
    - pathForImageResource:

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

Объявление

Swift

func pathForImageResource(_ name: String) -> String?

Objective C

- (NSString *)pathForImageResource:(NSString *)name

Параметры


      name

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

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

Абсолютный путь файла ресурсов или nil если не найден файл.

Обсуждение

Ресурсы изображения являются теми файлами в пакете, распознанными NSImage класс, включая тех, которые могут быть преобразованы с помощью Изображения платформа IO.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

pathForResource:ofType: (NSBundle)
– URLForImageResource:


    
    imageForResource (_:)
    - imageForResource:

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

Объявление

Swift

func imageForResource(_ name: String) -> NSImage?

Objective C

- (NSImage *)imageForResource:(NSString *)name

Параметры


      name

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

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

NSImage объект связался с указанным именем, или nil если не найден никакой файл.

Обсуждение

Этот метод размещает соглашения о присвоении имен Apple для версий с высокой разрешающей способностью изображения. Например, если Ваш пакет содержит названные файлы button.png, button@2x.png, и button.pdf тогда imageForResource:@"button" возвраты NSImage объект, поддержанный всеми тремя файлами. Каждый раз NSImage объект нарисован, он выбирает представление лучше всего для контекста получения.

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

Этот метод не ищет изображения на основе setName: или получите именованные образы системы. Использовать imageNamed: с этой целью.

Этот метод не кэширует свои результаты поиска.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

imageNamed: (NSImage)

Доступ к справке контекста


    
    contextHelpForKey (_:)
    - contextHelpForKey:

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

Объявление

Swift

func contextHelpForKey(_ key: String) -> NSAttributedString?

Objective C

- (NSAttributedString *)contextHelpForKey:(NSString *)key

Параметры

key

Ключ в Вашем приложении Help.plist файл, идентифицирующий контекстно-зависимую справку к возврату.

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

Строка справки или nil если приложение не имеет a Help.plist файл или файл не содержат запись для указанного key.

Обсуждение

Когда Вы создаете свое приложение, можно объединить многократные основанные на RTF файлы справки вместе с помощью /usr/bin/compileHelp инструмент, тогда упаковывающий Вашу информацию о файле справки в названный список свойств Help.plist. После размещения этого файла списка свойств в Вашем комплекте приложений можно использовать этот метод для извлечения справочной информации контекста из него. Для поиска определенной записи Вы указываете имя исходного файла справки RTF в key параметр этого метода. Например, если Ваш проект приложения содержит названный файл справки Copy.rtf, Вы получили бы текст от этого файла путем передачи значения @"Copy.rtf" к key параметр.

Этот метод объявляется в NSHelpManager.h.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

contextHelpForObject: (NSHelpManager)

Определение местоположения звуковых ресурсов


    
    pathForSoundResource (_:)
    - pathForSoundResource:

Возвращает расположение указанного звукового файла ресурсов.

Объявление

Swift

func pathForSoundResource(_ name: String) -> String?

Objective C

- (NSString *)pathForSoundResource:(NSString *)name

Параметры


      name

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

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

Абсолютный путь файла ресурсов или nil если не был найден файл.

Обсуждение

Звуковые ресурсы являются теми файлами в пакете, распознанными NSSound класс. Типы звуковых файлов могут быть определены путем вызова soundUnfilteredFileTypes метод NSSound.

Этот метод объявляется в NSSound.h.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

См. также

pathForResource:ofType: (NSBundle)