NSAttributedString

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

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

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 6.0 и позже.

Платформа UIKit добавляет методы к NSAttributedString поддерживать получение стилизованных строк и вычислить размер и метрики строки до получения. Ни один из этих методов не влияет на содержание самого объекта, только как он нарисован на экране.

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

Можно использовать методы, описанные в этом расширении класса от вторичных потоков в приложении и не только от основного потока. Однако, если Вы используете какой-либо из методов, поддерживающих NSStringDrawingContext объект, Вы не должны совместно использовать контексты через очереди отгрузки или потоки.

Создание приписанной строки

init (присоединение:) + attributedStringWithAttachment:

Создает приписанную строку с присоединением.

Объявление

Swift

init(attachment attachment: NSTextAttachment) -> NSAttributedString

Objective C

+ (NSAttributedString *)attributedStringWithAttachment:(NSTextAttachment *)attachment

Параметры

attachment

Присоединение.

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

Приписанная строка, содержащая присоединение.

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.


    
    init (data:options:documentAttributes:error:)
    - initWithData:options:documentAttributes:error:

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

Объявление

Swift

init?(data data: NSData, options options: [NSObject : AnyObject]?, documentAttributes dict: AutoreleasingUnsafeMutablePointer<NSDictionary?>, error error: NSErrorPointer)

Objective C

- (instancetype)initWithData:(NSData *)data options:(NSDictionary *)options documentAttributes:(NSDictionary **)dict error:(NSError **)error

Параметры

`data`	Данные, из которых можно создать строку.
`options`	Атрибуты документа для интерпретации содержания документа. `NSDocumentTypeDocumentAttribute`, `NSCharacterEncodingDocumentAttribute`, и `NSDefaultAttributesDocumentAttribute` поддерживаемые функциональные клавиши. Если не указанный, метод исследует данные, чтобы попытаться определить надлежащие атрибуты.
`dict`	Если не -`NULL`, возвращает словарь с различными атрибутами всего документа, доступными через ключи атрибута документа.
`error`	В - переменная, содержащая ошибку, с которой встречаются, если таковые имеются.

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

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

Обсуждение

Средство импорта HTML нельзя вызвать от фонового потока (т.е. options словарь включает NSDocumentTypeDocumentAttribute со значением NSHTMLTextDocumentType). Это попытается синхронизироваться с основным потоком, перестать работать и испытать таймаут. Вызов его от основных работ потока (но может все еще испытать таймаут, если HTML содержит ссылки на внешние ресурсы, которых нужно избежать любой ценой). Механизм импорта HTML предназначается для реализации чего-то как скидка с цены (т.е. стили текста, цвета, и т.д.), не для общего импорта HTML.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.


    
    init (fileURL:options:documentAttributes:error:)
    - initWithFileURL:options:documentAttributes:error:

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

Объявление

Swift

init?(fileURL url: NSURL!, options options: [NSObject : AnyObject]!, documentAttributes dict: AutoreleasingUnsafeMutablePointer<NSDictionary?>, error error: NSErrorPointer)

Objective C

- (instancetype)initWithFileURL:(NSURL *)url options:(NSDictionary *)options documentAttributes:(NSDictionary **)dict error:(NSError **)error

Параметры

`url`	`NSURL` объект, указывающий документ загрузке.
`options`	Атрибуты документа для интерпретации содержания документа. `NSDocumentTypeDocumentAttribute`, `NSCharacterEncodingDocumentAttribute`, и `NSDefaultAttributesDocumentAttribute` поддерживаемые функциональные клавиши. Если не указанный, метод исследует данные, чтобы попытаться определить надлежащие атрибуты.
`dict`	Если не -`NULL`, возвращает словарь с различными атрибутами всего документа, доступными через ключи атрибута документа.
`error`	В - переменная, содержащая ошибку, с которой встречаются, если таковые имеются.

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

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

Обсуждение

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

Рисование строки


    
    drawAtPoint (_:)
    - drawAtPoint:

