OpticalMarginAlignment Enum

Definition

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

Equivalent WinUI enum: OpticalMarginAlignment.

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

Windows 10 requirements

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

Fields

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.

Remarks

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