Windows apps
Collapse the table of content
Expand the table of content

IHTMLStyle7::fontStretch Property

New for Internet Explorer 9

[This documentation is preliminary and is subject to change.]

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


HRESULT IHTMLStyle7::get_fontStretch(BSTR *p);HRESULT IHTMLStyle7::put_fontStretch(BSTR v);


Pointer to a variable of type BSTR that receives one of the values listed in Possible Values.
BSTR that specifies one of the values listed in Possible Values.

Possible Values

normal Default. Indicates the face is neither condensed nor expanded.
wider Indicates a wider value relative to the width of the parent element.
narrower Indicates a narrower value relative to the width of the parent element.
ultra-condensed Indicates the most condensed font face.
extra-condensed Indicates the second most condensed font face.
condensed Indicates a condensed font face.
semi-condensed Indicates a slightly condensed font face.
semi-expanded Indicates a slightly expanded font face.
expanded Indicates an expanded font face.
extra-expanded Indicates the second most expanded font face.
ultra-expanded Indicates the most expanded font face.
inherit Indicates that the property takes the same computed value as the property for the element's parent.

Return Value

Returns S_OK if successful, or an error value otherwise.


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.

See Also


Community Additions

© 2017 Microsoft