Share via


fontStretch property

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

 

Syntax

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 To All elements
Media visual
Inherited 1
Initial Value depends on user agent

Standards information

Remarks

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.

Examples

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;
}
<body>
  <p>Lorem ipsum dolor sit amet... (font-stretch: normal (default))</p>
  <p class="condensedFont">Lorem ipsum dolor sit amet... (font-stretch: condensed)</p>
</body>

The following image shows the result:

Requirements

Minimum supported client

Windows Vista with SP1, Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IHTMLCSSStyleDeclaration::font