Рисует приписанную строку, запускающуюся в указанной точке в текущем графическом контексте.

Объявление

Swift

func drawAtPoint(_ point: CGPoint)

Objective C

- (void)drawAtPoint:(CGPoint)point

Параметры


      point

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.

drawInRect (_:) - drawInRect:

Рисует приписанную строку в указанном ограничительном прямоугольнике в текущем графическом контексте.

Объявление

Swift

func drawInRect(_ rect: CGRect)

Objective C

- (void)drawInRect:(CGRect)rect

Параметры

rect

Ограничительный прямоугольник, в котором можно нарисовать строку.

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.


    
    drawWithRect (_: options:context:)
    - drawWithRect:options:context:

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

Объявление

Swift

func drawWithRect(_ rect: CGRect, options options: NSStringDrawingOptions, context context: NSStringDrawingContext?)

Objective C

- (void)drawWithRect:(CGRect)rect options:(NSStringDrawingOptions)options context:(NSStringDrawingContext *)context

Параметры

`rect`	Ограничительный прямоугольник, в котором можно нарисовать строку.
`options`	Дополнительные опции получения примениться к строке во время рендеринга. Для списка возможных значений посмотрите `“NSStringDrawingOptions”`.
`context`	Объект контекста с информацией о том, как скорректировать шрифт отслеживающая и масштабирующаяся информация. По возврату указанный объект содержит информацию о фактических значениях, используемых для рендеринга строки. Этот параметр может быть `nil`.

Обсуждение

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

Если NSStringDrawingUsesLineFragmentOrigin не указан в options, источник прямоугольника является базовой линией единственной строки. Текст будет выведен на экран выше прямоугольника и не в нем. Например, если Вы укажете прямоугольник, запускающийся в 0,0, и нарисуете 'сочетавшую' строку, то только подстрочные элементы ‘j’ и ‘p’ будут замечены. Остальная часть текста будет на главном краю прямоугольника.

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

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.

Получение метрик для строки

размер () - размер

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

Объявление

Swift

func size() -> CGSize

Objective C

- (CGSize)size

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

Минимальный размер, требуемый нарисовать все содержание строки.

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.


    
    boundingRectWithSize (_: options:context:)
    - boundingRectWithSize:options:context:

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

Объявление

Swift

func boundingRectWithSize(_ size: CGSize, options options: NSStringDrawingOptions, context context: NSStringDrawingContext?) -> CGRect

Objective C

- (CGRect)boundingRectWithSize:(CGSize)size options:(NSStringDrawingOptions)options context:(NSStringDrawingContext *)context

Параметры

`size`	Ограничения ширины и высоты для применения при вычислениях ограничительного прямоугольника строки.
`options`	Дополнительные опции получения примениться к строке во время рендеринга. Для списка возможных значений посмотрите `“NSStringDrawingOptions”`.
`context`	Объект контекста с информацией о том, как скорректировать шрифт отслеживающая и масштабирующаяся информация. По возврату указанный объект содержит информацию о фактических значениях, используемых для рендеринга строки. Этот параметр может быть `nil`.

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

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

Обсуждение

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

В iOS 7 и позже, этот метод возвращает дробные размеры (в size компонент возвращенного CGRect); для использования возвращенного размера для калибровки представлений необходимо использовать, повышают его значение до самого близкого более высокого целого числа с помощью ceil функция.

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

Для вычисления ограничительного прямоугольника этот метод использует базовый источник по умолчанию, таким образом, это ведет себя как одна строка. Для рендеринга строки в многократных строках указать NSStringDrawingUsesLineFragmentOrigin в options.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.

Генерация данных


    
    dataFromRange (_: documentAttributes:error:)
    - dataFromRange:documentAttributes:error:

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

Объявление

Swift

func dataFromRange(_ range: NSRange, documentAttributes dict: [NSObject : AnyObject], error error: NSErrorPointer) -> NSData?

Objective C

- (NSData *)dataFromRange:(NSRange)range documentAttributes:(NSDictionary *)dict error:(NSError **)error

Параметры

