Ссылка CFAttributedString

Экземпляры CFAttributedString управляют символьными строками и связанными наборами атрибутов (например, шрифт и использующая кернинг информация), которые применяются к отдельным символам или диапазонам символов в строке. CFAttributedString, как определено в Базовой Основе обеспечивает основную контейнерную функциональность, в то время как более высокие уровни обеспечивают определения для стандартных атрибутов, их значений и дополнительных способов поведения, включающих их. CFAttributedString представляет неизменную строку — использование CFMutableAttributedStringRef создать и управлять приписанной строкой, которая может быть изменена после того, как она была создана.

CFAttributedString не является «подклассом» CFString; т.е. это не отвечает на вызовы функции CFString. CFAttributedString концептуально содержит CFString, к которому он применяет атрибуты. Это защищает Вас от случаев неоднозначности, вызванных семантическими различиями между простой и приписанной строкой.

Атрибуты идентифицируются парами ключ/значение, сохраненными в объектах CFDictionary. В то время как соответствующие значения являются объектами CFType надлежащего типа, ключи должны быть объектами CFString. Посмотрите константы атрибута в дополнительной NSAttributedString AppKit Ссылке или дополнительной NSAttributedString UIKit Ссылке для стандартных названий атрибута.

CFAttributedString “бесплатный соединенный мостом” с его дубликатом Основы, NSAttributedString. Это означает, что Базовый тип Основы является взаимозаменяемым в вызовах функции или вызовах метода с соединенным мостом объектом Основы. Поэтому в методе, где Вы видите NSAttributedString * параметр, можно передать в a CFAttributedStringRef, и в функции, где Вы видите a CFAttributedStringRef параметр, можно передать в NSAttributedString экземпляр. Это также применяется к конкретным подклассам NSAttributedString. Посмотрите Бесплатные Соединенные мостом Типы для получения дополнительной информации о бесплатном образовании моста.

Функции

Создание CFAttributedString


    
    CFAttributedStringCreate (_: _: _:)
    CFAttributedStringCreate

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

Объявление

Swift

func CFAttributedStringCreate(_ alloc: CFAllocator!, _ str: CFString!, _ attributes: CFDictionary!) -> CFAttributedString!

Objective C

CFAttributedStringRef CFAttributedStringCreate ( CFAllocatorRef alloc, CFStringRef str, CFDictionaryRef attributes );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для новой приписанной строки. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`str`	Строка, указывающая символы для использования в новой приписанной строке. Это значение копируется.
`attributes`	Словарь, содержащий атрибуты для применения к новой приписанной строке. Это значение копируется.

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

Приписанная строка, содержащая символы от str и атрибуты, указанные attributes. Результат NULL если была проблема в создании приписанной строки. Владение соблюдает Создать Правило.

Обсуждение

Обратите внимание на то, что и строка и словарь атрибутов копируются. Указанные атрибуты применяются к целой строке. Если Вы хотите применить различные атрибуты к различным диапазонам строки, необходимо использовать непостоянную приписанную строку.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFAttributedStringCreateCopy (_: _:)
    CFAttributedStringCreateCopy

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

Объявление

Swift

func CFAttributedStringCreateCopy(_ alloc: CFAllocator!, _ aStr: CFAttributedString!) -> CFAttributedString!

Objective C

CFAttributedStringRef CFAttributedStringCreateCopy ( CFAllocatorRef alloc, CFAttributedStringRef aStr );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для новой приписанной строки. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`aStr`	Приписанная строка для копирования.

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

Неизменная приписанная строка с символами и атрибутами, идентичными тем aStr. Возвраты NULL если была проблема, копируя объект. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFAttributedStringCreateWithSubstring (_: _: _:)
    CFAttributedStringCreateWithSubstring

Создает подприписанную строку из указанного диапазона.

Объявление

Swift

func CFAttributedStringCreateWithSubstring(_ alloc: CFAllocator!, _ theString: CFAttributedString!, _ range: CFRange) -> CFAttributedString!

Objective C

CFAttributedStringRef CFAttributedStringCreateWithSubstring ( CFAllocatorRef alloc, CFAttributedStringRef aStr, CFRange range );

Параметры

`alloc`	Средство выделения для использования для выделения памяти для новой приписанной строки. Передача `NULL` или `kCFAllocatorDefault` использовать текущее средство выделения по умолчанию.
`theString`	Приписанная строка для копирования.
`range`	Диапазон приписанной строки для копирования. `range` не должен превышать границы `aStr`.

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

