UseMargins Property

Summary

Gets or sets a value that indicates whether to use the page margins when printing.

Syntax

C++

public bool UseMargins { get; set; }

  
Public Property UseMargins As Boolean

public: 
property bool UseMargins { 
   bool get(); 
   void set (    bool ); 
}

Property Value

true to use the page margins when printing, otherwise; false. Default value is true.

Remarks

When the value of the UseMargins property is set to true, the maximum page area used for printing will be the PrintPageEventArgs.MarginBounds value.

When the value of the UseMargins property is set to false, the maximum page area used for printing will be the PrintPageEventArgs.PageBounds value.

For more information on the bounds and how to change them, refer to System.Drawing.Printing.PrintDocument, System.Drawing.Printing.PrinterSettings and System.Drawing.Printing.PrintPageEventArgs in MSDN.

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