Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы ApplicationServices ссылка CTParagraphStyle

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка 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>) -> 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

    Доступность

    Доступный в iOS 3.2 и позже.

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

    Объявление

    Swift

    func CTParagraphStyleGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CTParagraphStyleGetTypeID ( void );

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

    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, valueSize valueSize: Int, value 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.

    Доступность

    Доступный в 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 и позже.