Ссылка CTParagraphStyle

CTParagraphStyle непрозрачный тип представляет абзац или атрибуты линейки в приписанной строке.

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

Функции

Создание стилей абзаца


    
    CTParagraphStyleCreate (_: _:)
    CTParagraphStyleCreate

Создает неизменный стиль абзаца.

Объявление

Swift

func CTParagraphStyleCreate(_ settings: UnsafePointer<CTParagraphStyleSetting>, _ settingCount: UInt) -> CTParagraphStyle!

Objective C

CTParagraphStyleRef CTParagraphStyleCreate ( const CTParagraphStyleSetting *settings, size_t settingCount );

Параметры

`settings`	Настройки, с которыми можно предварительно загрузить стиль абзаца. Если Вы хотите указать набор по умолчанию настроек, установите этот параметр на `NULL`.
`settingCount`	Число настроек, которые Вы указали в `settings` параметр. Это должно быть больше, чем или равным `0`.

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

Действительная ссылка к неизменному объекту CTParagraphStyle, Если создание стиля абзаца было успешно; иначе, NULL.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

CTParagraphStyleCreateCopy (_:) CTParagraphStyleCreateCopy

Создает неизменную копию стиля абзаца.

Объявление

Swift

func CTParagraphStyleCreateCopy(_ paragraphStyle: CTParagraphStyle!) -> CTParagraphStyle!

Objective C

CTParagraphStyleRef CTParagraphStyleCreateCopy ( CTParagraphStyleRef paragraphStyle );

Параметры

paragraphStyle

Стиль для копирования. Этот параметр может не быть NULL.

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

Действительная ссылка к неизменному объекту CTParagraphStyle, который является копией той, передала в paragraphStyle, Если paragraphStyle ссылка допустима; иначе NULL, если ошибка произошла, включая то, чтобы быть предоставленным недопустимой ссылкой.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Получение значения спецификатора стиля


    
    CTParagraphStyleGetValueForSpecifier (_: _: _: _:)
    CTParagraphStyleGetValueForSpecifier

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

Объявление

Swift

func CTParagraphStyleGetValueForSpecifier(_ paragraphStyle: CTParagraphStyle!, _ spec: CTParagraphStyleSpecifier, _ valueBufferSize: UInt, _ valueBuffer: UnsafeMutablePointer<Void>) -> Bool

Objective C

bool CTParagraphStyleGetValueForSpecifier ( CTParagraphStyleRef paragraphStyle, CTParagraphStyleSpecifier spec, size_t valueBufferSize, void *valueBuffer );

Параметры

`paragraphStyle`	Стиль абзаца, от которого можно получить значение. Этот параметр может не быть `NULL`.
`spec`	Спецификатор установки, для которого можно получить значение.
`valueBufferSize`	Размер буфера, на который указывают `valueBuffer` параметр. Это значение должно быть, по крайней мере, столь же большим как размер требуемое `CTParagraphStyleSpecifier` набор значений в `spec` параметр.
`valueBuffer`	На выводе, требуемом значении установки. Размер буфера должен быть, по крайней мере, столь большим, как значение передало в `valueBufferSize`. Этот параметр требуется и может не быть `NULL`.

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

True если valueBuffer было успешно заполнено; иначе, False, указание, что один или больше параметров не допустимы.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Получение идентификатора типа

CTParagraphStyleGetTypeID () CTParagraphStyleGetTypeID

Возвращает Базовый идентификатор типа Основы объекта стиля абзаца.

Объявление

Swift

func CTParagraphStyleGetTypeID() -> CFTypeID

Objective C

CFTypeID CTParagraphStyleGetTypeID ( void );

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Типы данных


      
      CTParagraphStyleSetting

Эта структура используется для изменения стиля абзаца.

Объявление

Swift

struct CTParagraphStyleSetting { var spec: CTParagraphStyleSpecifier var valueSize: UInt var value: UnsafePointer<Void> }

Objective C

typedef struct CTParagraphStyleSetting{ CTParagraphStyleSpecifier spec; size_t valueSize; const void* value;} CTParagraphStyleSetting;

Поля

`spec`	Спецификатор установки. Посмотрите CTParagraphStyleSpecifier для возможных значений.
`valueSize`	Размер значения, на которое указывают `value` поле. Это значение должно соответствовать размер значения, требуемого `CTParagraphStyleSpecifier` набор `spec` поле.
`value`	Ссылка на значение установки, указанной `spec` поле. Значение должно быть в надлежащем диапазоне для `spec` значение и по крайней мере столь большой, как размер указал в `valueSize`.