`range`	Диапазон.
`dict`	Требуемый словарь, указывающий атрибуты документа. Словарь содержит значения от Типов документов и должен, по крайней мере, содержать `NSDocumentTypeDocumentAttribute`.
`error`	В - переменная, содержащая ошибку, с которой встречаются, если таковые имеются.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

См. также

– fileWrapperFromRange:documentAttributes:error:


    
    fileWrapperFromRange (_: documentAttributes:error:)
    - fileWrapperFromRange:documentAttributes:error:

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

Объявление

Swift

func fileWrapperFromRange(_ range: NSRange, documentAttributes dict: [NSObject : AnyObject], error error: NSErrorPointer) -> NSFileWrapper?

Objective C

- (NSFileWrapper *)fileWrapperFromRange:(NSRange)range documentAttributes:(NSDictionary *)dict error:(NSError **)error

Параметры

`range`	Диапазон.
`dict`	Требуемый словарь, указывающий атрибуты документа. Словарь содержит значения от Типов документов и должен, по крайней мере, содержать `NSDocumentTypeDocumentAttribute`.
`error`	В - переменная, содержащая ошибку, с которой встречаются, если таковые имеются.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.

См. также

– dataFromRange:documentAttributes:error:

Константы

Строковые опции рисования
Опции для настройки путем строк нарисованы.

Объявление

Swift

struct NSStringDrawingOptions : RawOptionSetType { init(_ rawValue: Int) init(rawValue rawValue: Int) static var TruncatesLastVisibleLine: NSStringDrawingOptions { get } static var UsesLineFragmentOrigin: NSStringDrawingOptions { get } static var UsesFontLeading: NSStringDrawingOptions { get } static var UsesDeviceMetrics: NSStringDrawingOptions { get } }

Objective C

enum { NSStringDrawingTruncatesLastVisibleLine = 1 << 5, NSStringDrawingUsesLineFragmentOrigin = 1 << 0, NSStringDrawingUsesFontLeading = 1 << 1, NSStringDrawingUsesDeviceMetrics = 1 << 3, }; typedef NSInteger NSStringDrawingOptions;

Константы
- TruncatesLastVisibleLine
  
  NSStringDrawingTruncatesLastVisibleLine
  
  Усеките и добавьте символ замещающего знака к последней видимой строке, если текст не вписывается в указанные границы. Эта опция проигнорирована если NSStringDrawingUsesLineFragmentOrigin опция также не указана.
  
  Доступный в iOS 6.0 и позже.
- UsesLineFragmentOrigin
  
  NSStringDrawingUsesLineFragmentOrigin
  
  Когда рисование строки является источником фрагмента строки а не базовым источником, источник указал.
  
  Доступный в iOS 6.0 и позже.
- UsesFontLeading
  
  NSStringDrawingUsesFontLeading
  
  Используйте шрифт ведущая информация для вычисления высот строки.
  
  Доступный в iOS 6.0 и позже.
- UsesDeviceMetrics
  
  NSStringDrawingUsesDeviceMetrics
  
  Используйте границы глифа изображения (вместо типографских границ) когда вычислительное расположение.
  
  Доступный в iOS 6.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 6.0 и позже.
Подчеркивание и перечеркнутые атрибуты стиля
Константы для указания обоих NSUnderlineStyleAttributeName и NSStrikethroughStyleAttributeName атрибуты приписанной строки.

Объявление

Swift

enum NSUnderlineStyle : Int { case StyleNone case StyleSingle case StyleThick case StyleDouble case PatternDot case PatternDash case PatternDashDot case PatternDashDotDot case ByWord }

Objective C

typedef enum : NSInteger { NSUnderlineStyleNone = 0x00, NSUnderlineStyleSingle = 0x01, NSUnderlineStyleThick = 0x02, NSUnderlineStyleDouble = 0x09, NSUnderlinePatternSolid = 0x0000, NSUnderlinePatternDot = 0x0100, NSUnderlinePatternDash = 0x0200, NSUnderlinePatternDashDot = 0x0300, NSUnderlinePatternDashDotDot = 0x0400, NSUnderlineByWord = 0x8000 } NSUnderlineStyle;

