Базовый менеджер по шрифту текста ссылка

Наследование

Не применимый

Соответствует

Не применимый

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

Swift

import CoreText

Objective C

@import CoreText;

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

Функции

Создание и включение дескрипторов шрифта

CTFontManagerCreateFontDescriptorsFromURL (_:) CTFontManagerCreateFontDescriptorsFromURL

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

Объявление

Swift

func CTFontManagerCreateFontDescriptorsFromURL(_ fileURL: CFURL!) -> CFArray!

Objective C

CFArrayRef CTFontManagerCreateFontDescriptorsFromURL ( CFURLRef fileURL );

Параметры

fileURL

Файловая система URL, ссылающийся на допустимый файл шрифтов.

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

Эта функция возвращает сохраненную ссылку на CFArray CTFontDescriptorRef объекты, или NULL на ошибке. Вызывающая сторона ответственна за выпуск массива.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Регистрация и активация шрифтов


    
    CTFontManagerRegisterFontsForURL (_: _: _:)
    CTFontManagerRegisterFontsForURL

Шрифты регистров от указанного шрифта URL с менеджером по Шрифту. Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта.

Объявление

Swift

func CTFontManagerRegisterFontsForURL(_ fontURL: CFURL!, _ scope: CTFontManagerScope, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Bool

Objective C

bool CTFontManagerRegisterFontsForURL ( CFURLRef fontURL, CTFontManagerScope scope, CFErrorRef *error );

Параметры

`fontURL`	Шрифт URL.
`scope`	Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
`error`	Указатель на объект CFError, который, в случае неработающей регистрации, содержит информацию об ошибке.

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

Возвраты true если регистрация шрифтов была успешна, иначе false.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontManagerUnregisterFontsForURL (_: _: _:)
    CTFontManagerUnregisterFontsForURL

Шрифты нерегистров от указанного шрифта URL с менеджером по Шрифту. Незарегистрированные шрифты больше не являются поддающимися обнаружению посредством соответствия дескриптора шрифта.

Объявление

Swift

func CTFontManagerUnregisterFontsForURL(_ fontURL: CFURL!, _ scope: CTFontManagerScope, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Bool

Objective C

bool CTFontManagerUnregisterFontsForURL ( CFURLRef fontURL, CTFontManagerScope scope, CFErrorRef *error );

Параметры

`fontURL`	Шрифт URL.
`scope`	Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
`error`	Указатель на объект CFError, который, в случае неработающей регистрации, содержит информацию об ошибке.

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

Возвраты true если нерегистрация шрифтов была успешна, иначе false.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontManagerRegisterFontsForURLs (_: _: _:)
    CTFontManagerRegisterFontsForURLs

Шрифты регистров от указанного массива шрифта URLs с менеджером по Шрифту. Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта.

Объявление

Swift

func CTFontManagerRegisterFontsForURLs(_ fontURLs: CFArray!, _ scope: CTFontManagerScope, _ errors: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> Bool

Objective C

bool CTFontManagerRegisterFontsForURLs ( CFArrayRef fontURLs, CTFontManagerScope scope, CFArrayRef *errors );

Параметры

`fontURLs`	Массив шрифта URLs.
`scope`	Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
`errors`	Указатель на массив объектов CFError, которые, в случае неработающей регистрации, содержат информацию об ошибке. Каждая ошибка содержит CFArray шрифта соответствие URLs `kCTFontManagerErrorFontURLsKey`. Этот URLs представляет файлы шрифтов, вызвавшие ошибку и успешно не зарегистрированные. Массив должен быть выпущен вызывающей стороной. Может быть `NULL`.

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

Возвраты true если регистрация всего шрифта URLs была успешна, иначе false.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontManagerUnregisterFontsForURLs (_: _: _:)
    CTFontManagerUnregisterFontsForURLs

Шрифты нерегистров от указанного массива шрифта URLs с менеджером по Шрифту. Незарегистрированные шрифты больше не являются поддающимися обнаружению посредством соответствия дескриптора шрифта.

Объявление

Swift

func CTFontManagerUnregisterFontsForURLs(_ fontURLs: CFArray!, _ scope: CTFontManagerScope, _ errors: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> Bool

Objective C

bool CTFontManagerUnregisterFontsForURLs ( CFArrayRef fontURLs, CTFontManagerScope scope, CFArrayRef *errors );

Параметры

`fontURLs`	Массив шрифта URLs.
`scope`	Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
`errors`	Указатель на массив объектов CFError, которые, в случае неработающей регистрации, содержат информацию об ошибке. Каждая ошибка содержит CFArray шрифта соответствие URLs `kCTFontManagerErrorFontURLsKey`. Этот URLs представляет файлы шрифтов, вызвавшие ошибку и успешно не зарегистрированные. Массив должен быть выпущен вызывающей стороной. Может быть `NULL`.

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

Возвраты true если нерегистрация всего шрифта URLs была успешна, иначе false.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontManagerRegisterGraphicsFont (_: _:)
    CTFontManagerRegisterGraphicsFont

Регистрирует указанный графический шрифт в менеджере по шрифту.

Объявление

Swift

func CTFontManagerRegisterGraphicsFont(_ font: CGFont!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Bool

Objective C

bool CTFontManagerRegisterGraphicsFont ( CGFontRef font, CFErrorRef *error );

Параметры

`font`	Графический шрифт, который будет зарегистрирован.
`error`	Возвраты косвенно ошибка возражают в случае неработающей регистрации.

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

true если регистрация шрифта была успешна, иначе false.

Обсуждение

Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта. Любая попытка зарегистрировать шрифт, или уже регистрирующийся или содержащий тот же Постскриптум уже зарегистрированного шрифта, перестанет работать. Это поведение полезно для шрифтов, которые могут быть встроены в документы или созданы в памяти. Графический шрифт получен путем вызова CGFontCreateWithDataProvider. Шрифты, поддерживающиеся файлами, должны быть зарегистрированы с помощью CTFontManagerRegisterFontsForURL.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

См. также

CTFontManagerUnregisterGraphicsFont


    
    CTFontManagerUnregisterGraphicsFont (_: _:)
    CTFontManagerUnregisterGraphicsFont

Не регистрирует указанный графический шрифт в менеджере по шрифту.

Объявление

Swift

func CTFontManagerUnregisterGraphicsFont(_ font: CGFont!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>) -> Bool

Objective C

bool CTFontManagerUnregisterGraphicsFont ( CGFontRef font, CFErrorRef *error );

Параметры

`font`	Графический шрифт, чтобы быть незарегистрированным.
`error`	Возвраты косвенно ошибка возражают в случае неработающей нерегистрации.

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

true если нерегистрация шрифта была успешна, иначе false.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

См. также

CTFontManagerRegisterGraphicsFont

Проверка файлов шрифтов

CTFontManagerIsSupportedFontFile

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

Объявление

Objective C

bool CTFontManagerIsSupportedFont( CFURLRef fontURL );

Параметры

fontURL

URL, относящийся к данным шрифта.

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

Возвраты true если URL относится к допустимому шрифту, который может использоваться на текущей платформе; false иначе.

Константы

Регистрационный объем шрифта
Эти константы определяют объем для регистрации шрифта.

Объявление

Swift

enum CTFontManagerScope : UInt32 { case None case Process case User case Session }

Objective C

enum { kCTFontManagerScopeNone = 0, kCTFontManagerScopeProcess = 1, kCTFontManagerScopeUser = 2, kCTFontManagerScopeSession = 3 }; typedef uint32_t CTFontManagerScope;

Константы
- None
  
  kCTFontManagerScopeNone
  
  Никакой объем не определяется.
  
  Доступный в iOS 4.1 и позже.
- Process
  
  kCTFontManagerScopeProcess
  
  Шрифт доступен текущему процессу на время процесса, если не непосредственно незарегистрированный.
  
  Доступный в iOS 4.1 и позже.
- User
  
  kCTFontManagerScopeUser
  
  Шрифт доступен всем процессам в течение текущего сеанса пользователя и будет доступен в последующих сеансах, если не незарегистрированный.
  
  Доступный в iOS 4.1 и позже.
- Session
  
  kCTFontManagerScopeSession
  
  Шрифт доступен текущему сеансу пользователя, но не будет доступен в последующих сеансах.
  
  Доступный в iOS 4.1 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в iOS 4.1 и позже.
Настройки автоактивации шрифта
Устанавливает автоактивацию для указанного идентификатора пакета.

Объявление

Swift

enum CTFontManagerAutoActivationSetting : UInt32 { case Default case Disabled case Enabled case PromptUser }

Objective C

enum { kCTFontManagerAutoActivationDefault = 0, kCTFontManagerAutoActivationDisabled = 1, kCTFontManagerAutoActivationEnabled = 2, kCTFontManagerAutoActivationPromptUser = 3 }; typedef uint32_t CTFontManagerAutoActivationSetting;

Константы
- Default
  
  kCTFontManagerAutoActivationDefault
  
  Установка автоактивации по умолчанию. Когда указано, приложение использует глобальную установку.
  
  Доступный в iOS 4.1 и позже.
- Disabled
  
  kCTFontManagerAutoActivationDisabled
  
  Отключает автоактивацию.
  
  Доступный в iOS 4.1 и позже.
- Enabled
  
  kCTFontManagerAutoActivationEnabled
  
  Включает автоактивацию.
  
  Доступный в iOS 4.1 и позже.
- PromptUser
  
  kCTFontManagerAutoActivationPromptUser
  
  Требует ввода данных пользователем для автоактивации. Диалоговое окно представлено пользователю для подтверждения автоактивации шрифта.
  
  Доступный в iOS 4.1 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

Доступный в iOS 4.1 и позже.
Уведомление изменения реестра шрифта
Имя уведомления для изменений реестра шрифта.

Объявление

Swift

let kCTFontManagerRegisteredFontsChangedNotification: CFString!

Objective C

const CFStringRef kCTFontManagerRegisteredFontsChangedNotification

Константы
- kCTFontManagerRegisteredFontsChangedNotification
  
  Это - строка для использования в качестве имени уведомления при подписке на Базового менеджера по Шрифту текста уведомлений. Когда шрифты добавляются к реестру шрифта, это уведомление отправляется. Клиент ответственен за зарегистрированный в распределенном центре уведомления для получения уведомлений для изменений в сеансе или пользовательских объемах, и с локальным центром уведомления изменений в объеме процесса.
  
  Доступный в iOS 7.0 и позже.
Менеджер по шрифту ошибочный домен и пользовательский информационный ключ
Домен CFError и пользовательский информационный ключ для менеджера по Шрифту ошибки.

Объявление

Swift

let kCTFontManagerErrorDomain: CFString! let kCTFontManagerErrorFontURLsKey: CFString!

Objective C

const CFStringRef kCTFontManagerErrorDomain; const CFStringRef kCTFontManagerErrorFontURLsKey;

Константы
- kCTFontManagerErrorDomain
  
  Объекты CFError с этим доменом имеют коды ошибки, соответствующие одному из CTFontManagerError ошибки, перечисленные в ошибках при регистрации Шрифта и Нерегистрационных Ошибках Шрифта.
  
  Доступный в iOS 3.2 и позже.
- kCTFontManagerErrorFontURLsKey
  
  Пользовательский информационный ключ, который будет использоваться со ссылками CFError, возвратился из регистрационных функций. Значение, связанное с этим ключом в пользовательском информационном словаре объекта CFError, является CFArray шрифта URLs, переставший работать с данной ошибкой.
  
  Доступный в iOS 3.2 и позже.
Ошибки при регистрации шрифта
Ошибки, которые предотвратили бы регистрацию шрифтов для указанного файла шрифтов URL.

Объявление

Swift

enum CTFontManagerError : CFIndex { case FileNotFound case InsufficientPermissions case UnrecognizedFormat case InvalidFontData case AlreadyRegistered case NotRegistered case InUse case SystemRequired }

Objective C

enum { kCTFontManagerErrorFileNotFound = 101, kCTFontManagerErrorInsufficientPermissions = 102, kCTFontManagerErrorUnrecognizedFormat = 103, kCTFontManagerErrorInvalidFontData = 104, kCTFontManagerErrorAlreadyRegistered = 105, };

Константы
- FileNotFound
  
  kCTFontManagerErrorFileNotFound
  
  Файл не существует в указанном URL.
  
  Доступный в iOS 4.1 и позже.
- InsufficientPermissions
  
  kCTFontManagerErrorInsufficientPermissions
  
  Не может получить доступ к файлу вследствие недостаточных полномочий.
  
  Доступный в iOS 4.1 и позже.
- UnrecognizedFormat
  
  kCTFontManagerErrorUnrecognizedFormat
  
  Файл не является распознанным или поддерживаемым форматом файла шрифтов.
  
  Доступный в iOS 4.1 и позже.
- InvalidFontData
  
  kCTFontManagerErrorInvalidFontData
  
  Файл содержит недопустимые данные шрифта, которые могли вызвать системные проблемы.
  
  Доступный в iOS 4.1 и позже.
- AlreadyRegistered
  
  kCTFontManagerErrorAlreadyRegistered
  
  Файл был уже зарегистрирован в указанном объеме.
  
  Доступный в iOS 4.1 и позже.
Нерегистрационные ошибки шрифта
Ошибки, которые предотвратили бы нерегистрацию шрифтов для указанного файла шрифтов URL.

Объявление

Swift

enum CTFontManagerError : CFIndex { case FileNotFound case InsufficientPermissions case UnrecognizedFormat case InvalidFontData case AlreadyRegistered case NotRegistered case InUse case SystemRequired }

Objective C

enum { kCTFontManagerErrorNotRegistered = 201, kCTFontManagerErrorInUse = 202, kCTFontManagerErrorSystemRequired = 202, }; typedef CFIndex CTFontManagerError;

Константы
- NotRegistered
  
  kCTFontManagerErrorNotRegistered
  
  Файл не регистрируется в указанном объеме.
  
  Доступный в iOS 4.1 и позже.
- InUse
  
  kCTFontManagerErrorInUse
  
  Файл шрифтов активно используется и не может быть не зарегистрирован.
  
  Доступный в iOS 4.1 и позже.
- SystemRequired
  
  kCTFontManagerErrorSystemRequired
  
  Файл требуется системой и не может быть не зарегистрирован.
  
  Доступный в iOS 4.1 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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