Доступность

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

CTParagraphStyleRef CTParagraphStyleRef

Ссылка на Базовый стиль Абзаца текста.

Объявление

Swift

typealias CTParagraphStyleRef = CTParagraphStyle

Objective C

typedef const struct __CTParagraphStyle *CTParagraphStyleRef;

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Константы

CTTextAlignment
Эти константы указывают выравнивание текста.

Объявление

Swift

enum CTTextAlignment : UInt8 { case TextAlignmentLeft case TextAlignmentRight case TextAlignmentCenter case TextAlignmentJustified case TextAlignmentNatural }

Objective C

enum{ kCTLeftTextAlignment = 0, kCTRightTextAlignment = 1, kCTCenterTextAlignment = 2, kCTJustifiedTextAlignment = 3, kCTNaturalTextAlignment = 4 }; typedef uint8_t CTTextAlignment;

Константы
- kCTLeftTextAlignment
  
  kCTLeftTextAlignment
  
  Текст визуально выравнивается по левому краю.
  
  Доступный в OS X v10.5 и позже.
- kCTRightTextAlignment
  
  kCTRightTextAlignment
  
  Текст визуально выравнивается по правому краю.
  
  Доступный в OS X v10.5 и позже.
- kCTCenterTextAlignment
  
  kCTCenterTextAlignment
  
  Текст визуально централен выровненный.
  
  Доступный в OS X v10.5 и позже.
- kCTJustifiedTextAlignment
  
  kCTJustifiedTextAlignment
  
  Текст полностью выровнен. Последняя строка в абзаце естественно выровненная.
  
  Доступный в OS X v10.5 и позже.
- kCTNaturalTextAlignment
  
  kCTNaturalTextAlignment
  
  Текст использует естественное выравнивание сценария текста.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в OS X v10.5 и позже.
CTLineBreakMode
Эти константы указывают то, что происходит, когда строка является слишком длинной для своего кадра.

Объявление

Swift

enum CTLineBreakMode : UInt8 { case ByWordWrapping case ByCharWrapping case ByClipping case ByTruncatingHead case ByTruncatingTail case ByTruncatingMiddle }

Objective C

enum{ kCTLineBreakByWordWrapping = 0, kCTLineBreakByCharWrapping = 1, kCTLineBreakByClipping = 2, kCTLineBreakByTruncatingHead = 3, kCTLineBreakByTruncatingTail = 4, kCTLineBreakByTruncatingMiddle = 5 }; typedef uint8_t CTLineBreakMode;

Константы
- ByWordWrapping
  
  kCTLineBreakByWordWrapping
  
  Обертывание происходит на границах слова, если само слово не соответствует на одной строке.
  
  Доступный в OS X v10.5 и позже.
- ByCharWrapping
  
  kCTLineBreakByCharWrapping
  
  Обертывание происходит перед не соответствующим первым символом.
  
  Доступный в OS X v10.5 и позже.
- ByClipping
  
  kCTLineBreakByClipping
  
  Линии просто не проведены мимо края кадра.
  
  Доступный в OS X v10.5 и позже.
- ByTruncatingHead
  
  kCTLineBreakByTruncatingHead
  
  Каждая строка выведена на экран так, чтобы конец поместился в кадр, и недостающий текст обозначен глифом замещающего знака.
  
  Доступный в OS X v10.5 и позже.
- ByTruncatingTail
  
  kCTLineBreakByTruncatingTail
  
  Каждая строка выведена на экран так, чтобы начало поместилось в контейнер, и недостающий текст обозначен глифом замещающего знака.
  
  Доступный в OS X v10.5 и позже.
- ByTruncatingMiddle
  
  kCTLineBreakByTruncatingMiddle
  
  Каждая строка выведена на экран так, чтобы начало и конец поместились в контейнер, и недостающий текст обозначен глифом замещающего знака в середине.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в OS X v10.5 и позже.
CTWritingDirection
Эти константы указывают направление записи.

Объявление

Swift

enum CTWritingDirection : Int8 { case Natural case LeftToRight case RightToLeft }

Objective C

