Class Break (Word VBA)

The class Break represents individual page, column, and section breaks in a page. Use the Break object and the related methods and properties for programmatically defining page layout in a document.


To use a Break class variable it first needs to be instantiated, for example

Dim brk as Break
Set brk = ActiveWindow.ActivePane.Pages(1).Breaks(Index:=1)

The following procedures can be used to set variables of type Break: Breaks.Item and Page.Breaks

For Each

Here is an example of processing the Break items in a collection.

Dim brk As Break
For Each brk In ActiveWindow.ActivePane.Pages(1).Breaks
Next brk


Returns a Long that represents the page number on which the specified break occurs.



Returns an object that represents the parent object of the specified Break object.

Dim objParent As Object
Set objParent = ActiveWindow.ActivePane.Pages(1).Breaks(1).Parent


Returns a Range object that represents the portion of a document that's contained in the specified object.

Dim rngRange As Range
Set rngRange = ActiveWindow.ActivePane.Pages(1).Breaks(1).Range


Returns the number of items in the Breaks collection.

Dim lngCount As Long
lngCount = ActiveWindow.ActivePane.Pages(1).Breaks.Count


Returns an individual Break object in a collection.

Syntax : expression.Item (Index)

Index: The individual object to be returned. Can be a Long indicating the ordinal position of the individual object.

Dim brk As Break
Set brk = ActiveWindow.ActivePane.Pages(1).Breaks(Index:=1)


Returns an object that represents the parent object of the specified Breaks collection.

Dim objParent As Object
Set objParent = ActiveWindow.ActivePane.Pages(1).Breaks.Parent