PageRectangle Property

Summary

Gets or sets the rectangular area that represents the total area of the page.

Syntax

C++

public RectangleF PageRectangle { get; set; }

  
Public Property PageRectangle As RectangleF

public: 
property RectangleF PageRectangle { 
   RectangleF get(); 
   void set (    RectangleF ); 
}

Property Value

A System.Drawing.Rectangle represents the total area of the page.

Remarks

This specifies the destination rectangle on the page to where the image is to be printed. Normally, you obtain the page rectangle through the System.Drawing.Printing.PrintPageEventArgs.MarginBounds or the System.Drawing.Printing.PrintPageEventArgs object passed to your System.Drawing.Printing.PrintPageEventHandler.

You can also pass RectangleF.Empty to use the whole print area. The print area will then be calculated using the UseMargins property value and the page and margins bounds values passed through System.Drawing.Printing.PrintPageEventArgs.

Important: the UseMargins property is only used to calculate the printing area when the value of both PageRectangle is left to the empty default value. If you set the PageRectangle value to anything else, it is assumed that you are responsible for calculating the print area and UseMargins will be ignored.

Example

For an example, refer to RasterImagePrinter and ImageRectangle.

Requirements

Target Platforms