Константы
- StyleNone
  
  NSUnderlineStyleNone
  
  Не чертить линию.
  
  Доступный в iOS 6.0 и позже.
- StyleSingle
  
  NSUnderlineStyleSingle
  
  Нарисуйте одну строку.
  
  Доступный в iOS 6.0 и позже.
- StyleThick
  
  NSUnderlineStyleThick
  
  Проведите толстую линию.
  
  Доступный в iOS 7.0 и позже.
- StyleDouble
  
  NSUnderlineStyleDouble
  
  Проведите двойную линию.
  
  Доступный в iOS 7.0 и позже.
- NSUnderlinePatternSolid
  
  Проведите сплошную линию.
  
  Доступный в iOS 7.0 и позже.
- PatternDot
  
  NSUnderlinePatternDot
  
  Чертите линию точек.
  
  Доступный в iOS 7.0 и позже.
- PatternDash
  
  NSUnderlinePatternDash
  
  Чертите линию тире.
  
  Доступный в iOS 7.0 и позже.
- PatternDashDot
  
  NSUnderlinePatternDashDot
  
  Чертите линию чередования тире и точек.
  
  Доступный в iOS 7.0 и позже.
- PatternDashDotDot
  
  NSUnderlinePatternDashDotDot
  
  Чертите линию чередования тире и двух точек.
  
  Доступный в iOS 7.0 и позже.
- ByWord
  
  NSUnderlineByWord
  
  Разграничьте только внизу или через слова, не пробел.
  
  Доступный в iOS 7.0 и позже.
Обсуждение

Стиль, образец, и дополнительно маска поговорки являются OR'd вместе для создания значения для NSUnderlineStyleAttributeName и NSStrikethroughStyleAttributeName.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.


      
      Символьные атрибуты

Атрибуты, что можно примениться к тексту в приписанной строке.

Объявление

Swift

let NSFontAttributeName: String let NSParagraphStyleAttributeName: String let NSForegroundColorAttributeName: String let NSBackgroundColorAttributeName: String let NSLigatureAttributeName: String let NSKernAttributeName: String let NSStrikethroughStyleAttributeName: String let NSUnderlineStyleAttributeName: String let NSStrokeColorAttributeName: String let NSStrokeWidthAttributeName: String let NSShadowAttributeName: String let NSTextEffectAttributeName: String let NSAttachmentAttributeName: String let NSLinkAttributeName: String let NSBaselineOffsetAttributeName: String let NSUnderlineColorAttributeName: String let NSStrikethroughColorAttributeName: String let NSObliquenessAttributeName: String let NSExpansionAttributeName: String let NSWritingDirectionAttributeName: String let NSVerticalGlyphFormAttributeName: String

Objective C

NSString *const NSFontAttributeName; NSString *const NSParagraphStyleAttributeName; NSString *const NSForegroundColorAttributeName; NSString *const NSBackgroundColorAttributeName; NSString *const NSLigatureAttributeName; NSString *const NSKernAttributeName; NSString *const NSStrikethroughStyleAttributeName; NSString *const NSUnderlineStyleAttributeName; NSString *const NSStrokeColorAttributeName; NSString *const NSStrokeWidthAttributeName; NSString *const NSShadowAttributeName; NSString *const NSTextEffectAttributeName; NSString *const NSAttachmentAttributeName; NSString *const NSLinkAttributeName; NSString *const NSBaselineOffsetAttributeName; NSString *const NSUnderlineColorAttributeName; NSString *const NSStrikethroughColorAttributeName; NSString *const NSObliquenessAttributeName; NSString *const NSExpansionAttributeName; NSString *const NSWritingDirectionAttributeName; NSString *const NSVerticalGlyphFormAttributeName;

Константы

NSFontAttributeName

