Export (0) Print
Expand All
top
Expand Minimize

pageBreakInside property

Sets or retrieves a string indicating whether a page break is allowed to occur inside the object.

CSS 2.1, Section 13.3Internet Explorer 8

 

Syntax

HRESULT value = object.put_pageBreakInside( v);HRESULT value = object.get_pageBreakInside(* 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 ToAll elements
Mediavisual
Inheritedno
Initial Valueauto

Standards information

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 IHTMLCSSStyleDeclaration::pageBreakInside 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 IHTMLCSSStyleDeclaration::pageBreakAfter attribute of the preceding object, and/or the IHTMLCSSStyleDeclaration::pageBreakBefore attribute of the following object.

This property requires Internet Explorer to be in IE8 Standards mode rendering.

Examples

The following style rule causes Internet Explorer to avoid breaking paragraphs across pages.



<style type="text/css">
@media print {
    p {
        page-break-inside: avoid;
    }
}
</style>

Requirements

Minimum supported client

Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

CSS How-to - Optimize Pages for Printing Using CSS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft