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
要使用的默认字体集合。
[in, optional] baseFamilyName
类型: const wchar_t*
基本字体的系列名称。 如果传递 null,则不会针对该系列执行匹配。
baseWeight
所需的权重。
baseStyle
所需的样式。
baseStretch
所需的拉伸。
[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 |