共用方式為


IDWriteTextRenderer1::D rawGlyphRun 方法 (dwrite_2.h)

IDWriteTextLayout::Draw 會呼叫此函式,指示用戶端轉譯字元的執行。

語法

HRESULT DrawGlyphRun(
       void                               *clientDrawingContext,
       FLOAT                              baselineOriginX,
       FLOAT                              baselineOriginY,
       DWRITE_GLYPH_ORIENTATION_ANGLE     orientationAngle,
       DWRITE_MEASURING_MODE              measuringMode,
  [in] DWRITE_GLYPH_RUN const             *glyphRun,
  [in] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
       IUnknown                           *clientDrawingEffect
);

參數

clientDrawingContext

類型: void*

傳遞至 IDWriteTextLayout::D raw的應用程式定義繪圖內容。

baselineOriginX

類型: FLOAT

圖元位置 (X 座標) 字元執行的基準原點。

baselineOriginY

類型: FLOAT

圖元位置 (圖像執行的基準原點) Y 座標。

orientationAngle

類型: DWRITE_GLYPH_ORIENTATION_ANGLE

圖像執行的方向。

measuringMode

類型: DWRITE_MEASURING_MODE

執行中圖像的測量方法,與其他屬性搭配使用,以判斷轉譯模式。

[in] glyphRun

類型: const DWRITE_GLYPH_RUN*

要轉譯之圖像執行實例的指標。

[in] glyphRunDescription

類型: const DWRITE_GLYPH_RUN_DESCRIPTION*

字元執行描述實例的指標,其中包含與此回合相關聯的字元屬性。

clientDrawingEffect

類型: IUnknown*

要呈現之圖像的應用程式定義繪圖效果。 這個自變數通常代表效果,例如填滿文字內部的前景筆刷。

傳回值

類型: HRESULT

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

備註

IDWriteTextLayout::D raw 函式會呼叫此回呼函式,其中包含要轉譯的字元相關信息。 應用程式大部分會委派對基礎平台圖形 API 的呼叫,例如 Direct2D ,以在繪圖內容上繪製圖像,以實作此回呼。 使用 GDI 的應用程式可以在 IDWriteBitmapRenderTarget::D rawGlyphRun 方法方面實作此回呼。

規格需求

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

另請參閱

IDWriteTextRenderer1