Ссылка CTFontCollection

CTFontCollection непрозрачный тип представляет набор шрифта, т.е. группу дескрипторов шрифта, взятых вместе в качестве отдельного объекта.

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

Функции

Создание наборов шрифта

CTFontCollectionCreateFromAvailableFonts (_:) CTFontCollectionCreateFromAvailableFonts

Возвращает новый набор шрифта, содержащий все доступные шрифты.

Объявление

Swift

func CTFontCollectionCreateFromAvailableFonts(_ options: CFDictionary!) -> CTFontCollection!

Objective C

CTFontCollectionRef CTFontCollectionCreateFromAvailableFonts ( CFDictionaryRef options );

Параметры

options

Словарь опций. Для возможных значений посмотрите Константы.

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

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontCollectionCreateWithFontDescriptors (_: _:)
    CTFontCollectionCreateWithFontDescriptors

Возвращает новый набор шрифта на основе данного массива дескрипторов шрифта.

Объявление

Swift

func CTFontCollectionCreateWithFontDescriptors(_ descriptors: CFArray!, _ options: CFDictionary!) -> CTFontCollection!

Objective C

CTFontCollectionRef CTFontCollectionCreateWithFontDescriptors ( CFArrayRef queryDescriptors, CFDictionaryRef options );

Параметры

`descriptors`	Массив дескрипторов шрифта.
`options`	Словарь опций. Для возможных значений посмотрите Константы.

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

Новый набор шрифта на основе предоставленных дескрипторов шрифта.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontCollectionCreateCopyWithFontDescriptors (_: _: _:)
    CTFontCollectionCreateCopyWithFontDescriptors

Возвращает копию исходного набора, увеличенного с данными новыми дескрипторами шрифта.

Объявление

Swift

func CTFontCollectionCreateCopyWithFontDescriptors(_ original: CTFontCollection!, _ descriptors: CFArray!, _ options: CFDictionary!) -> CTFontCollection!

Objective C

CTFontCollectionRef CTFontCollectionCreateCopyWithFontDescriptors ( CTFontCollectionRef original, CFArrayRef queryDescriptors, CFDictionaryRef options );

Параметры

`original`	Исходная ссылка набора шрифта.
`descriptors`	Массив дескрипторов шрифта для увеличения тех из исходного набора.
`options`	Словарь опций. Для возможных значений посмотрите Константы.

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

Копия исходного набора шрифта, увеличенного новыми дескрипторами шрифта и опциями.

Обсуждение

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Получение дескрипторов шрифта

CTFontCollectionCreateMatchingFontDescriptors (_:) CTFontCollectionCreateMatchingFontDescriptors

Возвращает массив дескрипторов шрифта, соответствующих набор.

Объявление

Swift

func CTFontCollectionCreateMatchingFontDescriptors(_ collection: CTFontCollection!) -> CFArray!

Objective C

CFArrayRef CTFontCollectionCreateMatchingFontDescriptors ( CTFontCollectionRef collection );

Параметры

collection

Ссылка набора шрифта.

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

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

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontCollectionCreateMatchingFontDescriptorsSortedWithCallback (_: _: _:)
    CTFontCollectionCreateMatchingFontDescriptorsSortedWithCallback

Возвращает массив соответствия дескрипторов шрифта, сортированных с функцией обратного вызова.

Объявление

Swift

func CTFontCollectionCreateMatchingFontDescriptorsSortedWithCallback(_ collection: CTFontCollection!, _ sortCallback: CTFontCollectionSortDescriptorsCallback, _ refCon: UnsafeMutablePointer<Void>) -> CFArray!

Objective C

CFArrayRef CTFontCollectionCreateMatchingFontDescriptorsSortedWithCallback ( CTFontCollectionRef collection, CTFontCollectionSortDescriptorsCallback sortCallback, void *refCon );

Параметры

`collection`	Ссылка набора.
`sortCallback`	Функция обратного вызова сортировки, определяющая порядок сортировки.
`refCon`	Указатель на клиентские данные определяет контекст для обратного вызова.

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

