Базовый менеджер по шрифту текста ссылка
Этот справочный документ описывает функции, и константы раньше управляли шрифтами в Базовом тексте.
-
Возвращает массив уникальных имен шрифтов PostScript для шрифтов.
Объявление
Swift
func CTFontManagerCopyAvailablePostScriptNames() -> CFArray!
Objective C
CFArrayRef CTFontManagerCopyAvailablePostScriptNames ( void );
Возвращаемое значение
Эта функция возвращает сохраненную ссылку на CFArray
CFStringRef
объекты, представляющие имена PostScript доступных шрифтов, илиNULL
на ошибке. Вызывающая сторона ответственна за выпуск массива.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает массив видимых имен семейства шрифтов, сортированных для экрана интерфейса пользователя.
Объявление
Swift
func CTFontManagerCopyAvailableFontFamilyNames() -> CFArray!
Objective C
CFArrayRef CTFontManagerCopyAvailableFontFamilyNames ( void );
Возвращаемое значение
Эта функция возвращает сохраненную ссылку на CFArray
CFStringRef
объекты, представляющие видимые имена семейства шрифтов доступных шрифтов, илиNULL
на ошибке. Вызывающая сторона ответственна за выпуск массива.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает массив шрифта URLs.
Объявление
Swift
func CTFontManagerCopyAvailableFontURLs() -> CFArray!
Objective C
CFArrayRef CTFontManagerCopyAvailableFontURLs ( void );
Возвращаемое значение
Эта функция возвращает сохраненную ссылку на CFArray
CFStringRef
объекты, представляющие URLs доступных шрифтов, илиNULL
на ошибке. Вызывающая сторона ответственна за выпуск массива.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Функция компаратора, чтобы сравнить имена семейства шрифтов и сортировать их согласно инструкциям Apple.
Объявление
Swift
func CTFontManagerCompareFontFamilyNames(_
family1
: UnsafePointer<Void>, _family2
: UnsafePointer<Void>, _context
: UnsafeMutablePointer<Void>) -> CFComparisonResultObjective C
CFComparisonResult CTFontManagerCompareFontFamilyNames ( const void *family1, const void *family2, void *context );
Параметры
family1
Первое локализованное семейство шрифтов называет для сравнения, как a
CFStringRef
объект.family2
Второе локализованное семейство шрифтов называет для сравнения, как a
CFStringRef
объект.context
Неиспользованный. Может быть
NULL
.Возвращаемое значение
A
CFComparisonResult
значение, указывающее порядок сортировки для этих двух фамилий.kCFComparisonResultGreatherThan
еслиfamily1
больше, чемfamily2
,kCFComparisonResultLessThan
еслиfamily1
меньше, чемfamily2
, иkCFComparisonResultEqualTo
если они равны.Обсуждение
Это
CFComparatorFunction
функция сравнивает имена семейства шрифтов и сортирует их в Apple предпочтенный порядок, составляя префикс литейного завода. Фамилии с распознанными префиксами сортируются после неснабженных префиксом имен в префиксном порядке.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает массив дескрипторов шрифта, представляющих каждый из шрифтов в указанном 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
Доступность
Доступный в OS X v10.6 и позже.
-
Включает или отключает соответствующие дескрипторы шрифта для соответствия дескриптора шрифта.
Объявление
Swift
func CTFontManagerEnableFontDescriptors(_
descriptors
: CFArray!, _enable
: Bool)Objective C
void CTFontManagerEnableFontDescriptors ( CFArrayRef descriptors, bool enable );
Параметры
descriptors
Массив дескрипторов шрифта.
enable
Если
true
, шрифты, соответствующие данные дескрипторы, включены для дескриптора шрифта, соответствующего; еслиfalse
, им не включают.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Шрифты регистров от указанного шрифта URL с менеджером по Шрифту. Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта.
Объявление
Swift
func CTFontManagerRegisterFontsForURL(_
fontURL
: CFURL!, _scope
: CTFontManagerScope, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BoolObjective C
bool CTFontManagerRegisterFontsForURL ( CFURLRef fontURL, CTFontManagerScope scope, CFErrorRef *error );
Параметры
fontURL
Шрифт URL.
scope
Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
error
Указатель на объект CFError, который, в случае неработающей регистрации, содержит информацию об ошибке.
Возвращаемое значение
Возвраты
true
если регистрация шрифтов была успешна, иначеfalse
.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Шрифты нерегистров от указанного шрифта URL с менеджером по Шрифту. Незарегистрированные шрифты больше не являются поддающимися обнаружению посредством соответствия дескриптора шрифта.
Объявление
Swift
func CTFontManagerUnregisterFontsForURL(_
fontURL
: CFURL!, _scope
: CTFontManagerScope, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BoolObjective C
bool CTFontManagerUnregisterFontsForURL ( CFURLRef fontURL, CTFontManagerScope scope, CFErrorRef *error );
Параметры
fontURL
Шрифт URL.
scope
Определите объем постоянного определения доступности и времени жизни регистрации. Посмотрите Регистрационный Объем Шрифта для значений для передачи для этого параметра.
error
Указатель на объект CFError, который, в случае неработающей регистрации, содержит информацию об ошибке.
Возвращаемое значение
Возвраты
true
если нерегистрация шрифтов была успешна, иначеfalse
.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Шрифты регистров от указанного массива шрифта URLs с менеджером по Шрифту. Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта.
Объявление
Swift
func CTFontManagerRegisterFontsForURLs(_
fontURLs
: CFArray!, _scope
: CTFontManagerScope, _errors
: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> BoolObjective 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
Доступность
Доступный в OS X v10.6 и позже.
-
Шрифты нерегистров от указанного массива шрифта URLs с менеджером по Шрифту. Незарегистрированные шрифты больше не являются поддающимися обнаружению посредством соответствия дескриптора шрифта.
Объявление
Swift
func CTFontManagerUnregisterFontsForURLs(_
fontURLs
: CFArray!, _scope
: CTFontManagerScope, _errors
: UnsafeMutablePointer<Unmanaged<CFArray>?>) -> BoolObjective 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
Доступность
Доступный в OS X v10.6 и позже.
-
Регистрирует указанный графический шрифт в менеджере по шрифту.
Объявление
Swift
func CTFontManagerRegisterGraphicsFont(_
font
: CGFont!, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BoolObjective C
bool CTFontManagerRegisterGraphicsFont ( CGFontRef font, CFErrorRef *error );
Параметры
font
Графический шрифт, который будет зарегистрирован.
error
Возвраты косвенно ошибка возражают в случае неработающей регистрации.
Возвращаемое значение
true
если регистрация шрифта была успешна, иначеfalse
.Обсуждение
Зарегистрированные шрифты являются поддающимися обнаружению посредством соответствия дескриптора шрифта. Любая попытка зарегистрировать шрифт, или уже регистрирующийся или содержащий тот же Постскриптум уже зарегистрированного шрифта, перестанет работать. Это поведение полезно для шрифтов, которые могут быть встроены в документы или созданы в памяти. Графический шрифт получен путем вызова
CGFontCreateWithDataProvider
. Шрифты, поддерживающиеся файлами, должны быть зарегистрированы с помощьюCTFontManagerRegisterFontsForURL
.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.8 и позже.
См. также
-
Не регистрирует указанный графический шрифт в менеджере по шрифту.
Объявление
Swift
func CTFontManagerUnregisterGraphicsFont(_
font
: CGFont!, _error
: UnsafeMutablePointer<Unmanaged<CFError>?>) -> BoolObjective C
bool CTFontManagerUnregisterGraphicsFont ( CGFontRef font, CFErrorRef *error );
Параметры
font
Графический шрифт, чтобы быть незарегистрированным.
error
Возвраты косвенно ошибка возражают в случае неработающей нерегистрации.
Возвращаемое значение
true
если нерегистрация шрифта была успешна, иначеfalse
.Обсуждение
Незарегистрированные шрифты больше не являются поддающимися обнаружению посредством соответствия дескриптора шрифта. Шрифты, поддерживающиеся файлами, должны быть незарегистрированным использованием
CTFontManagerUnregisterFontsForURL
.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.8 и позже.
См. также
-
Устанавливает установку автоактивации для указанного идентификатора пакета.
Объявление
Swift
func CTFontManagerSetAutoActivationSetting(_
bundleIdentifier
: CFString!, _setting
: CTFontManagerAutoActivationSetting)Objective C
void CTFontManagerSetAutoActivationSetting ( CFStringRef bundleIdentifier, CTFontManagerAutoActivationSetting setting );
Параметры
bundleIdentifier
Идентификатор пакета раньше указывал определенный комплект приложений. Если
NULL
, текущий комплект приложений используется. ЕслиkCTFontManagerBundleIdentifier
указан, глобальная автоактивация наборов.setting
Новая установка. Посмотрите Настройки Автоактивации Шрифта для возможных значений.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Получает установку автоактивации для указанного идентификатора пакета.
Объявление
Swift
func CTFontManagerGetAutoActivationSetting(_
bundleIdentifier
: CFString!) -> CTFontManagerAutoActivationSettingObjective C
CTFontManagerAutoActivationSetting CTFontManagerGetAutoActivationSetting ( CFStringRef bundleIdentifier );
Параметры
bundleIdentifier
Идентификатор пакета раньше указывал определенный комплект приложений. Если
NULL
, текущий комплект приложений используется. ЕслиkCTFontManagerBundleIdentifier
указан, получает глобальную установку автоактивации.Возвращаемое значение
Установка автоактивации для указанного идентификатора пакета. Посмотрите Настройки Автоактивации Шрифта для возможных значений.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Возвращает регистрационный объем указанного URL.
Объявление
Swift
func CTFontManagerGetScopeForURL(_
fontURL
: CFURL!) -> CTFontManagerScopeObjective C
CTFontManagerScope CTFontManagerGetScopeForURL ( CFURLRef fontURL );
Параметры
fontURL
Шрифт URL.
Возвращаемое значение
Регистрационный объем указанного URL или
kCTFontManagerScopeNone
если не в настоящее время регистрируемый.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Определяет, поддерживаются ли данные шрифта, на которые ссылаются (обычно файлом URL) на текущей платформе.
Объявление
Objective C
bool CTFontManagerIsSupportedFont( CFURLRef fontURL );
Параметры
fontURL
URL, относящийся к данным шрифта.
Возвращаемое значение
Возвраты
true
если URL относится к допустимому шрифту, который может использоваться на текущей платформе;false
иначе.
-
Создает ссылку на источник цикла выполнения, используемый для передачи запросов шрифта от менеджера по Шрифту.
Объявление
Swift
func CTFontManagerCreateFontRequestRunLoopSource(_
sourceOrder
: CFIndex, _createMatchesCallback
: ((CFDictionary!, pid_t) -> Unmanaged<CFArray>!)!) -> CFRunLoopSource!Objective C
CFRunLoopSourceRef CTFontManagerCreateFontRequestRunLoopSource ( CFIndex sourceOrder, CFArrayRef (^createMatchesCallback)( CFDictionaryRef requestAttributes, pid_t requestingProcess) );
Параметры
sourceOrder
Порядок создаваемого источника цикла выполнения.
createMatchesCallback
Блок для обрабатывания запроса шрифта.
Возвращаемое значение
Ссылка на объект CFRunLoopSource, который должен быть добавлен к циклу выполнения. Чтобы прекратить получать запросы, лишите законной силы этот источник цикла выполнения. Возвраты
NULL
на ошибке, в случае копииrequestPortName
, или недопустимая структура контекста.Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
Эти константы определяют объем для регистрации шрифта.
Объявление
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
Никакой объем не определяется.
Доступный в OS X v10.6 и позже.
-
Process
kCTFontManagerScopeProcess
Шрифт доступен текущему процессу на время процесса, если не непосредственно незарегистрированный.
Доступный в OS X v10.6 и позже.
-
User
kCTFontManagerScopeUser
Шрифт доступен всем процессам в течение текущего сеанса пользователя и будет доступен в последующих сеансах, если не незарегистрированный.
Доступный в OS X v10.6 и позже.
-
Session
kCTFontManagerScopeSession
Шрифт доступен текущему сеансу пользователя, но не будет доступен в последующих сеансах.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
-
Устанавливает автоактивацию для указанного идентификатора пакета.
Объявление
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
Установка автоактивации по умолчанию. Когда указано, приложение использует глобальную установку.
Доступный в OS X v10.6 и позже.
-
Disabled
kCTFontManagerAutoActivationDisabled
Отключает автоактивацию.
Доступный в OS X v10.6 и позже.
-
Enabled
kCTFontManagerAutoActivationEnabled
Включает автоактивацию.
Доступный в OS X v10.6 и позже.
-
PromptUser
kCTFontManagerAutoActivationPromptUser
Требует ввода данных пользователем для автоактивации. Диалоговое окно представлено пользователю для подтверждения автоактивации шрифта.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-
-
Эта константа является менеджером по шрифту идентификатор пакета.
Объявление
Swift
let kCTFontManagerBundleIdentifier: CFString!
Objective C
const CFStringRef kCTFontManagerBundleIdentifier;
Константы
-
kCTFontManagerBundleIdentifier
kCTFontManagerBundleIdentifier
Менеджер по Шрифту связывает идентификатор, который будет использоваться при получении или установке глобального использования автоактивации
CTFontManagerGetAutoActivationSetting
илиCTFontManagerSetAutoActivationSetting
.Доступный в OS X v10.6 и позже.
-
-
Имя уведомления для изменений реестра шрифта.
Объявление
Swift
let kCTFontManagerRegisteredFontsChangedNotification: CFString!
Objective C
const CFStringRef kCTFontManagerRegisteredFontsChangedNotification
Константы
-
kCTFontManagerRegisteredFontsChangedNotification
kCTFontManagerRegisteredFontsChangedNotification
Это - строка для использования в качестве имени уведомления при подписке на Базового менеджера по Шрифту текста уведомлений. Когда шрифты добавляются к реестру шрифта, это уведомление отправляется. Клиент ответственен за зарегистрированный в распределенном центре уведомления для получения уведомлений для изменений в сеансе или пользовательских объемах, и с локальным центром уведомления изменений в объеме процесса.
Доступный в OS X v10.6 и позже.
-
-
Домен CFError и пользовательский информационный ключ для менеджера по Шрифту ошибки.
Объявление
Swift
let kCTFontManagerErrorDomain: CFString! let kCTFontManagerErrorFontURLsKey: CFString!
Objective C
const CFStringRef kCTFontManagerErrorDomain; const CFStringRef kCTFontManagerErrorFontURLsKey;
Константы
-
kCTFontManagerErrorDomain
kCTFontManagerErrorDomain
Объекты CFError с этим доменом имеют коды ошибки, соответствующие одному из
CTFontManagerError
ошибки, перечисленные в ошибках при регистрации Шрифта и Нерегистрационных Ошибках Шрифта.Доступный в OS X v10.6 и позже.
-
kCTFontManagerErrorFontURLsKey
kCTFontManagerErrorFontURLsKey
Пользовательский информационный ключ, который будет использоваться со ссылками CFError, возвратился из регистрационных функций. Значение, связанное с этим ключом в пользовательском информационном словаре объекта CFError, является CFArray шрифта URLs, переставший работать с данной ошибкой.
Доступный в OS X v10.6 и позже.
-
-
Ошибки, которые предотвратили бы регистрацию шрифтов для указанного файла шрифтов 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.
Доступный в OS X v10.6 и позже.
-
InsufficientPermissions
kCTFontManagerErrorInsufficientPermissions
Не может получить доступ к файлу вследствие недостаточных полномочий.
Доступный в OS X v10.6 и позже.
-
UnrecognizedFormat
kCTFontManagerErrorUnrecognizedFormat
Файл не является распознанным или поддерживаемым форматом файла шрифтов.
Доступный в OS X v10.6 и позже.
-
InvalidFontData
kCTFontManagerErrorInvalidFontData
Файл содержит недопустимые данные шрифта, которые могли вызвать системные проблемы.
Доступный в OS X v10.6 и позже.
-
AlreadyRegistered
kCTFontManagerErrorAlreadyRegistered
Файл был уже зарегистрирован в указанном объеме.
Доступный в OS X v10.6 и позже.
-
-
Ошибки, которые предотвратили бы нерегистрацию шрифтов для указанного файла шрифтов 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
Файл не регистрируется в указанном объеме.
Доступный в OS X v10.6 и позже.
-
InUse
kCTFontManagerErrorInUse
Файл шрифтов активно используется и не может быть не зарегистрирован.
Доступный в OS X v10.6 и позже.
-
SystemRequired
kCTFontManagerErrorSystemRequired
Файл требуется системой и не может быть не зарегистрирован.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import CoreText;
Swift
import CoreText
Доступность
Доступный в OS X v10.6 и позже.
-