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

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

Разработчик

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

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

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

Ссылка CTRun

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

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

Функции

Получение глифа выполненные данные
  • CTRunGetGlyphCount (_:) CTRunGetGlyphCount

    Добирается глиф значат выполнение.

    Объявление

    Swift

    func CTRunGetGlyphCount(_ run: CTRun!) -> CFIndex

    Objective C

    CFIndex CTRunGetGlyphCount ( CTRunRef run );

    Параметры

    run

    Выполнение, для которого можно возвратить количество глифа.

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

    Число глифов, которые выполнение содержит, или при отсутствии глифов в этом выполнении, значении 0.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetAttributes (_:) CTRunGetAttributes

    Возвращает словарь атрибута, использовавшийся для создания выполненного глифа.

    Объявление

    Swift

    func CTRunGetAttributes(_ run: CTRun!) -> CFDictionary!

    Objective C

    CFDictionaryRef CTRunGetAttributes ( CTRunRef run );

    Параметры

    run

    Выполнение, для которого можно возвратить атрибуты.

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

    Допустимое CFDictionaryRef или NULL на ошибке или если выполнение не имеет никаких атрибутов.

    Обсуждение

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetStatus (_:) CTRunGetStatus

    Возвращает состояние выполнения.

    Объявление

    Swift

    func CTRunGetStatus(_ run: CTRun!) -> CTRunStatus

    Objective C

    CTRunStatus CTRunGetStatus ( CTRunRef run );

    Параметры

    run

    Выполнение, для которого можно возвратить состояние.

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

    Состояние выполнения.

    Обсуждение

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetGlyphsPtr (_:) CTRunGetGlyphsPtr

    Возвращает прямой указатель для массива глифа, сохраненного в выполнении.

    Объявление

    Swift

    func CTRunGetGlyphsPtr(_ run: CTRun!) -> UnsafePointer<CGGlyph>

    Objective C

    const CGGlyph * CTRunGetGlyphsPtr ( CTRunRef run );

    Параметры

    run

    Выполнение, из которого можно возвратить глифы.

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

    Допустимый указатель на массив CGGlyph структуры, или NULL.

    Обсуждение

    Массив глифа будет иметь длину равной значению возвращенный CTRunGetGlyphCount. Вызывающая сторона должна быть подготовлена к этой функции возвратиться NULL даже если существуют глифы в потоке. Если возвращается эта функция NULL, вызывающая сторона должна выделить свой собственный буфер и вызов CTRunGetGlyphs выбирать глифы.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetGlyphs (_: _: _:) CTRunGetGlyphs

    Копирует диапазон глифов в предоставленный пользователями буфер.

    Объявление

    Swift

    func CTRunGetGlyphs(_ run: CTRun!, _ range: CFRange, _ buffer: UnsafeMutablePointer<CGGlyph>)

    Objective C

    void CTRunGetGlyphs ( CTRunRef run, CFRange range, CGGlyph buffer[] );

    Параметры

    run

    Выполнение, с которого можно скопировать глифы.

    range

    Диапазон глифов для копирования. Если длина диапазона установлена в 0, тогда работа копии продолжается от индекса запуска диапазона до конца выполнения.

    buffer

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetPositionsPtr (_:) CTRunGetPositionsPtr

    Возвращает прямой указатель для массива позиции глифа, сохраненного в выполнении.

    Объявление

    Swift

    func CTRunGetPositionsPtr(_ run: CTRun!) -> UnsafePointer<CGPoint>

    Objective C

    const CGPoint * CTRunGetPositionsPtr ( CTRunRef run );

    Параметры

    run

    Выполнение, от которого можно получить доступ к позициям глифа.

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

    Допустимый указатель на массив CGPoint структуры, или NULL.

    Обсуждение

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetPositions (_: _: _:) CTRunGetPositions

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

    Объявление

    Swift

    func CTRunGetPositions(_ run: CTRun!, _ range: CFRange, _ buffer: UnsafeMutablePointer<CGPoint>)

    Objective C

    void CTRunGetPositions ( CTRunRef run, CFRange range, CGPoint buffer[] );

    Параметры

    run

    Выполнение, с которого можно скопировать позиции глифа.

    range

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

    buffer

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetAdvancesPtr (_:) CTRunGetAdvancesPtr

    Возвращает прямой указатель для массива усовершенствования глифа, сохраненного в выполнении.

    Объявление

    Swift

    func CTRunGetAdvancesPtr(_ run: CTRun!) -> UnsafePointer<CGSize>

    Objective C

    const CGSize * CTRunGetAdvancesPtr ( CTRunRef run );

    Параметры

    run

    Выполнение, к усовершенствованиям которого Вы хотите получить доступ.

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

    Допустимый указатель на массив CGSize структуры, представляющие глиф, совершенствуют массив или NULL.

    Обсуждение

    Предварительный массив будет иметь длину равной значению возвращенный CTRunGetGlyphCount. Вызывающая сторона должна быть подготовлена к этой функции возвратиться NULL даже если существуют глифы в потоке. Если этот функциональный возврат NULL, вызывающая сторона должна выделить свой собственный буфер и вызов CTRunGetAdvances выбирать усовершенствования. Обратите внимание на то, что одни только усовершенствования не достаточны для того, чтобы правильно расположить глифы в строку, поскольку выполнение может иметь неединичную матрицу, или начальный глиф в строке может возникнуть; вызывающие стороны должны рассмотреть использование позиций вместо этого.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetAdvances (_: _: _:) CTRunGetAdvances

    Копирует диапазон усовершенствований глифа в предоставленный пользователями буфер.

    Объявление

    Swift

    func CTRunGetAdvances(_ run: CTRun!, _ range: CFRange, _ buffer: UnsafeMutablePointer<CGSize>)

    Objective C

    void CTRunGetAdvances ( CTRunRef run, CFRange range, CGSize buffer[] );

    Параметры

    run

    Выполнение, усовершенствования которого Вы хотите скопировать.

    range

    Диапазон глифа совершенствует Вас, хотят скопировать. Если длина диапазона установлена в 0, тогда работа копии продолжается от индекса запуска диапазона до конца выполнения.

    buffer

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetStringIndicesPtr (_:) CTRunGetStringIndicesPtr

    Возвращает прямой указатель для индексов строк, сохраненных в выполнении.

    Объявление

    Swift

    func CTRunGetStringIndicesPtr(_ run: CTRun!) -> UnsafePointer<CFIndex>

    Objective C

    const CFIndex * CTRunGetStringIndicesPtr ( CTRunRef run );

    Параметры

    run

    Выполнение то, для который к индексам возвращаемой строки.

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

    Допустимый указатель на массив CFIndex структуры, или NULL.

    Обсуждение

    Индексы являются индексами символа, первоначально породившими глифы, составляющие выполнение. Они могут использоваться для отображения глифов в отбежавшем к символам в запоминающем устройстве. Массив индексов строк будет иметь длину равной значению возвращенный CTRunGetGlyphCount. Вызывающая сторона должна быть подготовлена к этой функции возвратиться NULL даже если существуют глифы в потоке. Если возвращается эта функция NULL, вызывающая сторона должна выделить свой собственный буфер и вызов CTRunGetStringIndices выбирать индексы.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetStringIndices (_: _: _:) CTRunGetStringIndices

    Копирует диапазон индексов строк в предоставленный пользователями буфер.

    Объявление

    Swift

    func CTRunGetStringIndices(_ run: CTRun!, _ range: CFRange, _ buffer: UnsafeMutablePointer<CFIndex>)

    Objective C

    void CTRunGetStringIndices ( CTRunRef run, CFRange range, CFIndex buffer[] );

    Параметры

    run

    Выполнение, с которого можно скопировать индексы строк.

    range

    Диапазон индексов строк для копирования. Если длина диапазона установлена в 0, тогда работа копии продолжается от индекса запуска диапазона до конца выполнения.

    buffer

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

    Обсуждение

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetStringRange (_:) CTRunGetStringRange

    Получает диапазон символов, первоначально породивших глифы в выполнении.

    Объявление

    Swift

    func CTRunGetStringRange(_ run: CTRun!) -> CFRange

    Objective C

    CFRange CTRunGetStringRange ( CTRunRef run );

    Параметры

    run

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

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

    Диапазон символов, первоначально породивших глифы, если run недопустимо, пустой диапазон.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

