InsertBreak Method

Applies To

Range object, Selection object.

Description

Inserts a page, column, or section break.

Syntax

expression.InsertBreak(Type)

expression Required. An expression that returns a Range or Selection object.

Type Optional Variant. The type of break to be inserted. Can be one of the following WdBreakType constants: wdPageBreak, wdColumnBreak, wdSectionBreakNextPage, wdSectionBreakContinuous, wdSectionBreakEvenPage, wdSectionBreakOddPage, or wdLineBreak. The default value is wdPageBreak.

Remarks

When you insert a page or column break, the range or selection is replaced by the break. If you don't want to replace the range or selection, use the Collapse method before using the InsertBreak method. When you insert a section break, the break is inserted immediately preceding the Range or Selection object.

See Also

AllowBreakAcrossPages property, PageBreakBefore property, Split method.

Example

This example inserts a continuous section break immediately preceding the selection.

Selection.InsertBreak Type:=wdSectionBreakContinuous
This example inserts a page break immediately following the second paragraph in the active document.

Set myRange = ActiveDocument.Paragraphs(2).Range
With myRange
    .Collapse Direction:=wdCollapseEnd
    .InsertBreak Type:=wdPageBreak
End With