IDWriteTextFormat1::SetOpticalAlignment method

Sets the optical margin alignment for the text format.

By default, glyphs are aligned to the margin by the default origin and side-bearings of the glyph. If you specify DWRITE_OPTICAL_ALIGNMENT_USING_SIDE_BEARINGS, then the alignment Suses the side bearings to offset the glyph from the aligned edge to ensure the ink of the glyphs are aligned.

Syntax


virtual HRESULT SetOpticalAlignment(
   DWRITE_OPTICAL_ALIGNMENT opticalAlignment
) = 0;

Parameters

opticalAlignment

The optical alignment to set.

Return value

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

Requirements

Minimum supported client

Windows 8.1 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 R2 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Library

Dwrite.lib

DLL

Dwrite.dll

See also

IDWriteTextFormat1

 

 

Show: