Базовая ссылка атрибутов текстовой строки

Этот справочный документ описывает атрибуты, на которые отвечает Базовый текст, когда атрибуты помещаются в объект CFAttributedString.

Константы

Строковые константы названия атрибута
Эти константы представляют строковые названия атрибута.

Объявление

Swift

let kCTCharacterShapeAttributeName: CFString! let kCTFontAttributeName: CFString! let kCTKernAttributeName: CFString! let kCTLigatureAttributeName: CFString! let kCTForegroundColorAttributeName: CFString! let kCTForegroundColorFromContextAttributeName: CFString! let kCTParagraphStyleAttributeName: CFString! let kCTStrokeWidthAttributeName: CFString! let kCTStrokeColorAttributeName: CFString! let kCTSuperscriptAttributeName: CFString! let kCTUnderlineColorAttributeName: CFString! let kCTUnderlineStyleAttributeName: CFString! let kCTVerticalFormsAttributeName: CFString! let kCTGlyphInfoAttributeName: CFString! let kCTRunDelegateAttributeName: CFString!

Objective C

const CFStringRef kCTCharacterShapeAttributeName; const CFStringRef kCTFontAttributeName; const CFStringRef kCTKernAttributeName; const CFStringRef kCTLigatureAttributeName; const CFStringRef kCTForegroundColorAttributeName; const CFStringRef kCTForegroundColorFromContextAttributeName; const CFStringRef kCTParagraphStyleAttributeName; const CFStringRef kCTStrokeWidthAttributeName; const CFStringRef kCTStrokeColorAttributeName; const CFStringRef kCTSuperscriptAttributeName; const CFStringRef kCTUnderlineColorAttributeName; const CFStringRef kCTUnderlineStyleAttributeName; const CFStringRef kCTVerticalFormsAttributeName; const CFStringRef kCTGlyphInfoAttributeName; const CFStringRef kCTRunDelegateAttributeName

Константы
- kCTCharacterShapeAttributeName
  
  kCTCharacterShapeAttributeName
  
  Выбор глифа средств управления. Значение должно быть a CFNumberRef объект. Значение по умолчанию является значением, 0 (отключенный). Ненулевое значение интерпретируется как Apple Type Services kCharacterShapeType селектор + 1 (см. <ATS/SFNTLayoutTypes.h> для селекторов). Например, значение атрибута 1 соответствует kTraditionalCharactersSelector.
  
  Доступный в OS X v10.5 и позже.
- kCTFontAttributeName
  
  kCTFontAttributeName
  
  Шрифт текста, к которому применяется этот атрибут. Значение, связанное с этим атрибутом, должно быть объектом CTFont. Значение по умолчанию является Helvetica 12.
  
  Доступный в OS X v10.5 и позже.
- kCTKernAttributeName
  
  kCTKernAttributeName
  
  Сумма для кернинга следующего символа. Значение, связанное с этим атрибутом, должно быть плаванием CFNumber. Значение по умолчанию является стандартным кернингом. Использующий кернинг атрибут указывает, сколько точек следующий символ должен быть смещен от его смещения по умолчанию, как определено шрифтом текущего символа в точках: положительный керн указывает сдвиг дальше от, и отрицательный керн указывает сдвиг ближе к текущему символу. Если этот атрибут не существует, стандартный кернинг используется. Если этот атрибут установлен в 0.0, никакой кернинг не сделан вообще.
  
  Доступный в OS X v10.5 и позже.
- kCTLigatureAttributeName
  
  kCTLigatureAttributeName
  
  Тип лигатур для использования. Значение, связанное с этим атрибутом, должно быть объектом CFNumber. Значение по умолчанию является целочисленным значением 1. Атрибут лигатуры определяет, какие виды лигатур должны использоваться при отображении строки. Значение 0 указывает, что только должны использоваться лигатуры, важные для надлежащего рендеринга текста. Значение 1 указывает, что стандартные лигатуры должны использоваться, и 2 указывает, что должны использоваться все доступные лигатуры. То, какие лигатуры являются стандартными, зависит от сценария и возможно шрифта. Арабский текст, например, требует лигатур для многих последовательностей символов, но имеет богатый набор дополнительных лигатур то объединение символы. Английский текст не имеет никаких существенных лигатур, и обычно имеет только две стандартных лигатуры, тех для «fi» и «fl» — всех других считают более усовершенствованными или необычными.
  
  Доступный в OS X v10.5 и позже.
- kCTForegroundColorAttributeName
  
  kCTForegroundColorAttributeName
  
  Основной цвет текста, к которому применяется этот атрибут. Значение, связанное с этим атрибутом, должно быть объектом CGColor. Значение по умолчанию является черным.
  
  Доступный в OS X v10.5 и позже.
