IDWriteTextAnalyzer1::GetBaseline 方法 (dwrite_1.h)

从字体中检索给定基线。

语法

HRESULT GetBaseline(
                 IDWriteFontFace        *fontFace,
                 DWRITE_BASELINE        baseline,
                 BOOL                   isVertical,
                 BOOL                   isSimulationAllowed,
                 DWRITE_SCRIPT_ANALYSIS scriptAnalysis,
  [in, optional] WCHAR const            *localeName,
  [out]          INT32                  *baselineCoordinate,
  [out]          BOOL                   *exists
);

参数

fontFace

类型: IDWriteFontFace*

要读取的字体。

baseline

类型: DWRITE_BASELINE

一个DWRITE_BASELINE类型的值,该值指定感兴趣的基线。

isVertical

类型: BOOL

基线是垂直还是水平。

isSimulationAllowed

类型: BOOL

如果字体中缺少基线,请模拟基线。

scriptAnalysis

类型: DWRITE_SCRIPT_ANALYSIS

来自 AnalyzeScript 的脚本分析结果。

注意 可以传递空脚本分析结构,如下所示 DWRITE_SCRIPT_ANALYSIS scriptAnalysis = {};,此方法将返回默认基线。
 

[in, optional] localeName

类型: const WCHAR*

运行的语言。

[out] baselineCoordinate

类型: INT32*

以设计单位表示的基线坐标值。

[out] exists

类型: BOOL*

字体中是否存在返回的基线。

返回值

类型: HRESULT

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

注解

如果字体中不存在基线,则不会将其视为错误,但函数将返回 exists = false。 然后,可以使用启发法来计算缺失的基数,或者,如果标志 simulationAllowed 为 true,则该函数将为你计算合理的近似值。

要求

要求
最低受支持的客户端 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite_1.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteTextAnalyzer1