Share via


FontStretch Property

Gets or sets the font stretch for the content in this element.

XAML
<object FontStretch="FontStretch" .../>
Scripting
value = object.FontStretch
object.FontStretch = value

Property Value

FontStretch

A value specifying the desired font stretch.

This property is read/write. The default value is Normal.

Remarks

A font stretch describes the degree to which a font form is stretched from its normal aspect ratio, which is the original width to height ratio specified for the glyphs in the font.

The FontStretch values correspond to the usWidthClass definition in the OpenType specification. The usWidthClass represents an integer value between 1 and 9--lower values indicate narrower widths; higher values indicate wider widths. Refer to the enumeration table in FontWeight for usWidthClass information.

Note   The FontStretch property value may not be the font stretch used during rendering due to font fallback. For example, if the font stretch ExtraExpanded is specified but Normal is the closest font stretch available, the value of FontStretch is still ExtraExpanded.

LineBreak is listed in the Applies To list for this property, because it does exist in the object model and you can get and set it. However, all LineBreak properties are ignored for rendering purposes.

Applies To

LineBreak, Run, TextBlock

See Also

Text and Fonts Overview
FontFamily
FontSize
FontStyle
FontWeight