Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

textDecoration property

Sets or retrieves a value that indicates whether the text in the object has blink, line-through, overline, or underline decorations.


Integer value = object.put_textDecoration( v);Integer value = object.get_textDecoration(* sDecoration);

Property values

Type: BSTR

one of the values listed in Possible Values.

none (none)

Default. Text has no decoration.

underline (underline)

Text is underlined.

overline (overline)

Text has a line over it.

line-through (line-through)

Text has a line drawn through it.

blink (blink)

Not implemented.

String format

none | underline | overline | line-through | blink

CSS information

Applies ToAll elements
Initial Value


The default value is different for the following tags.

If the value none is placed at the end of the values, all values are cleared.

If the object has no text (for example, the img object in HTML) or is an empty object (for example, "<em></em>"), this property has no effect.

If you set the IHTMLStyle::textDecoration attribute to none on the body object, the a objects are still underlined. To remove the underline from the a objects, either set the style inline or use a as a selector in the global style sheet.

Specifying the IHTMLStyle::textDecoration property for block elements affects all inline children. If it is specified for, or affects, an inline element, it affects all boxes generated by the element.

The overline and blink possible values are available as of Microsoft Internet Explorer 4.0. Although blink is exposed, it is not rendered.

In Windows Internet Explorer 8 and later, when the IHTMLStyle::textDecoration property is set to overline and/or underline, the line will remain at the same vertical level and the same thickness across all child elements of the parent element on which the text decoration has been set. (This does not apply to the line-through value.) In Windows Internet Explorer 7 and earlier, the text decoration adjusts to correspond to the size and thickness of each child element.


Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]







See also




Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

© 2014 Microsoft. All rights reserved.