Ссылка CTTypesetter

Непрозрачный тип CTTypesetter представляет наборное устройство, выполняющее расположение строки.

Расположение строки включает переход на новую строку, расстановку переносов и строку, прерывающую или вертикальные или горизонтальные прямоугольники. Объект наборного устройства берет в качестве ввода приписанную строку и продолжает линию набранных глифов (составленный в выполнения глифа) в объекте CTLine. Наборное устройство выполняет кодирование символа к глифу, упорядочивание глифа и позиционные операции, такие как кернинг, отслеживание и базовые корректировки. Если многострочное расположение необходимо, оно выполняется объектом framesetter, вызывающим в наборное устройство для генерации набранных строк для заполнения кадра.

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

Функции

Создание наборного устройства


    
    CTTypesetterCreateWithAttributedString (_:)
    CTTypesetterCreateWithAttributedString

Создает неизменный объект наборного устройства использование приписанной строки.

Объявление

Swift

func CTTypesetterCreateWithAttributedString(_ string: CFAttributedString!) -> CTTypesetter!

Objective C

CTTypesetterRef CTTypesetterCreateWithAttributedString ( CFAttributedStringRef string );

Параметры


      string

Приписанная строка для набора. Этот параметр должен быть заполнен в допустимым объектом CFAttributedString.

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

Ссылка на CTTypesetter возражает, был ли вызов успешен; иначе, NULL.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTTypesetterCreateWithAttributedStringAndOptions (_: _:)
    CTTypesetterCreateWithAttributedStringAndOptions

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

Объявление

Swift

func CTTypesetterCreateWithAttributedStringAndOptions(_ string: CFAttributedString!, _ options: CFDictionary!) -> CTTypesetter!

Objective C

CTTypesetterRef CTTypesetterCreateWithAttributedStringAndOptions ( CFAttributedStringRef string, CFDictionaryRef options );

Параметры

`string`	Приписанная строка для набора. Этот параметр должен быть заполнен в допустимым объектом CFAttributedString.
`options`	Словарь опций наборного устройства, или `NULL` если нет ни одного.

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

Ссылка на CTTypesetter возражает, был ли вызов успешен; иначе, NULL.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

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


    
    CTTypesetterCreateLine (_: _:)
    CTTypesetterCreateLine

Создает неизменную строку из наборного устройства.

Объявление

Swift

func CTTypesetterCreateLine(_ typesetter: CTTypesetter!, _ stringRange: CFRange) -> CTLine!

Objective C

CTLineRef CTTypesetterCreateLine ( CTTypesetterRef typesetter, CFRange stringRange );

Параметры


      typesetter

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


      stringRange

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

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

Ссылка на CTLine возражает, был ли вызов успешен; иначе, NULL.

Обсуждение

Результирующая строка состоит из глифов в корректном визуальном порядке, готовом нарисовать. Эта функция эквивалентна CTTypesetterCreateLineWithOffset со смещением 0,0.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTTypesetterCreateLineWithOffset (_: _: _:)
    CTTypesetterCreateLineWithOffset

Создает неизменную строку из наборного устройства при указанном смещении строки.

Объявление

Swift

func CTTypesetterCreateLineWithOffset(_ typesetter: CTTypesetter!, _ stringRange: CFRange, _ offset: Double) -> CTLine!

Objective C

CTLineRef CTTypesetterCreateLineWithOffset ( CTTypesetterRef typesetter, CFRange stringRange, double offset );

Параметры

`typesetter`	Наборное устройство, создающее строку. Этот параметр требуется и не может быть установлен на `NULL`.
`stringRange`	Строковый диапазон, на котором базируется строка. Если часть длины диапазона установлена в `0`, тогда наборное устройство продолжает добавлять глифы к строке, пока это не исчерпывает символы в строке. Расположение и длина диапазона должны быть в границах строки, или вызов перестанет работать.
`offset`	Позиция строки смещается.

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

Ссылка на CTLine возражает, был ли вызов успешен; иначе, NULL.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Повреждение строк


    
    CTTypesetterSuggestLineBreak (_: _: _:)
    CTTypesetterSuggestLineBreak

Предлагает контекстную точку прерывания строки на основе предоставленной ширины.

Объявление

Swift

func CTTypesetterSuggestLineBreak(_ typesetter: CTTypesetter!, _ startIndex: CFIndex, _ width: Double) -> CFIndex

Objective C

CFIndex CTTypesetterSuggestLineBreak ( CTTypesetterRef typesetter, CFIndex startIndex, double width );

Параметры

`typesetter`	Наборное устройство, создающее строку. Этот параметр требуется и не может быть установлен на `NULL`.
`startIndex`	Начальная точка для вычислений разрыва строки. Вычисления повреждения включают символ, запускающийся в `startIndex`.
`width`	Требуемая ширина разрыва строки.

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

Количество символов от startIndex это вызвало бы разрыв строки. Значение возвратилось, может использоваться для построения диапазона символов для CTTypesetterCreateLine.

Обсуждение

