Базовый менеджер по шрифту текста ссылка
Этот справочный документ описывает функции, и константы раньше управляли шрифтами в Базовом тексте.
-
Возвращает массив уникальных имен шрифтов 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 );Параметры
fontURLURL, относящийся к данным шрифта.
Возвращаемое значение
Возвраты
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;Константы
-
NonekCTFontManagerScopeNoneНикакой объем не определяется.
Доступный в OS X v10.6 и позже.
-
ProcesskCTFontManagerScopeProcessШрифт доступен текущему процессу на время процесса, если не непосредственно незарегистрированный.
Доступный в OS X v10.6 и позже.
-
UserkCTFontManagerScopeUserШрифт доступен всем процессам в течение текущего сеанса пользователя и будет доступен в последующих сеансах, если не незарегистрированный.
Доступный в OS X v10.6 и позже.
-
SessionkCTFontManagerScopeSessionШрифт доступен текущему сеансу пользователя, но не будет доступен в последующих сеансах.
Доступный в 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;Константы
-
DefaultkCTFontManagerAutoActivationDefaultУстановка автоактивации по умолчанию. Когда указано, приложение использует глобальную установку.
Доступный в OS X v10.6 и позже.
-
DisabledkCTFontManagerAutoActivationDisabledОтключает автоактивацию.
Доступный в OS X v10.6 и позже.
-
EnabledkCTFontManagerAutoActivationEnabledВключает автоактивацию.
Доступный в OS X v10.6 и позже.
-
PromptUserkCTFontManagerAutoActivationPromptUserТребует ввода данных пользователем для автоактивации. Диалоговое окно представлено пользователю для подтверждения автоактивации шрифта.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import CoreText;Swift
import CoreTextДоступность
Доступный в OS X v10.6 и позже.
-
-
Эта константа является менеджером по шрифту идентификатор пакета.
Объявление
Swift
let kCTFontManagerBundleIdentifier: CFString!Objective C
const CFStringRef kCTFontManagerBundleIdentifier;Константы
-
kCTFontManagerBundleIdentifierkCTFontManagerBundleIdentifierМенеджер по Шрифту связывает идентификатор, который будет использоваться при получении или установке глобального использования автоактивации
CTFontManagerGetAutoActivationSettingилиCTFontManagerSetAutoActivationSetting.Доступный в OS X v10.6 и позже.
-
-
Имя уведомления для изменений реестра шрифта.
Объявление
Swift
let kCTFontManagerRegisteredFontsChangedNotification: CFString!Objective C
const CFStringRef kCTFontManagerRegisteredFontsChangedNotificationКонстанты
-
kCTFontManagerRegisteredFontsChangedNotificationkCTFontManagerRegisteredFontsChangedNotificationЭто - строка для использования в качестве имени уведомления при подписке на Базового менеджера по Шрифту текста уведомлений. Когда шрифты добавляются к реестру шрифта, это уведомление отправляется. Клиент ответственен за зарегистрированный в распределенном центре уведомления для получения уведомлений для изменений в сеансе или пользовательских объемах, и с локальным центром уведомления изменений в объеме процесса.
Доступный в OS X v10.6 и позже.
-
-
Домен CFError и пользовательский информационный ключ для менеджера по Шрифту ошибки.
Объявление
Swift
let kCTFontManagerErrorDomain: CFString! let kCTFontManagerErrorFontURLsKey: CFString!Objective C
const CFStringRef kCTFontManagerErrorDomain; const CFStringRef kCTFontManagerErrorFontURLsKey;Константы
-
kCTFontManagerErrorDomainkCTFontManagerErrorDomainОбъекты CFError с этим доменом имеют коды ошибки, соответствующие одному из
CTFontManagerErrorошибки, перечисленные в ошибках при регистрации Шрифта и Нерегистрационных Ошибках Шрифта.Доступный в OS X v10.6 и позже.
-
kCTFontManagerErrorFontURLsKeykCTFontManagerErrorFontURLsKeyПользовательский информационный ключ, который будет использоваться со ссылками 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, };Константы
-
FileNotFoundkCTFontManagerErrorFileNotFoundФайл не существует в указанном URL.
Доступный в OS X v10.6 и позже.
-
InsufficientPermissionskCTFontManagerErrorInsufficientPermissionsНе может получить доступ к файлу вследствие недостаточных полномочий.
Доступный в OS X v10.6 и позже.
-
UnrecognizedFormatkCTFontManagerErrorUnrecognizedFormatФайл не является распознанным или поддерживаемым форматом файла шрифтов.
Доступный в OS X v10.6 и позже.
-
InvalidFontDatakCTFontManagerErrorInvalidFontDataФайл содержит недопустимые данные шрифта, которые могли вызвать системные проблемы.
Доступный в OS X v10.6 и позже.
-
AlreadyRegisteredkCTFontManagerErrorAlreadyRegisteredФайл был уже зарегистрирован в указанном объеме.
Доступный в 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;Константы
-
NotRegisteredkCTFontManagerErrorNotRegisteredФайл не регистрируется в указанном объеме.
Доступный в OS X v10.6 и позже.
-
InUsekCTFontManagerErrorInUseФайл шрифтов активно используется и не может быть не зарегистрирован.
Доступный в OS X v10.6 и позже.
-
SystemRequiredkCTFontManagerErrorSystemRequiredФайл требуется системой и не может быть не зарегистрирован.
Доступный в OS X v10.6 и позже.
Оператор импорта
Objective C
@import CoreText;Swift
import CoreTextДоступность
Доступный в OS X v10.6 и позже.
-
