共用方式為

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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 dwrite_1.h
程式庫 Dwrite_1.lib
Dll Dwrite_1.dll

另請參閱

IDWriteFontFace1