Разрыв строки может быть инициирован или твердым символом разрыва в потоке или путем заполнения указанной ширины символами. Эта функция эквивалентна CTTypesetterSuggestLineBreakWithOffset со смещением 0,0.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTTypesetterSuggestLineBreakWithOffset (_: _: _: _:)
    CTTypesetterSuggestLineBreakWithOffset

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

Объявление

Swift

func CTTypesetterSuggestLineBreakWithOffset(_ typesetter: CTTypesetter!, _ startIndex: CFIndex, _ width: Double, _ offset: Double) -> CFIndex

Objective C

CFIndex CTTypesetterSuggestLineBreakWithOffset ( CTTypesetterRef typesetter, CFIndex startIndex, double width, double offset );

Параметры

`typesetter`	Наборное устройство, создающее строку. Этот параметр требуется и не может быть установлен на `NULL`.
`startIndex`	Начальная точка для вычислений разрыва строки. Вычисления повреждения включают символ, запускающийся в `startIndex`.
`width`	Требуемая ширина разрыва строки.
`offset`	Позиция строки смещается.

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

Количество символов от startIndex и offset это вызвало бы разрыв строки. Значение возвратилось, может использоваться для построения диапазона символов для CTTypesetterCreateLine.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTTypesetterSuggestClusterBreak (_: _: _:)
    CTTypesetterSuggestClusterBreak

Предлагает кластерную точку прерывания строки на основе предоставленной ширины.

Объявление

Swift

func CTTypesetterSuggestClusterBreak(_ typesetter: CTTypesetter!, _ startIndex: CFIndex, _ width: Double) -> CFIndex

Objective C

CFIndex CTTypesetterSuggestClusterBreak ( CTTypesetterRef typesetter, CFIndex startIndex, double width );

Параметры

`typesetter`	Наборное устройство, создающее строку. Этот параметр требуется и не может быть установлен на `NULL`.
`startIndex`	Начальная точка для типографских вычислений кластерного повреждения. Вычисления повреждения включают символ, запускающийся в `startIndex`.
`width`	Требуемая типографская ширина кластерного повреждения.

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

Количество символов от startIndex это вызвало бы кластерное повреждение. Значение возвратилось, может использоваться для построения диапазона символов для CTTypesetterCreateLine.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTTypesetterSuggestClusterBreakWithOffset (_: _: _: _:)
    CTTypesetterSuggestClusterBreakWithOffset

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

Объявление

Swift

func CTTypesetterSuggestClusterBreakWithOffset(_ typesetter: CTTypesetter!, _ startIndex: CFIndex, _ width: Double, _ offset: Double) -> CFIndex

Objective C

CFIndex CTTypesetterSuggestClusterBreakWithOffset ( CTTypesetterRef typesetter, CFIndex startIndex, double width, double offset );

Параметры

`typesetter`	Наборное устройство, создающее строку. Этот параметр требуется и не может быть установлен на `NULL`.
`startIndex`	Начальная точка для типографских вычислений кластерного повреждения. Вычисления повреждения включают символ, запускающийся в `startIndex`.
`width`	Требуемая типографская ширина кластерного повреждения.
`offset`	Строка сместила позицию.

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

Количество символов от startIndex это вызвало бы кластерное повреждение. Значение возвратилось, может использоваться для построения диапазона символов для CTTypesetterCreateLine.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

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

CTTypesetterGetTypeID () CTTypesetterGetTypeID

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

Объявление

Swift

func CTTypesetterGetTypeID() -> CFTypeID

Objective C

CFTypeID CTTypesetterGetTypeID ( void );

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Типы данных

CTTypesetterRef

Ссылка на объект наборного устройства.

Объявление

Swift

typealias CTTypesetterRef = CTTypesetter

Objective C

typedef const struct __CTTypesetter *CTTypesetterRef;

Доступность

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

Константы

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

Объявление

Swift

let kCTTypesetterOptionForcedEmbeddingLevel: CFString!

Objective C

const CFStringRef kCTTypesetterOptionDisableBidiProcessing; const CFStringRef kCTTypesetterOptionForcedEmbeddingLevel;

Константы
- kCTTypesetterOptionDisableBidiProcessing
  
  kCTTypesetterOptionDisableBidiProcessing
  
  Отключает двунаправленную обработку. Значение должно быть объектом CFBoolean. Значение по умолчанию false. Обычно, набор применяет Unicode Двунаправленный Алгоритм, как описано в Приложении № 9 Стандарта Unicode. Если наборное устройство создается с этим набором опции к true, никакое направленное переупорядочение не выполняется, и проигнорированы любые направленные управляющие символы.
  
  Доступный в OS X v10.5 и позже.
  Осуждаемый в OS X v10.8.
- kCTTypesetterOptionForcedEmbeddingLevel
  
  kCTTypesetterOptionForcedEmbeddingLevel
  
  Указывает уровень встраивания. Значение должно быть a CFNumberRef объект. Значение по умолчанию сброшено. Обычно, набор применяет Unicode Двунаправленный Алгоритм, как описано в Приложении № 9 Стандарта Unicode. Если настоящее, эта опция указывает уровень встраивания, и проигнорированы любые направленные управляющие символы.
  
  Доступный в OS X v10.5 и позже.