IHTMLStyle7::fontStretch Property

  • Article

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.

Syntax

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

Parameters

  • p
    Pointer to a variable of type BSTR that receives one of the values listed in Possible Values.
  • v
    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.

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.

See Also

IHTMLStyle7::fontSizeAdjust