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