Метод IDWriteFactory6::CreateTextFormat (dwrite_3.h)

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

Синтаксис

HRESULT CreateTextFormat(
  WCHAR const                  *fontFamilyName,
  IDWriteFontCollection        *fontCollection,
  DWRITE_FONT_AXIS_VALUE const *fontAxisValues,
  UINT32                       fontAxisValueCount,
  FLOAT                        fontSize,
  WCHAR const                  *localeName,
  IDWriteTextFormat3           **textFormat
);

Параметры

fontFamilyName

Тип: WCHAR const *

Имя семейства шрифтов из коллекции.

fontCollection

Тип: IDWriteFontCollection*

Коллекция шрифтов. Используйте nullptr, чтобы указать коллекцию системных шрифтов.

fontAxisValues

Тип: DWRITE_FONT_AXIS_VALUE const *

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

fontAxisValueCount

Тип: UINT32

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

fontSize

Тип: FLOAT

Логический размер шрифта в единицах DIP.

localeName

Тип: WCHAR const *

Имя языкового стандарта (например, "ja-JP", "en-US", "ar-EG").

textFormat

Тип: IDWriteTextFormat3**

Адрес указателя на интерфейс IDWriteTextFormat3. При успешном завершении функция задает указатель на только что созданный объект форматирования текста, в противном случае он задает указатель на nullptr.

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

Тип: HRESULT

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

Замечания

Если fontCollection nullptr, используется коллекция системных шрифтов, сгруппированная по типографическому имени семейства (DWRITE_FONT_FAMILY_MODEL_TYPOGRAPHIC) без скачиваемых шрифтов.

Требования