widows property

Sets or retrieves the minimum number of lines of a paragraph that must appear at the top of a document.

Syntax

HRESULT value = object.put_widows( v);HRESULT value = object.get_widows(* p);

Property values

Type: VARIANT

The minimum number of lines to print at the top of a document.

String format

integer

CSS information

Standards information

• CSS 2.1, Section 13.3

Remarks

This property applies when the document is printed. If there are fewer lines than necessary to satisfy this rule, the lines are moved to the following document. The IHTMLCurrentStyle5::widows property has precedence over the IHTMLCurrentStyle5::orphans property.

This property requires Windows Internet Explorer to be in IE8 Standards mode rendering.

Examples

The following style rule ensures that at least three lines of a paragraph appear at the bottom and top of each printed document.

<meta http-equiv="X-UA-Compatible" content="IE=8" />
<style type="text/css">
@media print {
    p {
        widows:3;
        orphans:3;
    }
}
</style>

Requirements

See also

IHTMLCurrentStyle5::orphans