通过

IDWriteFontFace2：：GetRecommendedRenderingMode 方法 (dwrite_2.h)

  • 项目

根据字体、大小、世界转换和度量模式确定建议使用的文本呈现和网格拟合模式。

语法

HRESULT GetRecommendedRenderingMode(
  [in]           FLOAT                    fontEmSize,
  [in]           FLOAT                    dpiX,
  [in]           FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
  [in]           BOOL                     isSideways,
  [in]           DWRITE_OUTLINE_THRESHOLD outlineThreshold,
  [in]           DWRITE_MEASURING_MODE    measuringMode,
  [in, optional] IDWriteRenderingParams   *renderingParams,
  [out]          DWRITE_RENDERING_MODE    *renderingMode,
  [out]          DWRITE_GRID_FIT_MODE     *gridFitMode
);

参数

[in] fontEmSize

类型： FLOAT

DIP 中的逻辑字号。

[in] dpiX

类型： FLOAT

水平方向上每个逻辑英寸的像素数。

[in] dpiY

类型： FLOAT

垂直方向上每个逻辑英寸的像素数。

[in, optional] transform

类型： const DWRITE_MATRIX*

描述世界转换 的DWRITE_MATRIX 结构。

[in] isSideways

类型： BOOL

指定字体是否为侧向。 如果字体侧向，则为 TRUE;否则为 FALSE。

[in] outlineThreshold

类型： DWRITE_OUTLINE_THRESHOLD

一个DWRITE_OUTLINE_THRESHOLD类型的值，该值指定图形系统的轮廓呈现的质量，它会影响使用大纲呈现的大小阈值。

[in] measuringMode

类型： DWRITE_MEASURING_MODE

一个DWRITE_MEASURING_MODE类型的值，该值指定在文本布局期间用于度量的方法。 为了获得正确的字形间距，此方法返回与指定的测量模式兼容的呈现模式。

[in, optional] renderingParams

类型： IDWriteRenderingParams*

指向呈现参数对象的 IDWriteRenderingParams 接口的指针。 如果呈现参数对象替代呈现模式，此参数是必需的。

[out] renderingMode

类型： DWRITE_RENDERING_MODE*

指向变量的指针，该变量接收建议呈现模式的 DWRITE_RENDERING_MODE类型值。

[out] gridFitMode

类型： DWRITE_GRID_FIT_MODE*

指向变量的指针，该变量接收建议的网格拟合模式的 DWRITE_GRID_FIT_MODE类型值。

返回值

类型： HRESULT

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

要求

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

另请参阅

IDWriteFontFace2