fontStretch property

Specifies a value that indicates a normal, condensed, or expanded face of a font family.

Scalable Vector Graphics: Text, Section 10.10Internet Explorer 9



Integer value = object.put_fontStretch( v);Integer value = object.get_fontStretch(* sFace);

Property values

Type: BSTR

normal (normal)

Default. Indicates the face is neither condensed nor expanded.

wider (wider)

Indicates a wider value relative to the width of the parent element.

narrower (narrower)

Indicates a narrower value relative to the width of the parent element.

ultra-condensed (ultra-condensed)

Indicates the most condensed font face.

extra-condensed (extra-condensed)

Indicates the second most condensed font face.

condensed (condensed)

Indicates a condensed font face.

semi-condensed (semi-condensed)

Indicates a slightly condensed font face.

semi-expanded (semi-expanded)

Indicates a slightly expanded font face.

expanded (expanded)

Indicates an expanded font face.

extra-expanded (extra-expanded)

Indicates the second most expanded font face.

ultra-expanded (ultra-expanded)

Indicates the most expanded font face.

inherit (inherit)

Indicates that the property takes the same computed value as the property for the element's parent.

String format

normal | wider | narrower | ultra-condensed | extra-condensed | condensed | semi-condensed | semi-expanded | expanded | extra-expanded | ultra-expanded | inherit

CSS information

Applies ToAll elements
Initial Valuedepends on user agent

Standards information


Absolute keyword values have the following order, from narrowest to widest:

  • Ultra condensed
  • Extra condensed
  • Condensed
  • Semi condensed
  • Normal
  • Semi expanded
  • Expanded
  • Extra expanded
  • Ultra expanded

The scale is relative, so a font face that has a font-stretch value higher in the previous list above should never appear wider. When a font face does not exist for a given width, normal or condensed values map to a narrower font face. Otherwise, they map to a wider font face. Conversely, expanded values map to a wider font face; otherwise, a narrower face.


This example displays text with the default body element font-stretch setting (normal), then uses IHTMLCSSStyleDeclaration::fontStretch to display condensed text.

body {
  font-family: sans-serif;
.condensedFont {
  font-stretch: condensed;

  <p>Lorem ipsum dolor sit amet... (font-stretch: normal (default))</p>
  <p class="condensedFont">Lorem ipsum dolor sit amet... (font-stretch: condensed)</p>

The following image shows the result:

An image showing text with different font-stretch settings.


Minimum supported client

Windows Vista with SP1, Windows 7

Minimum supported server

Windows Server 2008 R2







See also