InsertBreak Method

Microsoft Word Visual Basic

InsertBreak Method

       

Inserts a page, column, or section break.

expression.InsertBreak(Type)

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

Type   Optional Variant. The type of break to be inserted.WdBreakType 

    Can be one of the following WdBreakType constants.

    wdPageBreak

    wdColumnBreak

    wdSectionBreakNextPage

    wdSectionBreakContinuous

    wdSectionBreakEvenPage

    wdSectionBreakOddPage

    wdLineBreak

    wdLineBreakClearLeft

    wdLineBreakClearRight

    wdTextWrappingBreak

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.

Some of the constants listed above may not be available to you, depending on the language support (U.S. English, for example) that you’ve selected or installed.

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