Поделиться через

Метод IDWriteFontSetBuilder2::AddFont (dwrite_3.h)

  • Статья

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

Синтаксис

HRESULT AddFont(
  IDWriteFontFile              *fontFile,
  UINT32                       fontFaceIndex,
  DWRITE_FONT_SIMULATIONS      fontSimulations,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  DWRITE_FONT_AXIS_RANGE const *fontAxisRanges,
  UINT32                       fontAxisRangeCount,
  DWRITE_FONT_PROPERTY const   *properties,
  UINT32                       propertyCount
);

Параметры

fontFile

Тип: IDWriteFontFile*

Объект ссылки на файл шрифта для добавления в набор.

fontFaceIndex

Тип: UINT32

Отсчитываемый от нуля индекс лица шрифта в коллекции.

fontSimulations

Тип: DWRITE_FONT_SIMULATIONS

Флаги моделирования лиц шрифта для алгоритмического эмболизации и курсивизации.

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

Указатель на массив, содержащий список значений осей шрифта. Массив должен быть размером (число элементов), указанным аргументом fontAxisValueCount.

fontAxisValueCount

Тип: UINT32

Количество значений оси шрифта, содержащихся в массиве fontAxisValues.

fontAxisRanges

Тип: DWRITE_FONT_AXIS_RANGE const *

Список диапазонов осей.

fontAxisRangeCount

Тип: UINT32

Число диапазонов осей.

properties

Тип: DWRITE_FONT_PROPERTY const *

Список свойств для связывания со ссылкой.

propertyCount

Тип: UINT32

Число определенных свойств.

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

Тип: HRESULT

Если функция успешно выполнена, она возвращает S_OK. В противном случае возвращается кодошибки HRESULT.

Замечания

Свойства шрифта должны содержать по крайней мере семейство (типографику или вес/ стиль/растяжение). В противном случае шрифт будет доступен в IDWriteFontSet только по индексу, а не по имени.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Сборка Windows 10 16299
минимальный поддерживаемый сервер Сборка Windows 10 16299
целевая платформа Виндоус
заголовка dwrite_3.h
библиотеки Dwrite.lib