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 |