Значение этого атрибута является a UIFont объект. Используйте этот атрибут для изменения шрифта для диапазона текста. Если Вы не указываете этот атрибут, строка использует Helvetica с 12 точками (Neue) шрифт по умолчанию.

Доступный в iOS 6.0 и позже.
NSParagraphStyleAttributeName

Значение этого атрибута NSParagraphStyle объект. Используйте этот атрибут для применения многократных атрибутов к диапазону текста. Если Вы не указываете этот атрибут, строка использует атрибуты абзацев по умолчанию, как возвращено defaultParagraphStyle метод NSParagraphStyle.

Доступный в iOS 6.0 и позже.
NSForegroundColorAttributeName

Значение этого атрибута является a UIColor объект. Используйте этот атрибут для указания цвета текста во время рендеринга. Если Вы не указываете этот атрибут, текст представляется в черном цвете.

Доступный в iOS 6.0 и позже.
NSBackgroundColorAttributeName

Значение этого атрибута является a UIColor объект. Используйте этот атрибут для указания цвета фоновой области позади текста. Если Вы не указываете этот атрибут, никакой цвет фона не нарисован.

Доступный в iOS 6.0 и позже.
NSLigatureAttributeName

Значение этого атрибута NSNumber объект, содержащий целое число. Лигатуры заставляют определенные символьные комбинации быть представленными с помощью единственного пользовательского глифа, соответствующего тем символам. Значение 0 не указывает лигатур. Значение 1 указывает использование лигатур по умолчанию. Значение 2 указывает использование всех лигатур. Значение по умолчанию для этого атрибута 1. (Значение 2 не поддерживается на iOS.)

Доступный в iOS 6.0 и позже.
NSKernAttributeName

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

Доступный в iOS 6.0 и позже.
NSStrikethroughStyleAttributeName

Значение этого атрибута NSNumber объект, содержащий целое число. Это значение указывает, имеет ли текст строку через него и соответствует одной из констант, описанных в “Underline and Strikethrough Style Attributes”. Значение по умолчанию для этого атрибута NSUnderlineStyleNone.

Доступный в iOS 6.0 и позже.
NSUnderlineStyleAttributeName

Значение этого атрибута NSNumber объект, содержащий целое число. Это значение указывает, подчеркивается ли текст и соответствует одной из констант, описанных в “Underline and Strikethrough Style Attributes”. Значение по умолчанию для этого атрибута NSUnderlineStyleNone.

Доступный в iOS 6.0 и позже.
NSStrokeColorAttributeName

Значение этого параметра является a UIColor объект. Если это не определяется (который имеет место по умолчанию), это, как предполагается, совпадает со значением NSForegroundColorAttributeName; иначе, это описывает цвет контура. Для получения дополнительной информации посмотрите, что Получение приписало строки, и заполняющиеся и перечеркивающиеся.

Доступный в iOS 6.0 и позже.
NSStrokeWidthAttributeName

Значение этого атрибута NSNumber объект, содержащий значение с плавающей точкой. Это значение представляет сумму для изменения штриховой ширины и указано как процент размера точки шрифта. Указать 0 (значение по умолчанию) ни для каких дополнительных изменений. Укажите положительные значения для изменения одной только штриховой ширины. Укажите отрицательные величины, чтобы перечеркнуть и заполнить текст. Например, типичное значение для обрисованного в общих чертах текста было бы 3.0.

Доступный в iOS 6.0 и позже.
NSShadowAttributeName

Значение этого атрибута NSShadow объект. Значение по умолчанию этого свойства nil.

Доступный в iOS 6.0 и позже.
NSTextEffectAttributeName

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

Доступный в iOS 7.0 и позже.
NSAttachmentAttributeName

Значение этого атрибута NSTextAttachment объект. Значение по умолчанию этого свойства nil, указание никакого присоединения.

Доступный в iOS 7.0 и позже.
NSLinkAttributeName

Значение этого атрибута и NSURL (предпочтенный) объект или NSString объект. Значение по умолчанию этого свойства nil, указание никакой ссылки.

Доступный в iOS 7.0 и позже.
NSBaselineOffsetAttributeName

