PrintDocument.OriginAtMargins Property

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v9.0.0-rc.2.24474.1

Source:

PrintDocument.cs

Gets or sets a value indicating whether the position of a graphics object associated with a page is located just inside the user-specified margins or at the top-left corner of the printable area of the page.

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

public bool OriginAtMargins { get; set; }

member this.OriginAtMargins : bool with get, set

Public Property OriginAtMargins As Boolean

Property Value

Boolean

true if the graphics origin starts at the page margins; false if the graphics origin is at the top-left corner of the printable page. The default is false.

Remarks

Calculating the area available to print requires knowing the physical size of the paper, the margins for the page, and the location of the Graphics object origin. When OriginAtMargins is true, the Graphics object location takes into account the PageSettings.Margins property value and the printable area of the page. When OriginAtMargins is false, only the printable area of the page is used to determine the location of the Graphics object origin, the PageSettings.Margins value is ignored.

For example, if OriginAtMargins is true, and PageSettings.Margins is set for 1 inch on each side, the Graphics object included in the PrintPageEventArgs is located 1 inch from the left and top of the page. If the printable area of the page is .25 of an inch on each side and OriginAtMargins is false, the Graphics object is located .25 of an inch from the left and top of the page.

Note

The printable area of a page varies from printer to printer and is not guaranteed to be symmetrical.