Share via


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

Applies To All elements
Media visual
Inherited no
Initial Value

Standards information

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 IHTMLRuleStyle6::widows property has precedence over the IHTMLRuleStyle6::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

Minimum supported client

Windows XP with SP2

Minimum supported server

Windows Server 2003

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IHTMLRuleStyle6::orphans