Значение этого атрибута NSNumber объект, содержащий значение с плавающей точкой, указывающее смещение символа от базовой линии, в точках. Значение по умолчанию 0.

Доступный в iOS 7.0 и позже.
NSUnderlineColorAttributeName

Значение этого атрибута является a UIColor объект. Значение по умолчанию nil, указание того же как основной цвет.

Доступный в iOS 7.0 и позже.
NSStrikethroughColorAttributeName

Значение этого атрибута является a UIColor объект. Значение по умолчанию nil, указание того же как основной цвет.

Доступный в iOS 7.0 и позже.
NSObliquenessAttributeName

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

Доступный в iOS 7.0 и позже.
NSExpansionAttributeName

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

Доступный в iOS 7.0 и позже.

NSWritingDirectionAttributeName

Значение этого атрибута NSArray из NSNumber объекты, представляющие вложенные уровни записи переопределений направления, в порядке от наиболее удаленного до самого внутреннего.

Этот атрибут обеспечивает средние значения для переопределения алгоритма двунаправленного текста по умолчанию, эквивалентного использованию Unicode bidi управляющие символы LRE, RLE, LRO, или RLO соединенный с PDF, но как высокоуровневый атрибут. (См. Приложение № 9 Стандарта Unicode для получения информации о Unicode bidi форматирующие коды.) NSWritingDirectionAttributeName постоянный атрибут символьного уровня, обеспечивающий высокоуровневую альтернативу включению явных двунаправленных управляющих символов в тексте. Это NSAttributedString эквивалентный из использования разметки HTML bdo элемент с dir атрибут.

Значения NSNumber объекты должны быть 0, 1, 2, или 3, для LRE, RLE, LRO, или RLO соответственно, и комбинации NSWritingDirectionLeftToRight и NSWritingDirectionRightToLeft с NSTextWritingDirectionEmbedding или NSTextWritingDirectionOverride, как показано в Значениях NSWritingDirectionAttributeName и эквивалентной разметки.

**Таблица 1Values** `NSWritingDirectionAttributeName` и эквивалентная разметка
Выстройте значения NSNumber	Управляющие символы Unicode	Запись констант направления
`0`	`LRE`	`NSWritingDirectionLeftToRight \| NSTextWritingDirectionEmbedding`
`1`	`RLE`	`NSWritingDirectionRightToLeft \| NSTextWritingDirectionEmbedding`
`2`	`LRO`	`NSWritingDirectionLeftToRight \| NSTextWritingDirectionOverride`
`3`	`RLO`	`NSWritingDirectionRightToLeft \| NSTextWritingDirectionOverride`

Доступный в iOS 7.0 и позже.

NSVerticalGlyphFormAttributeName

Значение этого атрибута NSNumber объект, содержащий целое число. Значение 0 указывает горизонтальный текст. Значение 1 указывает вертикальный текст. В iOS горизонтальный текст всегда используется и указание, что различное значение не определено.

Доступный в iOS 6.0 и позже.

Текст пишущий направление
Опции для указания текста, пишущий направление, используемое с NSWritingDirectionAttributeName.

Объявление

Swift

enum NSTextWritingDirection : Int { case Embedding case Override }

Objective C

typedef enum : NSInteger { NSTextWritingDirectionEmbedding = (0 << 1), NSTextWritingDirectionOverride = (1 << 1) } NSTextWritingDirection;

Константы
- Embedding
  
  NSTextWritingDirectionEmbedding
  
  Текст встраивается в текст с другим направлением записи. Например, английская котировка посреди арабского предложения могла быть отмечена как встраиваемый слева направо текст.
  
  Доступный в iOS 7.0 и позже.
- Override
  
  NSTextWritingDirectionOverride
  
  Позволяет символьным типам со свойственной направленностью быть переопределенными при необходимости для особых случаев, такой что касается номеров деталей, сделанных из смешанного английского, цифр и еврейских букв, которые будут записаны справа налево.
  
  Доступный в iOS 7.0 и позже.
