OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment OpticalMarginAlignment Enum


Specifies how side bearing values in per-character typography are handled when aligning to a text container boundary.

public : enum class OpticalMarginAlignment
enum class winrt::Windows::UI::Xaml::OpticalMarginAlignment : int32_t
public enum OpticalMarginAlignment
Public Enum OpticalMarginAlignment

Windows 10 requirements

Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)


None None None None 0

Use side bearings that come from font typography values. This is the default.

TrimSideBearings TrimSideBearings TrimSideBearings TrimSideBearings 1

Don't use side bearings that come from font typography values, and align the side of the glyph to where the "ink" part of the glyph begins.


This enumeration is used as a value by TextBlock.OpticalMarginAlignment and RichTextBlock.OpticalMarginAlignment.

When fonts of different sizes are aligned vertically in the same or nearby containers, the advance width and side bearing of the characters can cause the alignment to appear ragged. This can be prevented by setting a property that uses OpticalMarginAlignment to use the TrimSideBearings constant.

See also