IDWriteFactory：：CreateGdiCompatibleTextLayout 方法 (dwrite.h)

採用字串、格式和相關聯的條件約束，併產生代表結果的物件，並格式化為特定顯示器解析度和測量模式。

語法

HRESULT CreateGdiCompatibleTextLayout(
  [in]           WCHAR const         *string,
                 UINT32              stringLength,
                 IDWriteTextFormat   *textFormat,
                 FLOAT               layoutWidth,
                 FLOAT               layoutHeight,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
  [out]          IDWriteTextLayout   **textLayout
);

參數

[in] string

類型： const WCHAR*

字元陣列，其中包含要從中建立新 IDWriteTextLayout 物件的字串。 此陣列長度必須為 stringLength ，而且可以包含內嵌 的 NULL 字元。

stringLength

類型： UINT32

字串的長度，以字元計數為單位。

textFormat

類型： IDWriteTextFormat*

要套用至字串的文字格式物件。

layoutWidth

類型： FLOAT

版面配置方塊的寬度。

layoutHeight

類型： FLOAT

版面配置方塊的高度。

pixelsPerDip

類型： FLOAT

每個 DIP (裝置獨立像素的實體像素數目) 。 例如，如果轉譯成 96 DPI 裝置 圖元PerDip 為 1。 如果轉譯為 120 DPI 裝置 圖元PerDip 為 1.25 (120/96) 。

[in, optional] transform

類型： const DWRITE_MATRIX*

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

useGdiNatural

類型： BOOL

指示文字配置在設定為 FALSE 時，使用與 GDI 雙向層級文字相同的計量。 當設定為 TRUE 時，會指示文字版面配置使用與 GDI 所測量的文字相同的計量，並使用以 CLEARTYPE_NATURAL_QUALITY 建立的字型。

[out] textLayout

類型： IDWriteTextLayout**

當這個方法傳回時，會包含結果文字版面配置物件的指標位址。

傳回值

類型： HRESULT

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

備註

產生的文字版面配置應該只用於預定的解析度，以及應該改用文字延展性 CreateTextLayout 的情況。

規格需求

需求	值
最低支援的用戶端	適用於 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.h
程式庫	Dwrite.lib
Dll	Dwrite.dll

另請參閱

IDWriteFactory