Microsoft KB Archive/118589

= Macro to Check for Page Breaks on Worksheet =

Article ID: 118589

Article Last Modified on 6/11/2007

-

APPLIES TO


 * Microsoft Excel 97 Standard Edition
 * Microsoft Excel 98 for Macintosh

-



This article was previously published under Q118589



SUMMARY
In Microsoft Excel, you can check for an automatic or manual page break in the current cell by using the PageBreak property in a Microsoft Visual Basic for Applications macro or procedure.



MORE INFORMATION
Microsoft provides programming examples for illustration only, without warranty either expressed or implied. This includes, but is not limited to, the implied warranties of merchantability or fitness for a particular purpose. This article assumes that you are familiar with the programming language that is being demonstrated and with the tools that are used to create and to debug procedures. Microsoft support engineers can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific requirements. The PageBreak property returns or sets the location of a page break using the Microsoft Excel constants xlNone, xlManual, or xlAutomatic. The PageBreak property must be applied to an entire row or column (or returned using an entire row or column as a reference).

Macro to Return Page Break Type for Selected Cell
You can use the following example to test for an automatic page break above the active cell (horizontal) or next to the active cell (vertical) on your worksheet. In this example, the macro displays a dialog box with a message indicating whether there is an automatic page break above the current row. Sub Check_PageBreak

Dim i As Integer, BreakType As Integer

' To check for a vertical pagebreak, use the EntireColumn property. BreakType = ActiveCell.EntireRow.PageBreak

If BreakType = xlAutomatic Then ' Enter the code that you want to run if the current row ' contains an automatic page break. MsgBox "There is an automatic page break above this row"

ElseIf BreakType = xlManual Then ' Enter the code that you want to run if the current row ' contains a manual page break. MsgBox "There is a manual page break above this row"

Else ' Enter the code that you want to run if the current row ' does not contain a page break. MsgBox "There is no page break above this row" End If

End Sub

Macro to Return Page Breaks for Entire Worksheet
The PageBreak property returns a value indicating what type of page break exists in the selected range. The PageBreak property does not return the row or column number that the page break is associated with unless you test each row on the worksheet. The following macro checks your entire worksheet, and displays a dialog box with the type of page break and the number of the row located below the page break. Sub CheckForPageBreaks Dim i As Integer

For i = 1 to ActiveSheet.UsedRange.Rows.Count If Rows(i).PageBreak = xlManual then MsgBox "There is a manual page break above row " & i          ElseIf Rows(i).PageBreak = xlAutomatic Then MsgBox "There is an automatic page break above row " & i          End If       Next End Sub

