ID2D1RenderTarget：:D rawTextLayout 方法 (d2d1.h)
繪製指定的 IDWriteTextLayout 物件所描述的格式化文字。
語法
void DrawTextLayout(
D2D1_POINT_2F origin,
[in] IDWriteTextLayout *textLayout,
[in] ID2D1Brush *defaultFillBrush,
D2D1_DRAW_TEXT_OPTIONS options
);
參數
origin
類型： D2D1_POINT_2F
與裝置無關的圖元所描述的點，其中會繪製 textLayout 所描述之文字的左上角。
[in] textLayout
類型： IDWriteTextLayout*
要繪製的格式化文字。 不會繼承自 ID2D1Resource 的任何繪圖效果都會被忽略。 如果有繼承自 ID2D1Resource 且不是筆刷的繪圖效果，此方法會失敗，而且轉譯目標會處於錯誤狀態。
[in] defaultFillBrush
類型： ID2D1Brush*
筆刷，用來繪製 textLayout 中尚未與其相關聯的筆刷做為繪圖效果的筆刷， (由 IDWriteTextLayout：：SetDrawingEffect 方法所指定) 。
options
值，指出文字是否應該貼齊圖元界限，以及文字是否應該裁剪到版面配置矩形。 默認值 為 D2D1_DRAW_TEXT_OPTIONS_NONE，表示文字應貼齊圖元界限，且不應裁剪到版面配置矩形。
傳回值
無
備註
重複繪製相同的文字時，使用 DrawTextLayout 方法比使用 DrawText 方法更有效率，因為不需要格式化文字，而且每個呼叫都處理版面配置。
如果此方法失敗，此方法不會傳回錯誤碼。 若要判斷繪圖作業是否 (例如 DrawTextLayout) 失敗，請檢查 ID2D1RenderTarget：：EndDraw 或 ID2D1RenderTarget：：Flush 方法所傳回的結果。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1.h |
| 程式庫 | D2d1.lib |
| Dll | D2d1.dll |