Ссылка CTFramesetter

Непрозрачный тип CTFramesetter используется для генерации текстовых рамок. Т.е. CTFramesetter является объектной фабрикой для объектов CTFrame.

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

Функции

Создание Framesetter

CTFramesetterCreateWithAttributedString (_:) CTFramesetterCreateWithAttributedString

Создает неизменный объект framesetter из приписанной строки.

Объявление

Swift

func CTFramesetterCreateWithAttributedString(_ string: CFAttributedString!) -> CTFramesetter!

Objective C

CTFramesetterRef CTFramesetterCreateWithAttributedString ( CFAttributedStringRef string );

Параметры

string

Приписанная строка, с которой можно создать объект framesetter.

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

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

Обсуждение

Результант framesetter объект может использоваться, чтобы создать и заполнить текстовые рамки CTFramesetterCreateFrame вызвать.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Создание кадров


    
    CTFramesetterCreateFrame (_: _: _: _:)
    CTFramesetterCreateFrame

Создает неизменный кадр с помощью framesetter.

Объявление

Swift

func CTFramesetterCreateFrame(_ framesetter: CTFramesetter!, _ stringRange: CFRange, _ path: CGPath!, _ frameAttributes: CFDictionary!) -> CTFrame!

Objective C

CTFrameRef CTFramesetterCreateFrame ( CTFramesetterRef framesetter, CFRange stringRange, CGPathRef path, CFDictionaryRef frameAttributes );

Параметры

`framesetter`	framesetter раньше создавал кадр.
`stringRange`	Диапазон, приписанной строки, использовавшейся для создания framesetter, который должен быть набран в строках, вписался в кадр. Если часть длины диапазона установлена в `0`, тогда framesetter продолжает добавлять строки, пока он не исчерпывает текст или пространство.
`path`	Объект CGPath, указывающий форму кадра. Путь может быть непрямоугольным в версиях OS X v10.7 или позже и версиях iOS 4.2 или позже.
`frameAttributes`	Дополнительные атрибуты, управляющие процессом заполнения кадра, могут быть указаны здесь, или `NULL` если нет таких атрибутов.

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

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

Обсуждение

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

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

В версиях OS X до 10,7 и версиях iOS до 4,2, эта функция возвраты NULL если CGPath, указанный path параметр не является прямоугольным.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

CTFramesetterGetTypesetter (_:) CTFramesetterGetTypesetter

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

Объявление

Swift

func CTFramesetterGetTypesetter(_ framesetter: CTFramesetter!) -> CTTypesetter!

Objective C

CTTypesetterRef CTFramesetterGetTypesetter ( CTFramesetterRef framesetter );

Параметры

framesetter

framesetter, от которого требуют наборное устройство.

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

Ссылка на CTTypesetter возражает, был ли вызов успешен; иначе, NULL. framesetter поддерживает ссылку на возвращенный объект, который не должен быть выпущен вызывающей стороной.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Изменение размера кадра


    
    CTFramesetterSuggestFrameSizeWithConstraints (_: _: _: _: _:)
    CTFramesetterSuggestFrameSizeWithConstraints

Определяет тип телосложения, необходимый для строкового диапазона.

Объявление

Swift

func CTFramesetterSuggestFrameSizeWithConstraints(_ framesetter: CTFramesetter!, _ stringRange: CFRange, _ frameAttributes: CFDictionary!, _ constraints: CGSize, _ fitRange: UnsafeMutablePointer<CFRange>) -> CGSize

Objective C

CGSize CTFramesetterSuggestFrameSizeWithConstraints ( CTFramesetterRef framesetter, CFRange stringRange, CFDictionaryRef frameAttributes, CGSize constraints, CFRange *fitRange );

Параметры

`framesetter`	framesetter, используемый для измерения типа телосложения.
`stringRange`	Строковый диапазон, к которому применяется тип телосложения. Строковый диапазон является диапазоном по строке, используемой для создания framesetter. Если часть длины диапазона установлена в `0`, тогда framesetter продолжает добавлять строки, пока он не исчерпывает текст или пространство.
`frameAttributes`	Дополнительные атрибуты, управляющие процессом заполнения кадра, или `NULL` если нет таких атрибутов.
`constraints`	Ширина и высота, к которой ограничивается тип телосложения. Значение `CGFLOAT_MAX` поскольку любая размерность указывает, что должна быть обработана как неограниченная.
`fitRange`	По возврату, содержит диапазон строки, которые фактически помещаются в ограниченный размер.

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

Фактические размерности для данного строкового диапазона и ограничений.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

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

CTFramesetterGetTypeID () CTFramesetterGetTypeID

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

Объявление

Swift

func CTFramesetterGetTypeID() -> CFTypeID

Objective C

CFTypeID CTFramesetterGetTypeID ( void );

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Типы данных

CTFramesetterRef

Ссылка на Базовую Основу framesetter объект.

Объявление

Swift

typealias CTFramesetterRef = CTFramesetter

Objective C

typedef const struct __CTFramesetter *CTFramesetterRef;

Доступность

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