Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
fontStretch
top
Collapse the table of content
Expand the table of content

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

 

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 ToAll elements
Mediavisual
Inherited1
Initial Valuedepends 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:

An image showing text with different font-stretch settings.

Requirements

Minimum supported client

Windows Vista with SP1, Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IHTMLCSSStyleDeclaration::font

 

 

Community Additions

ADD
Show:
© 2015 Microsoft