TextLineBounds enumeration

Applies to Windows and Windows Phone

Influences how a line box height is calculated

Syntax


public enum TextLineBounds

Attributes

[Version(0x06030000)]
[WebHostHidden()]

Members

The TextLineBounds enumeration has these members.

MemberValueDescription
Full0

Uses normal line box height calculation, this is the default.

TrimToCapHeight1

Top of line box height is the cap height from the font.

TrimToBaseline2

Bottom of line box height is the text baseline.

Tight3

Top of line box height is the cap height from the font, bottom of line box height is the text baseline.

Remarks

How the TextLineBounds values influence line height calculations for adjacent lines is best shown through illustrations. The first illustration for each value shows a single line and the second shows two adjacent lines and their bounds.

  • Yellow areas represent the areas that are outside of a TextBlock outer boundary, and would thus be masked if there was adjacent content (text or otherwise).
  • The red line is the text cap height, which text ascenders might go above. The upper-case "Â" character in the illustrations has an ascender.
  • The green line is the text baseline, which text descenders might go below. The lower-case "j" character in the illustrations has a descender.

Full

Illustration of the Full value for TextLineBounds applied to a line of text, with baseline and cap height indicated.Illustration of the Full value for TextLineBounds applied to two lines of text, showing the spacing between the lines.

 

TrimToCapHeight

Illustration of the TrimToCapHeight value for TextLineBounds applied to a line of text, with baseline and cap height indicatedIllustration of the TrimToCapHeight value for TextLineBounds applied to two lines of text, showing the spacing between the lines.

 

TrimToBaseline

Illustration of the TrimToBaseline value for TextLineBounds applied to a line of text, with baseline and cap height indicatedIllustration of the TrimToBaseline value for TextLineBounds applied to two lines of text, showing the spacing between the lines.

 

Tight

Illustration of the Tight value for TextLineBounds applied to a line of text, with baseline and cap height indicatedIllustration of the Tight value for TextLineBounds applied to two lines of text, showing the spacing between the lines.

 

Note that for the Tight alignment there is a strong possibility that characters are overlapped if there are any ascenders or descenders. Especially if the different lines of characters use the same Foreground value, the overlap can negatively impact readability.

Requirements

Minimum supported client

Windows 8.1

Minimum supported server

Windows Server 2012 R2

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml
Windows::UI::Xaml [C++]

Metadata

Windows.winmd

 

 

Show:
© 2014 Microsoft