Обсуждение

Можно использовать логическое OR оператор для объединения этих констант с NSWritingDirectionLeftToRight или NSWritingDirectionRightToLeft когда используется с NSWritingDirectionAttributeName указать управления форматированием, определенные Unicode Двунаправленный Алгоритм в Приложении № 9 Стандарта Unicode.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

Доступный в iOS 7.0 и позже.
Типы документов
Следующие значения могут быть возвращены для NSDocumentTypeDocumentAttribute введите словарь атрибутов документа.

Объявление

Swift

let NSPlainTextDocumentType: String let NSRTFTextDocumentType: String let NSRTFDTextDocumentType: String let NSHTMLTextDocumentType: String

Objective C

NSString *NSPlainTextDocumentType; NSString *NSRTFTextDocumentType; NSString *NSRTFDTextDocumentType; NSString *NSHTMLTextDocumentType;

Константы
- NSPlainTextDocumentType
  
  Документ простого текста.
  
  Доступный в iOS 7.0 и позже.
- NSRTFTextDocumentType
  
  Документ формата RTF.
  
  Доступный в iOS 7.0 и позже.
- NSRTFDTextDocumentType
  
  Формат RTF с присоединяемым документом.
  
  Доступный в iOS 7.0 и позже.
- NSHTMLTextDocumentType
  
  Язык разметки гипертекста (HTML) документ.
  
  Доступный в iOS 7.0 и позже.
Ключи для опций и словарей атрибутов документа
Эти ключи представляют в и свойства документа, используемые и чтением и методами записи.

Объявление

Swift

let NSDocumentTypeDocumentAttribute: String let NSCharacterEncodingDocumentAttribute: String let NSDefaultAttributesDocumentAttribute: String let NSPaperSizeDocumentAttribute: String let NSPaperMarginDocumentAttribute: String let NSViewSizeDocumentAttribute: String let NSViewZoomDocumentAttribute: String let NSViewModeDocumentAttribute: String let NSReadOnlyDocumentAttribute: String let NSBackgroundColorDocumentAttribute: String let NSHyphenationFactorDocumentAttribute: String let NSDefaultTabIntervalDocumentAttribute: String let NSTextLayoutSectionsAttribute: String

Objective C

NSString *const NSDocumentTypeDocumentAttribute; NSString *const NSCharacterEncodingDocumentAttribute; NSString *const NSDefaultAttributesDocumentAttribute; NSString *const NSPaperSizeDocumentAttribute; NSString *const NSPaperMarginDocumentAttribute; NSString *const NSViewSizeDocumentAttribute; NSString *const NSViewZoomDocumentAttribute; NSString *const NSViewModeDocumentAttribute; NSString *const NSReadOnlyDocumentAttribute; NSString *const NSBackgroundColorDocumentAttribute; NSString *const NSHyphenationFactorDocumentAttribute; NSString *const NSDefaultTabIntervalDocumentAttribute; NSString *const NSTextLayoutSectionsAttribute;

Константы
- NSDocumentTypeDocumentAttribute
  
  @"DocumentType", одни из типов документов объявляются в Типах документов. Для методов читателя этот ключ в опциях может указать тип документа для интерпретации содержания. По возврату атрибуты документа могут содержать этот ключ для указания, что фактический формат раньше читал содержание. Для методов записи этот ключ указывает формат для генерации данных.
  
  Доступный в iOS 7.0 и позже.
- NSCharacterEncodingDocumentAttribute
  
  @"CharacterEncoding", NSNumber содержа целочисленное указание NSStringEncoding для файла; значение по умолчанию для простого текста является кодировкой по умолчанию. Этот ключ в опциях может указать строковое кодирование для чтения данных. По возврату атрибуты документа могут содержать фактическое используемое кодирование. Для методов записи это значение используется для генерации данных простого текста.
  
  Доступный в iOS 7.0 и позже.
