共用方式為


ID2D1DeviceCoNtext4::D rawTextLayout 方法 (d2d1_3.h)

繪製文字版面設定物件。 如果未後續變更版面配置,則重複繪製相同版面配置時,這比 DrawText 更有效率。

語法

void DrawTextLayout(
                 D2D1_POINT_2F          origin,
  [in]           IDWriteTextLayout      *textLayout,
  [in, optional] ID2D1Brush             *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle     *svgGlyphStyle,
                 UINT32                 colorPaletteIndex,
                 D2D1_DRAW_TEXT_OPTIONS options
);

參數

origin

類型: D2D1_POINT_2F

與裝置無關的圖元所描述的點,其中會繪製 textLayout 所描述之文字的左上角。

[in] textLayout

類型: IDWriteTextLayout*

要繪製的格式化文字。 不會繼承自 ID2D1Resource 的任何繪圖效果都會被忽略。 如果有繼承自 ID2D1Resource 且不是筆刷的繪圖效果,此方法會失敗,而且轉譯目標會處於錯誤狀態。

[in, optional] defaultFillBrush

類型: ID2D1Brush*

用來繪製文字的筆刷。

[in, optional] svgGlyphStyle

類型: ID2D1SvgGlyphStyle*

轉譯 SVG 圖像時使用的內容填滿、內容筆劃和內容值的值。

colorPaletteIndex

類型: UINT32

用來在色彩字型中選取調色盤的索引。

options

類型: D2D1_DRAW_TEXT_OPTIONS

值,指出文字是否應該貼齊圖元界限,以及文字是否應該裁剪到版面配置矩形。 預設值 為 D2D1_DRAW_TEXT_OPTIONS_NONE,表示文字應貼齊圖元界限,且不應裁剪到版面配置矩形。

傳回值

規格需求

   
目標平台 Windows
標頭 d2d1_3.h
Dll D2d1.dll

另請參閱

ID2D1DeviceContext4