DrawStrikethrough Method (TextRenderer1)

In This Topic

IDWriteTextLayout::Draw calls this function to instruct the client to draw a strikethrough.

Syntax

Visual Basic
C#

'Declaration
 
Function DrawStrikethrough( _
   ByVal clientDrawingContext As Object, _
   ByVal baselineOriginX As Single, _
   ByVal baselineOriginY As Single, _
   ByVal orientationAngle As GlyphOrientationAngle, _
   ByRef strikethrough As Strikethrough, _
   ByVal clientDrawingEffectPtr As IntPtr _
) As HResult

HResult DrawStrikethrough( 
   object clientDrawingContext,
   float baselineOriginX,
   float baselineOriginY,
   GlyphOrientationAngle orientationAngle,
   ref Strikethrough strikethrough,
   IntPtr clientDrawingEffectPtr
)

Parameters

clientDrawingContext: The application-defined drawing context passed to IDWriteTextLayout::Draw.
baselineOriginX: The pixel location (X-coordinate) at the baseline origin of the run where strikethrough applies.
baselineOriginY: The pixel location (Y-coordinate) at the baseline origin of the run where strikethrough applies.
orientationAngle: Orientation of the strikethrough.
strikethrough: Pointer to a structure containing strikethrough logical information.
clientDrawingEffectPtr: Application-defined effect to apply to the strikethrough. Usually this argument represents effects such as the foreground brush filling the interior of a line.

Return Value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

A single strikethrough can be broken into multiple calls, depending on how the formatting changes attributes. Strikethrough is not averaged across font sizes/styles changes. To get an appropriate starting pixel position, add strikethrough::offset to the baseline. Like underlines, the x coordinate will always be passed as the left side, regardless of text directionality.

Reference

TextRenderer1 Interface
TextRenderer1 Members