IDWriteFontFace3：：GetRecommendedRenderingMode 方法 (dwrite_3.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_MODE1   *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_MODE1*

變數的指標，接收建議轉譯模式 的DWRITE_RENDERING_MODE1型別值。

[out] gridFitMode

類型： DWRITE_GRID_FIT_MODE*

變數的指標，可接收建議格線調整模式 的DWRITE_GRID_FIT_MODE型別值。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

最低支援的用戶端	Windows 10 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
目標平台	Windows
標頭	dwrite_3.h
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteFontFace3