widows property

Article
05/02/2017

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

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

Partager via