pageBreakInside property
[This documentation is preliminary and is subject to change.]
Sets or retrieves a string indicating whether a page break is allowed to occur inside the object.
![]() ![]() |
Syntax
HRESULT value = object.put_pageBreakInside(BSTR v);HRESULT value = object.get_pageBreakInside(BSTR* p);
Property values
Type: BSTR
auto (auto)
Default. Neither force nor forbid a page break inside the object.
avoid (avoid)
Forbid a page break inside the object, if possible.
empty string (empty string)
Behaves the same as auto.
inherit (inherit)
Inherit the value of the same property for the object's parent.
String format
avoid | auto | inherit | empty string
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.
Normally, Windows Internet Explorer attempts to avoid page breaks inside tables, blocks with borders, and positioned or floated elements. The page-break-inside attribute extends this behavior to other elements. A value of avoid instructs the browser to start the element on the following page if there is not enough room for it on the current page.
Page-break behavior is inherited from parent objects. A potential page-break location is also influenced by the page-break-after attribute of the preceding object, and/or the page-break-before attribute of the following object.
This property requires Internet Explorer to be in IE8 Standards mode rendering.
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
CSS How-to - Optimize Pages for Printing Using CSS
Build date: 1/23/2012
.png)
.png)