This topic has not yet been rated - Rate this topic

PrintDocument.OriginAtMargins Property

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.

Namespace:  System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)
public bool OriginAtMargins { get; set; }

Property Value

Type: System.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.

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 Note

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

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