HPageBreaks object (Excel)

The collection of horizontal page breaks within the print area.

Remarks

Each horizontal page break is represented by an HPageBreak object.

If you add a page break that does not intersect the print area, the newly-added HPageBreak object will not appear in the HPageBreaks collection for the print area. The contents of the collection may change if the print area is resized or redefined.

When the Application property, Count property, Item property, Parent property, or Add method is used in conjunction with the HPageBreaks property of the Worksheet object:

  • For an automatic print area, the HPageBreaks property applies only to the page breaks within the print area.

  • For a user-defined print area of the same range, the HPageBreaks property applies to all of the page breaks.

Note

There is a limit of 1026 horizontal page breaks per sheet.

Example

Use the HPageBreaks property to return the HPageBreaks collection. Use the Add method to add a horizontal page break. The following example adds a horizontal page break above the active cell.

ActiveSheet.HPageBreaks.Add Before:=ActiveCell

Methods

Properties

See also

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.