- kCTForegroundColorFromContextAttributeName
  
  kCTForegroundColorFromContextAttributeName
  
  Выбирает основной цвет с помощью цвета заливки контекста. Значение должно быть a CFBooleanRef объект. Значение по умолчанию false. Причина это существует, состоит в том потому что NSAttributedString объектные значения по умолчанию к черному цвету, если не установлен никакой атрибут цвета. Это вынуждает Базовый текст выбрать цвет в контексте. Этот атрибут позволяет разработчикам обходить это, делая Базовый текстовый набор только информацией о шрифтах в CGContext. Если установлено, этот атрибут также определяет цвет, используемый kCTUnderlineStyleAttributeName, когда это переопределяет основной цвет.
  
  Доступный в OS X v10.5 и позже.
- kCTParagraphStyleAttributeName
  
  kCTParagraphStyleAttributeName
  
  Стиль абзаца текста, к которому применяется этот атрибут. Объект стиля абзаца используется для указания вещей как выравнивание строки, линейки табуляции, пишущий направление, и т.д. Значение должно быть объектом CTParagraphStyle. Значение по умолчанию является пустым объектом CTParagraphStyle. Посмотрите Ссылку CTParagraphStyle для получения дополнительной информации.
  
  Доступный в OS X v10.5 и позже.
- kCTStrokeWidthAttributeName
  
  kCTStrokeWidthAttributeName
  
  Штриховая ширина. Значение должно быть a CFNumberRef объект. Значение по умолчанию 0.0, или никакой штрих. Этот атрибут, интерпретируемый как процент размера точки шрифта, управляет текстовым режимом получения: положительное получение эффекта значений со штрихом только; отрицательные величины для штриха и заливки. Типичное значение для обрисованного в общих чертах текста 3.0.
  
  Доступный в OS X v10.6 и позже.
- kCTStrokeColorAttributeName
  
  kCTStrokeColorAttributeName
  
  Цвет обводки. Значение должно быть a CGColorRef объект. Значение по умолчанию является основным цветом.
  
  Доступный в OS X v10.6 и позже.
- kCTSuperscriptAttributeName
  
  kCTSuperscriptAttributeName
  
  Расположение вертикального текста средств управления. Значение должно быть a CFNumberRef объект. Значение по умолчанию является целочисленным значением 0. Если поддерживается указанным шрифтом, значением 1 позволяет преобразовать в верхний индекс и значение -1 позволяет преобразовать в нижний индекс.
  
  Доступный в OS X v10.5 и позже.
- kCTUnderlineColorAttributeName
  
  kCTUnderlineColorAttributeName
  
  Цвет подчеркивания. Значение должно быть a CGColorRef объект. Значение по умолчанию является основным цветом.
  
  Доступный в OS X v10.5 и позже.
- kCTUnderlineStyleAttributeName
  
  kCTUnderlineStyleAttributeName
  
  Стиль подчеркивания, чтобы быть примененным во время отображения, для текста, к которому применяется этот атрибут. Значение должно быть объектом CFNumber. Значение по умолчанию kCTUnderlineStyleNone. Установите значение чего-то другого, чем kCTUnderlineStyleNone нарисовать подчеркивание. Кроме того, константы, перечисленные в CTUnderlineStyleModifiers, могут использоваться для изменения вида подчеркивания. Цвет подчеркивания определяется основным цветом текста.
  
  Доступный в OS X v10.5 и позже.
- kCTVerticalFormsAttributeName
  
  kCTVerticalFormsAttributeName
  
  Ориентация глифов в тексте, к которому применяется этот атрибут. Значение должно быть объектом CFBoolean. Значение по умолчанию False. Значение False указывает, что должны использоваться горизонтальные формы глифа; True указывает, что должны использоваться вертикальные формы глифа.
  
  Доступный в OS X v10.5 и позже.
- kCTGlyphInfoAttributeName
  
  kCTGlyphInfoAttributeName
  
  Информация глифа возражает для применения к тексту, связанному с этим атрибутом. Значение должно быть объектом CTGlyphInfo. Глиф, указанный этим объектом CTGlyphInfo, присваивается всему диапазону атрибута, при условии, что его содержание соответствует указанную основную строку и что указанный глиф доступен в шрифте, указанном kCTFontAttributeName. Посмотрите Ссылку CTGlyphInfo для получения дополнительной информации.
  
  Доступный в OS X v10.5 и позже.
