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 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應