Отформатированные документы и приписанные строки

Расширения Набора Приложения NSAttributedString добавьте поддержку чтения и записи текстовых команд форматирования и атрибутов документа для многих популярных языков разметки, включая следующее:

Эти форматы документов представлены значениями, возвращенными для NSDocumentTypeDocumentAttribute введите словарь атрибутов документа при чтении и записи текстовых документов. Для всех этих языков файлы, представляющие документы, включают обоих текст, который будет выведен на экран, и вкрапили команды форматирования. Программы, выводящие на экран документы, интерпретируют команды для форматирования текста. Форматирование команд или «тегов» представляет такие элементы форматирования как абзацы, заголовки, разрывы строки, изображения, гиперссылки, и т.д. Кроме того, некоторые команды представляют атрибуты всего документа, такие как формат бумаги, поля, цвет фона, и т.д.

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

Чтение отформатированных документов

Расширения Набора Приложения NSAttributedString включайте два метода общего назначения для создания приписанной строки путем загрузки текстовых документов в различных форматах. Формат документа указан в словаре опций, содержащем ключи, описанные в “функциональных клавишах для импорта документов” в дополнительной NSAttributedString AppKit Ссылке. Если NSDocumentTypeDocumentOption ключ указан с одним из значений, определенных для NSDocumentTypeDocumentAttribute, документ толкуется согласно указанному формату. Если NSDocumentTypeDocumentOption ключ не указан, общие методы исследуют документ и выполняют максимальные усилия для загрузки его с помощью надлежащего формата.

Эти два общих метода для чтения отформатированных документов:

initWithURL:options:documentAttributes:error:Инициализирует новый объект NSAttributedString от содержания данного URL.
initWithData:options:documentAttributes:error:Инициализирует и возвращает новый приписанный строковый объект из данных, содержавшихся в объекте определенных данных.

Расширения Набора Приложения NSAttributedString также определите много удобных методов специального назначения создать приписанную строку для различных общих типов документов. Кроме того, NSMutableAttributedString определяет следующие методы:

readFromURL:options:documentAttributes:Устанавливает содержание получателя от файла в URL.
readFromData:options:documentAttributes:Устанавливает содержание получателя от потока в данных.

Обработка атрибутов документа

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

Запись отформатированных документов

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

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

Эти два общих метода для записи отформатированных документов:

dataFromRange:documentAttributes:error:Возвращает объект данных, содержащий текстовый поток, соответствующий символам и атрибутам в данном диапазоне.
fileWrapperFromRange:documentAttributes:error:Возвращает объект NSFileWrapper, содержащий текстовый поток, соответствующий символам и атрибутам в данном диапазоне.

Использовать dataFromRange:documentAttributes:error: создать объект данных, который может быть записан в регулярный файл на диске. Использовать fileWrapperFromRange:documentAttributes:error: когда Вы хотите создать структуру каталогов на диске, таком как RTFD. Метод обертки файла возвращает обертку файла каталога для тех типов документов, для которых это подходяще; иначе это возвращает обертку файла регулярного файла.

Расширения Набора Приложения NSAttributedString также определите много удобных методов специального назначения произвести данные для записи различных общих типов документов.

Обработка присоединений

Присоединения, такие как встроенные изображения или файлы, представлены в приписанной строке и специальным символом и атрибутом. Символ идентифицируется глобальным именем NSAttachmentCharacter (U+FFFC, символ замены Unicode), и указывает присутствие присоединения в его расположении в строке. Атрибут, идентифицированный в строке названием атрибута NSAttachmentAttributeName, NSTextAttachment объект. NSTextAttachment когда строка нарисована, объект содержит данные для самого присоединения и изображения для отображения.

Можно использовать NSAttributedString метод attributedStringWithAttachment: метод класса создать присоединяемую строку, которую можно тогда добавить к непостоянному приписанному строковому использованию appendAttributedString: или insertAttributedString:atIndex:.