IDWriteFontFace::GetRecommendedRenderingMode 方法 (dwrite.h)

使用指定的大小和呈现参数确定字体的建议呈现模式。

语法

HRESULT GetRecommendedRenderingMode(
        FLOAT                  emSize,
        FLOAT                  pixelsPerDip,
        DWRITE_MEASURING_MODE  measuringMode,
        IDWriteRenderingParams *renderingParams,
  [out] DWRITE_RENDERING_MODE  *renderingMode
);

参数

emSize

类型: FLOAT

字体的逻辑大小(以 DIP 为单位)。 DIP (“与设备无关的像素”) 等于 1/96 英寸。

pixelsPerDip

类型: FLOAT

每个 DIP 的物理像素数。 例如,如果呈现图面的 DPI 为 96,则此值为 1.0f。 如果 DPI 为 120,则此值为 120.0f/96。

measuringMode

类型: DWRITE_MEASURING_MODE

将用于字体字形的测量方法。 呈现器实现可能会为不同的测量方法选择不同的呈现模式,例如:

renderingParams

类型: IDWriteRenderingParams*

指向对象的指针,该对象包含呈现设置,例如伽玛级别、增强对比度和 ClearType 级别。 如果呈现参数对象替代呈现模式,则此参数是必需的。

[out] renderingMode

类型: DWRITE_RENDERING_MODE*

此方法返回时,包含一个值,该值指示要使用的建议呈现模式。

返回值

类型: HRESULT

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

要求

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

另请参阅

IDWriteFontFace