OpticalMarginAlignment Enum


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

public enum class OpticalMarginAlignment
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class OpticalMarginAlignment
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum OpticalMarginAlignment
Public Enum OpticalMarginAlignment

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)


None 0

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

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.

Applies to

See also