Массив дескрипторов шрифта, соответствующих критерии набора, сортируется результатами функции обратного вызова сортировки.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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


    
    CTFontCollectionSortDescriptorsCallback
    CTFontCollectionSortDescriptorsCallback

Возвращает соответствующие дескрипторы шрифта набора в сортированном порядке.

Объявление

Objective C

typedef CFComparisonResult (*CTFontCollectionSortDescriptorsCallback) ( CTFontDescriptorRef first, CTFontDescriptorRef second, void *refCon);

Параметры

`CTFontDescriptorRef first`	Первый дескриптор.
`CTFontDescriptorRef second`	Второй дескриптор.
`refCon`	Указатель на клиентские данные определяет контекст для обратного вызова.

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

Соответствующие дескрипторы шрифта набора в сортированном порядке.

Получение идентификатора типа

CTFontCollectionGetTypeID () CTFontCollectionGetTypeID

Возвращает идентификатор типа для Базовых ссылок набора Шрифта текста.

Объявление

Swift

func CTFontCollectionGetTypeID() -> CFTypeID

Objective C

CFTypeID CTFontCollectionGetTypeID ( void );

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

Идентификатор для непрозрачного типа CTFontCollection.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Типы данных

CTFontCollectionRef CTFontCollectionRef

Ссылка на набор шрифта.

Объявление

Swift

typealias CTFontCollectionRef = CTFontCollection

Objective C

typedef const struct __CTFontCollection * CTFontCollectionRef;

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Ссылка на непостоянный набор шрифта.

Объявление

Swift

typealias CTMutableFontCollectionRef = CTMutableFontCollection

Objective C

typedef struct __CTFontCollection * CTMutableFontCollectionRef;

Обсуждение

Непрозрачная ссылка на непостоянный набор шрифта.

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

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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

Константы

kCTFontCollectionRemoveDuplicatesOption
Функциональная клавиша для указания фильтрации копий.

Объявление

Swift

let kCTFontCollectionRemoveDuplicatesOption: CFString!

Objective C

const CFStringRef kCTFontCollectionRemoveDuplicatesOption;

Константы
- kCTFontCollectionRemoveDuplicatesOption
  
  kCTFontCollectionRemoveDuplicatesOption
  
  Функциональная клавиша для указания фильтрации копий.
  
  Доступный в OS X v10.5 и позже.
Обсуждение

Укажите эту функциональную клавишу в словаре опций с ненулевым значением для включения автоматической фильтрации двойных дескрипторов шрифта.
CTFontCollectionCopyOptions
Биты опции для использования с CTFontCollectionCopyFontAttribute (s).

Объявление

Swift

typealias CTFontCollectionCopyOptions = UInt32

Objective C

enum { kCTFontCollectionCopyDefaultOptions = 0, kCTFontCollectionCopyUnique = (1L << 0), kCTFontCollectionCopyStandardSort = (1L << 1) }; typedef uint32_t CTFontCollectionCopyOptions;

Константы
- kCTFontCollectionCopyDefaultOptions
  
  kCTFontCollectionCopyDefaultOptions
  
  Передача этой опции указывает, что должны использоваться значения по умолчанию.
  
  Доступный в OS X v10.7 и позже.
- kCTFontCollectionCopyStandardSort
  
  kCTFontCollectionCopyStandardSort
  
  Передача этой опции указывает, что возвращаемые значения должны быть сортированы в стандартном порядке UI, подходящем для дисплея пользователю. Это - то же поведение сортировки, используемое NSFontPanel и книга шрифта.
  
  Доступный в OS X v10.7 и позже.
- kCTFontCollectionCopyUnique
  
  kCTFontCollectionCopyUnique
  
  Передача этой опции указывает, что двойные значения должны быть удалены из результатов.
  
  Доступный в OS X v10.7 и позже.
Оператор импорта

Objective C

@import CoreText;

Swift

import CoreText

Доступность

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