[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.
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.
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
- Semi condensed
- Semi 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.