Type Default Value Read Only Description

[Visual Basic]
n/a No The CropBox for the page

Throws Exceptions may throw NullReferenceException()




The CropBox for the page.

The CropBox defines the visible part of the physical medium on which the page may be displayed or printed. This is what you see as the boundary of the page when you view a document using Acrobat Reader.

These boundaries may be defined directly on the Page object or they may be inherited from a parent Pages object.

The CropBox is optional and if this property is null it is implicitly assumed to be the same as the MediaBox.

Assigning a new value to this property will change the property for the current Page rather than any Pages object from which the value may have been inherited. In this way the property exhibits a copy-on-write behavior.

Attempting to assign a null value to this property will result in a NullReferenceException being thrown. This is because the CropBox may be inherited from a parent page and thus removing the CropBox from the current page may simply result in it being inherited from another. This is unusual and counterintuitive behavior and can result in subtle bugs related to specific documents. As such, if you want to clear this property you should assign it the value of the MediaBox.

Note that, as with all objects in this namespace, this property is measured in points in the native PDF coordinate space. It is unaffected by the Doc.Units or Doc.TopDown properties.