Новая приписанная строка, строка которой и атрибуты копируются с указанного диапазона предоставленной приписанной строки. Возвраты NULL если была проблема, копируя объект. Владение соблюдает Создать Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

CFAttributedStringGetLength (_:) CFAttributedStringGetLength

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

Объявление

Swift

func CFAttributedStringGetLength(_ str: CFAttributedString!) -> CFIndex

Objective C

CFIndex CFAttributedStringGetLength ( CFAttributedStringRef aStr );

Параметры

str

Приписанная строка для исследования.

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

Длина приписанной строки в символах; это совпадает с CFStringGetLength(CFAttributedStringGetString(aStr)).

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

Доступный в OS X v10.4 и позже.
CFAttributedStringGetString (_:) CFAttributedStringGetString

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

Объявление

Swift

func CFAttributedStringGetString(_ aStr: CFAttributedString!) -> CFString!

Objective C

CFStringRef CFAttributedStringGetString ( CFAttributedStringRef aStr );

Параметры

aStr

Приписанная строка для исследования.

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

Неизменная строка, содержащая символы от aStr, или NULL если была проблема, создающая объект. Владение соблюдает Получить Правило.

Обсуждение

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

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Доступ к атрибутам


    
    CFAttributedStringGetAttribute (_: _: _: _:)
    CFAttributedStringGetAttribute

Возвращает значение данного атрибута приписанной строки в указанном расположении.

Объявление

Swift

func CFAttributedStringGetAttribute(_ str: CFAttributedString!, _ loc: CFIndex, _ attrName: CFString!, _ effectiveRange: UnsafeMutablePointer<CFRange>) -> AnyObject!

Objective C

CFTypeRef CFAttributedStringGetAttribute ( CFAttributedStringRef aStr, CFIndex loc, CFStringRef attrName, CFRange *effectiveRange );

Параметры

`str`	Приписанная строка для исследования.
`loc`	Расположение в `str` в котором можно определить атрибуты. `loc` не должен превышать границы `str`.
`attrName`	Имя атрибута, значение которого Вы хотите определить.
`effectiveRange`	Если нет `NULL`, по возврату содержит диапазон включая `loc` по которому точно тот же набор атрибутов применяются как в `loc`.

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

Значение указанного атрибута в указанном расположении в str. Владение соблюдает Получить Правило.

Обсуждение

По причинам производительности диапазон возвратился в effectiveRange не обязательно максимальный диапазон. При необходимости в максимальном диапазоне необходимо использовать CFAttributedStringGetAttributeAndLongestEffectiveRange.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFAttributedStringGetAttributes (_: _: _:)
    CFAttributedStringGetAttributes

Возвращает атрибуты приписанной строки в указанном расположении.

Объявление

Swift

func CFAttributedStringGetAttributes(_ str: CFAttributedString!, _ loc: CFIndex, _ effectiveRange: UnsafeMutablePointer<CFRange>) -> CFDictionary!

Objective C

CFDictionaryRef CFAttributedStringGetAttributes ( CFAttributedStringRef aStr, CFIndex loc, CFRange *effectiveRange );

Параметры

`str`	Приписанная строка для исследования.
`loc`	Расположение в `str` в котором можно определить атрибуты. `loc` не должен превышать границы `str`.
`effectiveRange`	Если нет `NULL`, по возврату содержит диапазон включая `loc` по которому точно тот же набор атрибутов применяются как в `loc`.

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

Словарь, содержащий атрибуты str в указанном расположении. Владение соблюдает Получить Правило.

Обсуждение

Если приписанная строка редактируется после этого вызова, Обратите внимание на то, что возвращенный словарь атрибута мог бы измениться непредсказуемыми способами. Если Вы хотите сохранить состояние словаря, необходимо сделать фактическую копию из него вместо того, чтобы просто сохранить его. Кроме того, Вы не должны делать предположения об отношении фактического словаря возвращенными этим вызовом, и словарь первоначально раньше устанавливал атрибуты кроме факта, что значения, сохраненные в словарях, будут идентичны (т.е. ==) к первоначально указанным.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFAttributedStringGetAttributeAndLongestEffectiveRange (_: _: _: _: _:)
    CFAttributedStringGetAttributeAndLongestEffectiveRange