- NSDefaultAttributesDocumentAttribute
  
  @"DefaultAttributes", NSDictionary содержа атрибуты, которые будут применены к простым файлам. Используемый методами читателя. Этот ключ в опциях может указать, что атрибуты по умолчанию применились ко всему содержанию документа. По возврату атрибуты документа могут содержать этот ключ, указывающий фактические используемые атрибуты.
  
  Доступный в iOS 7.0 и позже.
- NSPaperSizeDocumentAttribute
  
  @"PaperSize", NSValue содержа CGSize (в точках).
  
  Доступный в iOS 7.0 и позже.
- NSPaperMarginDocumentAttribute
  
  @"PaperMargin", NSValue содержа UIEdgeInsets.
  
  Доступный в iOS 7.0 и позже.
- NSViewSizeDocumentAttribute
  
  @"ViewSize", NSValue содержа CGSize (в точках).
  
  Доступный в iOS 7.0 и позже.
- NSViewZoomDocumentAttribute
  
  @"ViewZoom", NSNumber содержа значение с плавающей точкой: 100 = 100%-е изменение масштаба.
  
  Доступный в iOS 7.0 и позже.
- NSViewModeDocumentAttribute
  
  @"ViewMode", NSNumber содержа целое число: 0 = нормальный; 1 = макет страницы.
  
  Доступный в iOS 7.0 и позже.
- NSReadOnlyDocumentAttribute
  
  @"ReadOnly", NSNumber содержа целое число: при без вести пропавших, 0 или отрицательный = не только для чтения; 1 или больше = только для чтения. Этот атрибут не имеет никакого отношения к защите файловой системы на файле; вместо этого, это указывает, как файл должен быть выведен на экран пользователю.
  
  Доступный в iOS 7.0 и позже.
- NSBackgroundColorDocumentAttribute
  
  @"BackgroundColor", UIColor представление цвета фона страницы всего документа.
  
  Доступный в iOS 7.0 и позже.
- NSHyphenationFactorDocumentAttribute
  
  @"HyphenationFactor", NSNumber содержа значение с плавающей точкой: 0 = прочь; 1 = полная расстановка переносов.
  
  Доступный в iOS 7.0 и позже.
- NSDefaultTabIntervalDocumentAttribute
  
  @"DefaultTabInterval", NSNumber содержа значение с плавающей точкой, представляющее интервал позиции табуляции по умолчанию всего документа, в точках.
  
  Доступный в iOS 7.0 и позже.
- NSTextLayoutSectionsAttribute
  
  NSArray содержа NSDictionary объекты, каждый словарь, описывающий раздел ориентации макета. Словарь может иметь два атрибута: NSTextLayoutSectionOrientation и NSTextLayoutSectionRange. Когда существует разрыв между разделами, он, как предполагается, имеет NSTextLayoutOrientationHorizontal.
  
  Доступный в iOS 7.0 и позже.
Текстовый атрибут разделов расположения
Эти константы используются NSTextLayoutSectionsAttribute.

Объявление

Swift

let NSTextLayoutSectionOrientation: String let NSTextLayoutSectionRange: String

Objective C

NSString *NSTextLayoutSectionOrientation; NSString *NSTextLayoutSectionRange;

Константы
- NSTextLayoutSectionOrientation
  
  NSNumber содержа NSTextLayoutOrientation значение. Значение по умолчанию NSTextLayoutOrientationHorizontal.
  
  Доступный в iOS 7.0 и позже.
- NSTextLayoutSectionRange
  
  NSValue содержа NSRange представление диапазона символов. Значение по умолчанию является диапазоном, покрывающим всю строку.
  
  Доступный в iOS 7.0 и позже.
Текстовый атрибут эффекта
Эта константа используется NSTextEffectAttributeName.

Объявление

Swift

let NSTextEffectLetterpressStyle: String

Objective C

NSString *const NSTextEffectLetterpressStyle;

Константы
- NSTextEffectLetterpressStyle
  
  Графические текстовые глифы предоставления эффекта появление печати высокой печати, в которой тип принужден к бумаге.
  
  Доступный в iOS 7.0 и позже.