pageBreakBefore property

[This documentation is preliminary and is subject to change.]

Sets or retrieves a string indicating whether a page break occurs before the object.

Syntax

Integer value = object.put_pageBreakBefore(BSTR v);Integer value = object.get_pageBreakBefore(BSTR* sBreak);

Property values

Type: BSTR

always (always): Always insert a page break before the object.
auto (auto): Default. Neither force nor forbid a page break before the object.
avoid (avoid): Internet Explorer 8. Forbid a page break before the object, if possible.
empty string (empty string): Behaves the same as auto.
inherit (inherit): Internet Explorer 8. Inherit the value of the same property for the object's parent.
left (left): Currently behaves the same as always.
right (right): Currently behaves the same as always.

String format

CSS information

Applies To	All elements
Media	visual
Inherited	no
Initial Value

Standards information

CSS 2.1, Section 13.3.1

Remarks

This property applies when printing the document. This property does not apply to the br or hr elements.

If there are conflicts between the value of this property and the page-break-after property of the object previously displayed in the browser, the value that results in the largest number of page breaks is used.

Page breaks are not permitted inside positioned objects.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Header
DLL	Mshtml.dll