Возвращает значение данного атрибута приписанной строки в указанном расположении.

Объявление

Swift

func CFAttributedStringGetAttributeAndLongestEffectiveRange(_ str: CFAttributedString!, _ loc: CFIndex, _ attrName: CFString!, _ inRange: CFRange, _ effectiveRange: UnsafeMutablePointer<CFRange>) -> AnyObject!

Objective C

CFTypeRef CFAttributedStringGetAttributeAndLongestEffectiveRange ( CFAttributedStringRef aStr, CFIndex loc, CFStringRef attrName, CFRange inRange, CFRange *longestEffectiveRange );

Параметры

`str`	Приписанная строка для исследования.
`loc`	Расположение в `str` в котором можно определить атрибуты. Это - программная ошибка для `loc` указать расположение вне границ `str`.
`attrName`	Имя атрибута, значение которого Вы хотите определить.
`inRange`	Диапазон в `str` в котором Вы хотите найти самый длинный диапазон измерений атрибутов в `loc`. `inRange` не должен превышать границы `str`.
`effectiveRange`	Если нет `NULL`, по возврату содержит максимальный диапазон в `inRange` по которому тот же самый набор атрибутов применяются. Возвращенный диапазон отсекается к `inRange`.

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

Словарь, содержащий атрибуты str в указанном расположении. Владение соблюдает Получить Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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


    
    CFAttributedStringGetAttributesAndLongestEffectiveRange (_: _: _: _:)
    CFAttributedStringGetAttributesAndLongestEffectiveRange

Возвращает атрибуты приписанной строки в указанном расположении.

Объявление

Swift

func CFAttributedStringGetAttributesAndLongestEffectiveRange(_ str: CFAttributedString!, _ loc: CFIndex, _ inRange: CFRange, _ effectiveRange: UnsafeMutablePointer<CFRange>) -> CFDictionary!

Objective C

CFDictionaryRef CFAttributedStringGetAttributesAndLongestEffectiveRange ( CFAttributedStringRef aStr, CFIndex loc, CFRange inRange, CFRange *longestEffectiveRange );

Параметры

`str`	Приписанная строка для исследования.
`loc`	Расположение в `str` в котором можно определить атрибуты. `loc` не должен превышать границы `str`.
`inRange`	Диапазон в `str` в найти самый длинный диапазон измерений атрибутов в `loc`. `inRange` не должен превышать границы `str`.
`effectiveRange`	Если нет `NULL`, по возврату содержит максимальный диапазон в `inRange` по которому тот же самый набор атрибутов применяются. Возвращенный диапазон отсекается к `inRange`.

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

Словарь, содержащий атрибуты str в указанном расположении. Владение соблюдает Получить Правило.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Получение приписанных свойств строки

CFAttributedStringGetTypeID () CFAttributedStringGetTypeID

Возвращает идентификатор типа для CFAttributedString непрозрачный тип.

Объявление

Swift

func CFAttributedStringGetTypeID() -> CFTypeID

Objective C

CFTypeID CFAttributedStringGetTypeID ( void );

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

Идентификатор типа для CFAttributedString непрозрачный тип.

Обсуждение

Объекты CFMutableAttributedString имеют тот же идентификатор типа как объекты CFAttributedString.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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

Типы данных

CFAttributedStringRef CFAttributedStringRef

Ссылка на объект CFAttributedString.

Объявление

Swift

typealias CFAttributedStringRef = CFAttributedString

Objective C

typedef const struct __CFAttributedString *CFAttributedStringRef;

Обсуждение

CFAttributedStringRef тип относится к объекту, комбинирующему объект CFString с набором атрибутов, указывающих, как символы в строке должны быть выведены на экран. CFAttributedString является непрозрачным типом, определяющим характеристики и поведение объектов CFAttributedString.

Значения типа CFAttributedStringRef может относиться к неизменным или непостоянным строкам, поскольку объекты CFMutableAttributedString реагируют на все функции, предназначенные для неизменных объектов CFAttributedString. Принимающие функции CFAttributedStringRef значения, и который должен держаться за значения неизменно, должны вызвать CFAttributedStringCreateWithSubstring (вместо CFRetain) сделать так.

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

Objective C

@import CoreFoundation;

Swift

import CoreFoundation

Доступность

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