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
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteFontFace2