IDWriteFontFace1：：GetGdiCompatibleGlyphAdvances 方法 (dwrite_1.h)

傳回字元序列的像素對齊進階。

語法

HRESULT GetGdiCompatibleGlyphAdvances(
                 FLOAT               emSize,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
                 BOOL                isSideways,
                 UINT32              glyphCount,
  [in]           UINT16 const        *glyphIndices,
  [out]          INT32               *glyphAdvances
);

參數

emSize

類型： FLOAT

以 DIP 單位表示字型的邏輯大小。 DIP (「裝置獨立圖元」) 等於1/96英吋。

pixelsPerDip

類型： FLOAT

每個 DIP 的實體像素數目。 例如，如果轉譯介面的 DPI 為 96，則此值為 1.0f。 如果 DPI 為 120，則此值為 120.0f/96。

[in, optional] transform

類型： const DWRITE_MATRIX*

套用至字元及其位置的選擇性轉換。 此轉換會在字型大小和圖元PerDip 指定的縮放之後套用。

useGdiNatural

類型： BOOL

當為 FALSE 時，計量會與 GDI 別名文字 (DWRITE_MEASURING_MODE_GDI_CLASSIC) 相同。 當為TRUE時，計量與 GDI 使用字型使用 CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL) 來測量的計量相同。

isSideways

類型： BOOL

擷取字元的垂直進階，而不是水平前進。

glyphCount

類型： UINT32

擷取調整的字元總數。

[in] glyphIndices

類型： const UINT16*

要擷取進階的字元標識碼數位。

[out] glyphAdvances

類型： const INT32*

傳回的每個圖像的字型設計單位會進階。

傳回值

類型： HRESULT

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

備註

這相當於呼叫 GetGdiCompatibleGlyphMetrics ，並且只使用進階寬度和高度。

就像 GetGdiCompatibleGlyphMetrics 一樣，這些是設計單位，這表示必須縮小DWRITE_FONT_METRICS：:d esignUnitsPerEm。

規格需求

需求	值
最低支援的用戶端	適用於 Windows 7 的 Windows 8 和平臺更新 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	適用於 Windows Server 2008 R2 的 Windows Server 2012 和平臺更新 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	dwrite_1.h
程式庫	Dwrite_1.lib
Dll	Dwrite_1.dll

另請參閱

IDWriteFontFace1