enum{ kCTWritingDirectionNatural = -1, kCTWritingDirectionLeftToRight = 0, kCTWritingDirectionRightToLeft = 1 }; typedef int8_t CTWritingDirection;

Константы
- Natural
  
  kCTWritingDirectionNatural
  
  Направление записи алгоритмически определяется с помощью Unicode Двунаправленные правила P2 и P3 Алгоритма.
  
  Доступный в OS X v10.5 и позже.
- LeftToRight
  
  kCTWritingDirectionLeftToRight
  
  Направление записи слева направо.
  
  Доступный в OS X v10.5 и позже.
- RightToLeft
  
  kCTWritingDirectionRightToLeft
  
  Направление записи справа налево.
  
  Доступный в OS X v10.5 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в OS X v10.5 и позже.
CTParagraphStyleSpecifier
Эти константы используются, чтобы запросить и изменить объект CTParagraphStyle.

Объявление

Swift

enum CTParagraphStyleSpecifier : UInt32 { case Alignment case FirstLineHeadIndent case HeadIndent case TailIndent case TabStops case DefaultTabInterval case LineBreakMode case LineHeightMultiple case MaximumLineHeight case MinimumLineHeight case LineSpacing case ParagraphSpacing case ParagraphSpacingBefore case BaseWritingDirection case MaximumLineSpacing case MinimumLineSpacing case LineSpacingAdjustment case LineBoundsOptions case Count }

Objective C

enum{ kCTParagraphStyleSpecifierAlignment = 0, kCTParagraphStyleSpecifierFirstLineHeadIndent = 1, kCTParagraphStyleSpecifierHeadIndent = 2, kCTParagraphStyleSpecifierTailIndent = 3, kCTParagraphStyleSpecifierTabStops = 4, kCTParagraphStyleSpecifierDefaultTabInterval = 5, kCTParagraphStyleSpecifierLineBreakMode = 6, kCTParagraphStyleSpecifierLineHeightMultiple = 7, kCTParagraphStyleSpecifierMaximumLineHeight = 8, kCTParagraphStyleSpecifierMinimumLineHeight = 9, kCTParagraphStyleSpecifierLineSpacing = 10, /* deprecated */ kCTParagraphStyleSpecifierParagraphSpacing = 11, kCTParagraphStyleSpecifierParagraphSpacingBefore = 12, kCTParagraphStyleSpecifierBaseWritingDirection = 13, kCTParagraphStyleSpecifierMaximumLineSpacing = 14, kCTParagraphStyleSpecifierMinimumLineSpacing = 15, kCTParagraphStyleSpecifierLineSpacingAdjustment = 16, kCTParagraphStyleSpecifierCount = 17 }; typedef uint32_t CTParagraphStyleSpecifier;

Константы
- Alignment
  
  kCTParagraphStyleSpecifierAlignment
  
  Выравнивание текста. Естественное выравнивание текста понято как левое или правое выравнивание, в зависимости от направления развертки строки первого сценария, содержавшегося в абзаце. Введите: CTTextAlignment. Значение по умолчанию: kCTNaturalTextAlignment. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- FirstLineHeadIndent
  
  kCTParagraphStyleSpecifierFirstLineHeadIndent
  
  Расстояние, в точках, от ведущего поля кадра к началу первой строки абзаца. Это значение является всегда неотрицательным. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- HeadIndent
  
  kCTParagraphStyleSpecifierHeadIndent
  
  Расстояние, в точках, от ведущего поля текстового контейнера к началу строк кроме первого. Это значение является всегда неотрицательным. Введите: CGFloat Значение по умолчанию: 0.0 Приложение: CTFramesetter
  
  Доступный в OS X v10.5 и позже.
- TailIndent
  
  kCTParagraphStyleSpecifierTailIndent
  
  Расстояние, в точках, от поля кадра до конца строк. Если положительный, это значение является расстоянием от ведущего поля (например, левое поле в слева направо тексте). Если 0 или отрицательный, это - расстояние от запаздывающего поля. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- TabStops
  
  kCTParagraphStyleSpecifierTabStops
  
  Объекты CTTextTab, сортированные расположением, которые определяют позиции табуляции для стиля абзаца. Введите: CFArray CTTextTabRef. Значение по умолчанию: 12 выровненных по левому краю вкладок, расположенных с интервалами 28,0 точками. Приложение: CTFramesetter, CTTypesetter.
  
  Доступный в OS X v10.5 и позже.
- DefaultTabInterval
  
  kCTParagraphStyleSpecifierDefaultTabInterval
  
  documentwide интервал вкладки по умолчанию. Вкладки после последнего, указанного kCTParagraphStyleSpecifierTabStops помещаются в целочисленную сеть магазинов этого расстояния (если положительный). Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter, CTTypesetter.
  
  Доступный в OS X v10.5 и позже.
- LineBreakMode
  
  kCTParagraphStyleSpecifierLineBreakMode
  
  Режим, который должен использоваться для повреждения строк при разметке текста абзаца. Введите: CTLineBreakMode. Значение по умолчанию: kCTLineBreakByWordWrapping. Приложение: CTFramesetter
  
  Доступный в OS X v10.5 и позже.
- LineHeightMultiple
  
  kCTParagraphStyleSpecifierLineHeightMultiple
  
  Многократная высота строки. Естественная высота строки получателя умножается на этот фактор (если положительный) прежде чем быть ограниченным минимальной и максимальной высотой строки. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- MaximumLineHeight
  
  kCTParagraphStyleSpecifierMaximumLineHeight
  
  Максимальная высота, которую любая строка в кадре займет, независимо от размера шрифта или размера любой присоединенной диаграммы. Глифы и графика, превышающая эту высоту, перекроют соседние строки. Максимальная высота 0 не подразумевает предела высоты строки. Это значение является всегда неотрицательным. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- MinimumLineHeight
  
  kCTParagraphStyleSpecifierMinimumLineHeight
  
  Минимальная высота, которую любая строка в кадре займет, независимо от размера шрифта или размера любой присоединенной диаграммы. Это значение является всегда неотрицательным. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- LineSpacing
  
  kCTParagraphStyleSpecifierLineSpacing
  
  Осуждаемый. Использовать kCTParagraphStyleSpecifierMaximumLineSpacing, kCTParagraphStyleSpecifierMinimumLineSpacing, и kCTParagraphStyleSpecifierLineSpaceAdjustment управлять пространством между строками. Пространство в точках добавило между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- ParagraphSpacing
  
  kCTParagraphStyleSpecifierParagraphSpacing
  
  Пространство добавило в конце абзаца для разделения его от следующего параграфа. Это значение является всегда неотрицательным и определяется путем добавления предыдущего абзаца kCTParagraphStyleSpecifierParagraphSpacing установка и текущий абзац kCTParagraphStyleSpecifierParagraphSpacingBefore установка. Тип: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- ParagraphSpacingBefore
  
  kCTParagraphStyleSpecifierParagraphSpacingBefore
  
  Расстояние между верхней частью абзаца и начало ее текстового содержания. Введите: CGFloat. Значение по умолчанию: 0.0. Приложение: CTFramesetter.
  
  Доступный в OS X v10.5 и позже.
- BaseWritingDirection
  
  kCTParagraphStyleSpecifierBaseWritingDirection
  
  Направление записи основы строк. Введите: CTWritingDirection. Значение по умолчанию: kCTWritingDirectionNatural. Приложение: CTFramesetter, CTTypesetter.
  
  Доступный в OS X v10.5 и позже.
- MaximumLineSpacing
  
  kCTParagraphStyleSpecifierMaximumLineSpacing
  
  Максимальное пространство в точках между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным.
  
  Доступный в OS X v10.7 и позже.
- MinimumLineSpacing
  
  kCTParagraphStyleSpecifierMinimumLineSpacing
  
  Минимальное пространство в точках между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным.
  
  Доступный в OS X v10.7 и позже.
- LineSpacingAdjustment
  
  kCTParagraphStyleSpecifierLineSpacingAdjustment
  
  Пространство в точках добавило между строками в абзаце (обычно известный как ведущий).
  
  Доступный в OS X v10.7 и позже.
- Count
  
  kCTParagraphStyleSpecifierCount
  
  Число спецификаторов стиля. Цель состоит в том, чтобы упростить проверку спецификаторов стиля
  
  Доступный в OS X v10.5 и позже.
Обсуждение

Каждый спецификатор имеет тип и значение по умолчанию, связанное с ним. Тип должен всегда наблюдаться при установке или выборке значения от объекта CTParagraphStyle. Кроме того, некоторые спецификаторы влияют на поведение и framesetter и наборного устройства, и другие влияют на поведение только framesetter, как отмечено в постоянных описаниях.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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