Метод IDWriteFontFallback::MapCharacters (dwrite_2.h)

Определяет подходящий шрифт для отрисовки начального диапазона текста.

Синтаксис

HRESULT MapCharacters(
                 IDWriteTextAnalysisSource *analysisSource,
                 UINT32                    textPosition,
                 UINT32                    textLength,
  [in, optional] IDWriteFontCollection     *baseFontCollection,
  [in, optional] wchar_t const             *baseFamilyName,
                 DWRITE_FONT_WEIGHT        baseWeight,
                 DWRITE_FONT_STYLE         baseStyle,
                 DWRITE_FONT_STRETCH       baseStretch,
  [out]          UINT32                    *mappedLength,
  [out]          IDWriteFont               **mappedFont,
  [out]          FLOAT                     *scale
);

Параметры

analysisSource

Тип: IDWriteTextAnalysisSource*

Реализация источника текста содержит текст и языковой стандарт.

textPosition

Тип: UINT32

Начальная позиция для анализа.

textLength

Тип: UINT32

Длина анализируемого текста.

[in, optional] baseFontCollection

Тип: IDWriteFontCollection*

Используемая коллекция шрифтов по умолчанию.

[in, optional] baseFamilyName

Тип: const wchar_t*

Имя семейства базового шрифта. Если передать значение NULL, сопоставление с семьей выполняться не будет.

baseWeight

Тип: DWRITE_FONT_WEIGHT

Требуемый вес.

baseStyle

Тип: DWRITE_FONT_STYLE

Требуемый стиль.

baseStretch

Тип: DWRITE_FONT_STRETCH

Требуемый растяжение.

[out] mappedLength

Тип: UINT32*

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

[out] mappedFont

Тип: IDWriteFont**

Шрифт, который следует использовать для отрисовки первых сопоставленных символов текста. Если возвращается значение NULL, это означает, что ни одно из шрифтов не может отрисовывать текст, а сопоставленное значениеLength — это количество пропускаемых символов (отрисовка с отсутствующим глифом).

[out] scale

Тип: FLOAT*

Коэффициент масштабирования для умножения размера возвращаемого шрифта на.

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 R2 [только классические приложения]
Целевая платформа	Windows
Header	dwrite_2.h
Библиотека	Dwrite.lib
DLL	Dwrite.dll

См. также раздел

IDWriteFontFallback