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
- 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
Minimum supported client |
Windows XP with SP2 |
Minimum supported server |
Windows Server 2003 |
Header |
Mshtml.h |
IDL |
Mshtml.idl |
DLL |
Mshtml.dll |