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,则表示没有字体可以呈现文本,而 mappedLength 是用缺少字形) 呈现 (要跳过的字符数。

[out] scale

类型: FLOAT*

将返回的字体的 em 大小乘以的比例因子。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

要求
最低受支持的客户端 Windows 8.1 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 R2 [仅限桌面应用]
目标平台 Windows
标头 dwrite_2.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteFontFallback