通过

IDWriteFontFace1：：GetRecommendedRenderingMode 方法 (dwrite_1.h)

  • 项目

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

语法

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

参数

fontEmSize

类型： FLOAT

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

dpiX

类型： FLOAT

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

dpiY

类型： FLOAT

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

[in, optional] transform

类型： const DWRITE_MATRIX*

指定世界转换。

isSideways

类型： BOOL

运行中的字形是否侧向。

outlineThreshold

类型： DWRITE_OUTLINE_THRESHOLD

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

measuringMode

类型： DWRITE_MEASURING_MODE

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

[out] renderingMode

类型： DWRITE_RENDERING_MODE*

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

返回值

类型： HRESULT

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

注解

在呈现参数对象的呈现模式DWRITE_RENDERING_MODE_DEFAULT的情况下，应使用此方法来确定实际呈现模式。

要求

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

另请参阅

IDWriteFontFace1