XL2000: Macro to Check for Page Breaks on a Worksheet (213831)
The information in this article applies to:
This article was previously published under Q213831 SUMMARY
In Microsoft Excel 2000, 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.
MORE INFORMATIONMicrosoft provides programming examples for illustration only, without warranty either
expressed or implied, including, but not limited to, the implied warranties of
merchantability and/or fitness for a particular purpose. This article assumes
that you are familiar with the programming language being demonstrated and the
tools used to create and debug procedures. Microsoft support professionals 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 needs. If you have limited programming experience, you may
want to contact a Microsoft Certified Partner or the Microsoft fee-based
consulting line at (800) 936-5200. For more information about Microsoft Certified
Partners, please visit the following Microsoft Web site:
For more information about the support options that are available and about how to contact Microsoft, visit the following Microsoft Web site:
The PageBreak property returns or sets the location of a page break by using
the Microsoft Excel constants xlNone, xlManual, or xlAutomatic. The
PageBreak property must be applied to an entire row or column (or returned by
using an entire row or column as a reference).
Macro to Return Page Break Type for Selected Cell
You can use the following sample code 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 page break, 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 that indicates 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 then 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
REFERENCESFor additional information about page breaks in Excel, click the article number below
to view the article in the Microsoft Knowledge Base:
134731 XL: PageBreak Property Does Not Work as Expected
For more information about the PageBreak property, in the Visual Basic Editor, click Microsoft Visual Basic Help on the Help menu, type pagebreak property in the Office Assistant or the Answer Wizard, and then click Search to view the topic.
Modification Type: | Minor | Last Reviewed: | 10/11/2006 |
---|
Keywords: | kbdtacode kbhowto kbProgramming KB213831 |
---|
|