IHTMLStyle7::kerning Property

New for Windows Internet Explorer 9

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

Gets or sets a value that indicates whether Internet Explorer should adjust inter-glyph spacing based on kerning tables that are included in the relevant font (that is, enable auto-kerning) or instead disable auto-kerning and set inter-character spacing to a specific length (typically zero).

Syntax

HRESULT IHTMLStyle7::get_kerning(VARIANT *p);
HRESULT IHTMLStyle7::put_kerning(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

auto Default. Indicates that inter-glyph spacing is adjusted based on kerning tables that are included in the font that will be used (that is, auto-kerning is enabled).
inherit Indicates that the property takes the same computed value as the property for the element's parent.
length Indicates the amount of inter-character spacing to a specific length (typically zero). When a length is set, auto-kerning is disabled.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

If a length is provided without a unit identifier (for example, an unqualified number such as 128), Internet Explorer processes the length as a width value.

When a length is provided, its value is added to the inter-character spacing value specified by the IHTMLStyle::letterSpacing property.

See Also

IHTMLStyle::letterSpacing, IHTMLStyle::wordSpacing