FontStretch Structure (System.Windows)

FontStretch Structure

.NET Framework Class Library

FontStretch Structure

Describes the degree to which a font has been stretched compared to the normal aspect ratio of that font.

Namespace: System.Windows
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic (Declaration)

<TypeConverterAttribute(GetType(FontStretchConverter))> _
<LocalizabilityAttribute(LocalizationCategory.None)> _
Public Structure FontStretch _
    Implements IFormattable

Visual Basic (Usage)

Dim instance As FontStretch

[TypeConverterAttribute(typeof(FontStretchConverter))]
[LocalizabilityAttribute(LocalizationCategory.None)]
public struct FontStretch : IFormattable

Visual C++

[TypeConverterAttribute(typeof(FontStretchConverter))]
[LocalizabilityAttribute(LocalizationCategory::None)]
public value class FontStretch : IFormattable

JScript

JScript supports the use of structures, but not the declaration of new ones.

XAML Attribute Usage

<object fontStretchesProperty="fontStretchesValue"/>

XAML Values

fontStretchesValue: A FontStretches value expressed as the name string, such as "Condensed", "Normal", or "Expanded".

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 FontStretches 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.

Font stretch	usWidthClass	% of normal
UltraCondensed	1	50.0%
ExtraCondensed	2	62.5%
Condensed	3	75.0%
SemiCondensed	4	87.5%
Medium	5	100.0%
SemiExpanded	6	112.5%
Expanded	7	125.0%
ExtraExpanded	8	150.0%
UltraExpanded	9	200.0%

For more information on the OpenType usWidthClass value, see the "Font File Tables" section of the OpenType specification.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

FontStretch Members

System.Windows Namespace

Other Resources

Fonts Samples

Typography in Windows Presentation Foundation