IHTMLStyle7::fontSizeAdjust Property

  • Article

New for Internet Explorer 9

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

Gets or sets a value that specifies an aspect value for an element that will effectively preserve the x-height of the first choice font, whether it is substituted or not.

Syntax

HRESULT IHTMLStyle7::get_fontSizeAdjust(VARIANT *p);
HRESULT IHTMLStyle7::put_fontSizeAdjust(VARIANT v);

Parameters

  • p
    Pointer to a variable of type VARIANT that receives one of the values listed in Possible Values.
  • v
    VARIANT that specifies one of the values listed in Possible Values.

Possible Values

none Default. Indicates the font's x-height should not be preserved.
inherit Indicates that the property takes the same computed value as the property for the element's parent.
number Specifies the aspect value. For the adjusted font size calculation, see Remarks.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

For any given font size, the apparent size and legibility of text varies across fonts. For scripts such as Latin or Cyrillic that distinguish between uppercase and lowercase letters, the relative height of lowercase letters compared to their uppercase counterparts is a determining factor of legibility. This is commonly referred to as the aspect value. Precisely defined, it is equal to the x-height of a font (the height of a font's lowercase 'x' character) divided by the font size.

In situations where font fallback occurs, fallback fonts cannot share the same aspect ratio as the desired font family and thus appear less legible. Font fallback occurs when the specified font is not available and Internet Explorer uses a fallback font, or a replacement font. The IHTMLStyle7::fontSizeAdjust property is a way to preserve the legibility of text when font fallback occurs. It does this by adjusting the font size so that the x-height is the same regardless of the font that is used.

The following calculation uses the number value to calculate the adjusted font size: c = ( a / a' ) s

In this equation, s is the font-size value, a is the number value of the IHTMLStyle7::fontSizeAdjust property, a' is the aspect value of the actual font, and c is the adjusted font size to use.

This property applies to any font that is selected, but in typical usage it should be based on the aspect value of the first font in the font-family list. If this is specified accurately, the (a/a') term in the formula listed previously is 1 for the first font and no adjustment occurs. If the value is specified inaccurately, text that is rendered by using the first font in the family list displays differently in earlier versions of Internet Explorer, which do not support the IHTMLStyle7::fontSizeAdjust property.

See Also

IHTMLStyle7::fontStretch