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

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

Разработчик

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

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

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

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

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

Функции

  • Возвращает массив уникальных имен шрифтов 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>) -> CFComparisonResult

    Objective 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>?>) -> 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

    Доступность

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

  • Шрифты нерегистров от указанного шрифта 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

    Доступность

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

  • Шрифты регистров от указанного массива шрифта 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

    Доступность

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

  • Шрифты нерегистров от указанного массива шрифта 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

    Доступность

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

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

    Объявление

    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

    Доступность

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

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

    Объявление

    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

    Доступность

    Доступный в 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!) -> CTFontManagerAutoActivationSetting

    Objective 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!) -> CTFontManagerScope

    Objective 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 и позже.