Измерение выполнения глифа
  • CTRunGetTypographicBounds (_: _: _: _: _:) CTRunGetTypographicBounds

    Получает типографские границы выполнения.

    Объявление

    Swift

    func CTRunGetTypographicBounds(_ run: CTRun!, _ range: CFRange, _ ascent: UnsafeMutablePointer<CGFloat>, _ descent: UnsafeMutablePointer<CGFloat>, _ leading: UnsafeMutablePointer<CGFloat>) -> Double

    Objective C

    double CTRunGetTypographicBounds ( CTRunRef run, CFRange range, CGFloat *ascent, CGFloat *descent, CGFloat *leading );

    Параметры

    run

    Выполнение, для которого можно вычислить типографские границы.

    range

    Часть выполнения для измерения. Если длина диапазона установлена в 0, тогда работа меры продолжается от индекса запуска диапазона до конца выполнения.

    ascent

    На выводе, подъеме выполнения. Это может быть установлено в NULL если не необходимый.

    descent

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

    leading

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

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

    Типографская ширина выполнения, или если run или range недопустимо, 0.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetImageBounds (_: _: _:) CTRunGetImageBounds

    Вычисляет границы изображения для диапазона глифа.

    Объявление

    Swift

    func CTRunGetImageBounds(_ run: CTRun!, _ context: CGContext!, _ range: CFRange) -> CGRect

    Objective C

    CGRect CTRunGetImageBounds ( CTRunRef run, CGContextRef context, CFRange range );

    Параметры

    run

    Выполнение, для которого можно вычислить границы изображения.

    context

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

    range

    Часть выполнения для измерения. Если длина диапазона установлена в 0, тогда работа меры продолжается от индекса запуска диапазона до конца выполнения.

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

    Прямоугольник, плотно включающий пути глифов выполнения, или, если run, context, или range недопустимо, CGRectNull.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

