Ссылка CTParagraphStyle
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Swift
import CoreText
Objective C
@import CoreText;
CTParagraphStyle непрозрачный тип представляет абзац или атрибуты линейки в приписанной строке.
Объект стиля абзаца представляет сложное значение атрибута в приписанной строке, храня много податрибутов, влияющих на расположение абзаца для символов строки. Среди этих податрибутов выравнивание, позиции табуляции, пишущий направление, повреждающий строку режим и настройки добавления отступа.
-
Создает неизменный стиль абзаца.
Объявление
Swift
func CTParagraphStyleCreate(_
settings
: UnsafePointer<CTParagraphStyleSetting>, _settingCount
: Int) -> 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
Доступность
Доступный в iOS 3.2 и позже.
-
Создает неизменную копию стиля абзаца.
Объявление
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
Доступность
Доступный в iOS 3.2 и позже.
-
Получает текущую стоимость для единственного спецификатора установки.
Объявление
Swift
func CTParagraphStyleGetValueForSpecifier(_
paragraphStyle
: CTParagraphStyle!, _spec
: CTParagraphStyleSpecifier, _valueBufferSize
: Int, _valueBuffer
: UnsafeMutablePointer<Void>) -> BoolObjective 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
Доступность
Доступный в iOS 3.2 и позже.
-
Эта структура используется для изменения стиля абзаца.
Объявление
Swift
struct CTParagraphStyleSetting { var spec: CTParagraphStyleSpecifier var valueSize: Int var value: UnsafePointer<Void> init() init(spec
spec
: CTParagraphStyleSpecifier, valueSizevalueSize
: Int, valuevalue
: 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
.Доступность
Доступный в iOS 3.2 и позже.
-
Ссылка на Базовый стиль Абзаца текста.
Объявление
Swift
typealias CTParagraphStyleRef = CTParagraphStyle
Objective C
typedef const struct __CTParagraphStyle *CTParagraphStyleRef;
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в iOS 3.2 и позже.
-
Эти константы указывают выравнивание текста.
Объявление
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
Текст визуально выравнивается по левому краю.
Доступный в iOS 3.2 и позже.
-
kCTRightTextAlignment
Текст визуально выравнивается по правому краю.
Доступный в iOS 3.2 и позже.
-
kCTCenterTextAlignment
Текст визуально централен выровненный.
Доступный в iOS 3.2 и позже.
-
kCTJustifiedTextAlignment
Текст полностью выровнен. Последняя строка в абзаце естественно выровненная.
Доступный в iOS 3.2 и позже.
-
kCTNaturalTextAlignment
Текст использует естественное выравнивание сценария текста.
Доступный в iOS 3.2 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в iOS 3.2 и позже.
-
-
Эти константы указывают то, что происходит, когда строка является слишком длинной для своего кадра.
Объявление
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
Обертывание происходит на границах слова, если само слово не соответствует на одной строке.
Доступный в iOS 3.2 и позже.
-
ByCharWrapping
kCTLineBreakByCharWrapping
Обертывание происходит перед не соответствующим первым символом.
Доступный в iOS 3.2 и позже.
-
ByClipping
kCTLineBreakByClipping
Линии просто не проведены мимо края кадра.
Доступный в iOS 3.2 и позже.
-
ByTruncatingHead
kCTLineBreakByTruncatingHead
Каждая строка выведена на экран так, чтобы конец поместился в кадр, и недостающий текст обозначен глифом замещающего знака.
Доступный в iOS 3.2 и позже.
-
ByTruncatingTail
kCTLineBreakByTruncatingTail
Каждая строка выведена на экран так, чтобы начало поместилось в контейнер, и недостающий текст обозначен глифом замещающего знака.
Доступный в iOS 3.2 и позже.
-
ByTruncatingMiddle
kCTLineBreakByTruncatingMiddle
Каждая строка выведена на экран так, чтобы начало и конец поместились в контейнер, и недостающий текст обозначен глифом замещающего знака в середине.
Доступный в iOS 3.2 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в iOS 3.2 и позже.
-
-
Эти константы указывают направление записи.
Объявление
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 Алгоритма.
Доступный в iOS 3.2 и позже.
-
LeftToRight
kCTWritingDirectionLeftToRight
Направление записи слева направо.
Доступный в iOS 3.2 и позже.
-
RightToLeft
kCTWritingDirectionRightToLeft
Направление записи справа налево.
Доступный в iOS 3.2 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в iOS 3.2 и позже.
-
-
Эти константы используются, чтобы запросить и изменить объект 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.Доступный в iOS 3.2 и позже.
-
FirstLineHeadIndent
kCTParagraphStyleSpecifierFirstLineHeadIndent
Расстояние, в точках, от ведущего поля кадра к началу первой строки абзаца. Это значение является всегда неотрицательным. Введите:
CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
HeadIndent
kCTParagraphStyleSpecifierHeadIndent
Расстояние, в точках, от ведущего поля текстового контейнера к началу строк кроме первого. Это значение является всегда неотрицательным. Введите:
CGFloat
Значение по умолчанию:0.0
Приложение: CTFramesetterДоступный в iOS 3.2 и позже.
-
TailIndent
kCTParagraphStyleSpecifierTailIndent
Расстояние, в точках, от поля кадра до конца строк. Если положительный, это значение является расстоянием от ведущего поля (например, левое поле в слева направо тексте). Если
0
или отрицательный, это - расстояние от запаздывающего поля. Введите:CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
TabStops
kCTParagraphStyleSpecifierTabStops
Объекты CTTextTab, сортированные расположением, которые определяют позиции табуляции для стиля абзаца. Введите: CFArray
CTTextTabRef
. Значение по умолчанию: 12 выровненных по левому краю вкладок, расположенных с интервалами 28,0 точками. Приложение: CTFramesetter, CTTypesetter.Доступный в iOS 3.2 и позже.
-
DefaultTabInterval
kCTParagraphStyleSpecifierDefaultTabInterval
documentwide интервал вкладки по умолчанию. Вкладки после последнего, указанного
kCTParagraphStyleSpecifierTabStops
помещаются в целочисленную сеть магазинов этого расстояния (если положительный). Введите:CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter, CTTypesetter.Доступный в iOS 3.2 и позже.
-
LineBreakMode
kCTParagraphStyleSpecifierLineBreakMode
Режим, который должен использоваться для повреждения строк при разметке текста абзаца. Введите:
CTLineBreakMode
. Значение по умолчанию:kCTLineBreakByWordWrapping
. Приложение: CTFramesetterДоступный в iOS 3.2 и позже.
-
LineHeightMultiple
kCTParagraphStyleSpecifierLineHeightMultiple
Многократная высота строки. Естественная высота строки получателя умножается на этот фактор (если положительный) прежде чем быть ограниченным минимальной и максимальной высотой строки. Введите:
CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
MaximumLineHeight
kCTParagraphStyleSpecifierMaximumLineHeight
Максимальная высота, которую любая строка в кадре займет, независимо от размера шрифта или размера любой присоединенной диаграммы. Глифы и графика, превышающая эту высоту, перекроют соседние строки. Максимальная высота
0
не подразумевает предела высоты строки. Это значение является всегда неотрицательным. Введите:CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
MinimumLineHeight
kCTParagraphStyleSpecifierMinimumLineHeight
Минимальная высота, которую любая строка в кадре займет, независимо от размера шрифта или размера любой присоединенной диаграммы. Это значение является всегда неотрицательным. Введите:
CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
LineSpacing
kCTParagraphStyleSpecifierLineSpacing
Осуждаемый. Использовать
kCTParagraphStyleSpecifierMaximumLineSpacing
,kCTParagraphStyleSpecifierMinimumLineSpacing
, иkCTParagraphStyleSpecifierLineSpaceAdjustment
управлять пространством между строками. Пространство в точках добавило между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным. Введите:CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
ParagraphSpacing
kCTParagraphStyleSpecifierParagraphSpacing
Пространство добавило в конце абзаца для разделения его от следующего параграфа. Это значение является всегда неотрицательным и определяется путем добавления предыдущего абзаца
kCTParagraphStyleSpecifierParagraphSpacing
установка и текущий абзацkCTParagraphStyleSpecifierParagraphSpacingBefore
установка. Тип:CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
ParagraphSpacingBefore
kCTParagraphStyleSpecifierParagraphSpacingBefore
Расстояние между верхней частью абзаца и начало ее текстового содержания. Введите:
CGFloat
. Значение по умолчанию:0.0
. Приложение: CTFramesetter.Доступный в iOS 3.2 и позже.
-
BaseWritingDirection
kCTParagraphStyleSpecifierBaseWritingDirection
Направление записи основы строк. Введите:
CTWritingDirection
. Значение по умолчанию:kCTWritingDirectionNatural
. Приложение: CTFramesetter, CTTypesetter.Доступный в iOS 3.2 и позже.
-
MaximumLineSpacing
kCTParagraphStyleSpecifierMaximumLineSpacing
Максимальное пространство в точках между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным.
Доступный в iOS 4.3 и позже.
-
MinimumLineSpacing
kCTParagraphStyleSpecifierMinimumLineSpacing
Минимальное пространство в точках между строками в абзаце (обычно известный как ведущий). Это значение является всегда неотрицательным.
Доступный в iOS 4.3 и позже.
-
LineSpacingAdjustment
kCTParagraphStyleSpecifierLineSpacingAdjustment
Пространство в точках добавило между строками в абзаце (обычно известный как ведущий).
Доступный в iOS 4.3 и позже.
-
Count
kCTParagraphStyleSpecifierCount
Число спецификаторов стиля. Цель состоит в том, чтобы упростить проверку спецификаторов стиля
Доступный в iOS 3.2 и позже.
Обсуждение
Каждый спецификатор имеет тип и значение по умолчанию, связанное с ним. Тип должен всегда наблюдаться при установке или выборке значения от объекта CTParagraphStyle. Кроме того, некоторые спецификаторы влияют на поведение и framesetter и наборного устройства, и другие влияют на поведение только framesetter, как отмечено в постоянных описаниях.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в iOS 3.2 и позже.
-