共用方式為


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

IDWriteTextLayout::Draw 會呼叫此函式,指示用戶端繪製底線。

語法

HRESULT DrawUnderline(
       void                           *clientDrawingContext,
       FLOAT                          baselineOriginX,
       FLOAT                          baselineOriginY,
       DWRITE_GLYPH_ORIENTATION_ANGLE orientationAngle,
  [in] DWRITE_UNDERLINE const         *underline,
       IUnknown                       *clientDrawingEffect
);

參數

clientDrawingContext

類型: void*

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

baselineOriginX

類型: FLOAT

圖元位置 (X 座標) 在套用底線的執行基準原點。

baselineOriginY

類型: FLOAT

圖元位置 (Y 座標) 套用底線的執行基準原點。

orientationAngle

類型: DWRITE_GLYPH_ORIENTATION_ANGLE

底線的方向。

[in] underline

類型:const DWRITE_UNDERLINE*

結構指標,其中包含底線邏輯資訊。

clientDrawingEffect

類型: IUnknown*

要套用至底線的應用程式定義效果。 這個引數通常代表效果,例如填滿線條內部的前景筆刷。

傳回值

類型: HRESULT

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

備註

根據格式化變更屬性的方式,單一底線可以分成多個呼叫。 如果字型大小/樣式在底線內變更,則粗細和位移會根據字元平均加權。 若要取得適當的起始圖元位置,請將 underline::offset 新增至基準。 否則文字之間不會有間距。 不論文字方向為何,X 座標一律會當做左側傳遞。 這可簡化繪圖並減少進位問題,這可能會造成間距或雙戳記 Alpha 混合。 若要避免 Alpha 重迭,請將端點四捨五入到最接近的裝置圖元。

需求

   
最低支援的用戶端 適用于 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