Рисование выполнения глифа
  • CTRunDraw (_: _: _:) CTRunDraw

    Рисует полное выполнение или часть одной.

    Объявление

    Swift

    func CTRunDraw(_ run: CTRun!, _ context: CGContext!, _ range: CFRange)

    Objective C

    void CTRunDraw ( CTRunRef run, CGContextRef context, CFRange range );

    Параметры

    run

    Выполнение для рисования.

    context

    Контекст, в который можно нарисовать выполнение.

    range

    Часть выполнения для рисования. Если длина диапазона установлена в 0, тогда работа получения продолжается от индекса запуска диапазона до конца выполнения.

    Обсуждение

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

  • CTRunGetTextMatrix (_:) CTRunGetTextMatrix

    Возвращается текстовая матрица должна была нарисовать это выполнение.

    Объявление

    Swift

    func CTRunGetTextMatrix(_ run: CTRun!) -> CGAffineTransform

    Objective C

    CGAffineTransform CTRunGetTextMatrix ( CTRunRef run );

    Параметры

    run

    Объект выполнения, от которого можно получить текстовую матрицу.

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

    A CGAffineTransform структура.

    Обсуждение

    Должным образом нарисовать глифы в выполнении, полях tx и ty из CGAffineTransform возвращенный этой функцией должен быть установлен в позицию текущего текста.

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

Получение идентификатора типа
  • CTRunGetTypeID () CTRunGetTypeID

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

    Объявление

    Swift

    func CTRunGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CTRunGetTypeID ( void );

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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

Типы данных

  • CTRunRef

    Ссылка на объект выполнения.

    Объявление

    Swift

    typealias CTRunRef = CTRun

    Objective C

    typedef const struct __CTRun *CTRunRef;

    Доступность

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

Константы

  • CTRunStatus

    Битовое поле, пасуемое назад CTRunGetStatus функция, использующаяся для указания расположения выполнения.

    Объявление

    Swift

    struct CTRunStatus : RawOptionSetType { init(_ rawValue: UInt32) init(rawValue rawValue: UInt32) static var NoStatus: CTRunStatus { get } static var RightToLeft: CTRunStatus { get } static var NonMonotonic: CTRunStatus { get } static var HasNonIdentityMatrix: CTRunStatus { get } }

    Objective C

    enum{ kCTRunStatusNoStatus = 0, kCTRunStatusRightToLeft = (1 << 0), kCTRunStatusNonMonotonic = (1 << 1), kCTRunStatusHasNonIdentityMatrix = (1 << 2) }; typedef uint32_t CTRunStatus;

    Константы

    • NoStatus

      kCTRunStatusNoStatus

      Выполнение не имеет никаких специальных атрибутов.

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

    • RightToLeft

      kCTRunStatusRightToLeft

      Выполнение продолжается справа налево.

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

    • NonMonotonic

      kCTRunStatusNonMonotonic

      Выполнение было переупорядочено в некотором роде таким образом, что индексы строк, связанные с глифами, строго больше не увеличиваются (для слева направо выполнений) или уменьшаются (для справа налево выполнений).

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

    • HasNonIdentityMatrix

      kCTRunStatusHasNonIdentityMatrix

      Выполнение требует, чтобы определенная текстовая матрица была установлена в текущем Базовом Графическом контексте для надлежащего получения.

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

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

    Objective C

    @import CoreText;

    Swift

    import CoreText

    Доступность

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