- kCTRunDelegateAttributeName
  
  kCTRunDelegateAttributeName
  
  Объект делегата выполнения примениться к диапазону атрибута строки. Значение должно быть объектом CTRunDelegate. Делегат выполнения управляет такими типографскими чертами как подъем глифа, спуск и ширина. Значения, возвращенные встроенным делегатом выполнения, применяются к каждому глифу, следующему из текста в том диапазоне. Поскольку внедренный объект является только разовой дисплеем модификацией, необходимо избежать применять этот атрибут к диапазону текста со сложным поведением, таким как текст, имеющий изменение записи направления или наличия объединяющихся меток. Таким образом рекомендуется применить этот атрибут к диапазону, содержащему отдельный символ U+FFFC. Посмотрите Ссылку CTRunDelegate для получения дополнительной информации.
  
  Доступный в OS X v10.5 и позже.
CTUnderlineStyle
Спецификаторы стиля подчеркивания.

Объявление

Swift

struct CTUnderlineStyle : RawOptionSetType { init(_ rawValue: Int32) init(rawValue rawValue: Int32) static var None: CTUnderlineStyle { get } static var Single: CTUnderlineStyle { get } static var Thick: CTUnderlineStyle { get } static var Double: CTUnderlineStyle { get } }

Objective C

enum{ kCTUnderlineStyleNone = 0x00, kCTUnderlineStyleSingle = 0x01, kCTUnderlineStyleThick = 0x02, kCTUnderlineStyleDouble = 0x09 }; typedef int32_t CTUnderlineStyle;

Константы
- None
  
  kCTUnderlineStyleNone
  
  Не рисуйте подчеркивание.
  
  Доступный в OS X v10.5 и позже.
- Single
  
  kCTUnderlineStyleSingle
  
  Нарисуйте подчеркивание, состоящее из одной строки.
  
  Доступный в OS X v10.5 и позже.
- Thick
  
  kCTUnderlineStyleThick
  
  Нарисуйте подчеркивание, состоящее из толстой строки.
  
  Доступный в OS X v10.5 и позже.
- Double
  
  kCTUnderlineStyleDouble
  
  Нарисуйте подчеркивание, состоящее из двойной строки.
  
  Доступный в OS X v10.5 и позже.
Обсуждение

Эти спецификаторы типа подчеркивания могут быть применены к набору значений с kCTUnderlineStyleAttributeName атрибут для управления текстовым использованием Ядра стиля подчеркивания при рендеринге текста, к которому применяется атрибут.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в OS X v10.5 и позже.
CTUnderlineStyleModifiers
Модификаторы стиля подчеркивания.

Объявление

Swift

struct CTUnderlineStyleModifiers : RawOptionSetType { init(_ rawValue: Int32) init(rawValue rawValue: Int32) static var PatternSolid: CTUnderlineStyleModifiers { get } static var PatternDot: CTUnderlineStyleModifiers { get } static var PatternDash: CTUnderlineStyleModifiers { get } static var PatternDashDot: CTUnderlineStyleModifiers { get } static var PatternDashDotDot: CTUnderlineStyleModifiers { get } }

Objective C

enum{ kCTUnderlinePatternSolid = 0x0000, kCTUnderlinePatternDot = 0x0100, kCTUnderlinePatternDash = 0x0200, kCTUnderlinePatternDashDot = 0x0300, kCTUnderlinePatternDashDotDot = 0x0400 }; typedef int32_t CTUnderlineStyleModifiers;

Константы
- PatternSolid
  
  kCTUnderlinePatternSolid
  
  Нарисуйте существенное подчеркивание.
  
  Доступный в OS X v10.5 и позже.
- PatternDot
  
  kCTUnderlinePatternDot
  
  Нарисуйте подчеркивание с помощью образца точек.
  
  Доступный в OS X v10.5 и позже.
- PatternDash
  
  kCTUnderlinePatternDash
  
  Нарисуйте подчеркивание с помощью образца тире.
  
  Доступный в OS X v10.5 и позже.
- PatternDashDot
  
  kCTUnderlinePatternDashDot
  
  Нарисуйте подчеркивание с помощью образца чередования тире и точек.
  
  Доступный в OS X v10.5 и позже.
- PatternDashDotDot
  
  kCTUnderlinePatternDashDotDot
  
  Нарисуйте подчеркивание с помощью образца тире, сопровождаемого двумя точками.
  
  Доступный в OS X v10.5 и позже.
Обсуждение

Установите эти биты со стилем подчеркивания (см. CTUnderlineStyle), что Вы устанавливаете с kCTUnderlineStyleAttributeName атрибут, чтобы изменить, как будет нарисовано подчеркивание.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Базовая ссылка атрибутов текстовой строки

Константы

Объявление

Константы

Объявление

Константы

Обсуждение

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

Доступность

Объявление

Константы

Обсуждение

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

Доступность