PageUnit Property

Graphics::PageUnit Property


Gets or sets the unit of measure used for page coordinates in this Graphics.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

property GraphicsUnit PageUnit {
	GraphicsUnit get();
	void set(GraphicsUnit value);

Property Value

Type: System.Drawing::GraphicsUnit

One of the GraphicsUnit values other than World.

Exception Condition

PageUnit is set to World, which is not a physical unit.

The graphics unit is the unit of measure used for page coordinates in this Graphics.

The following code example demonstrates the effect of changing the PageUnit property.

This example is designed to be used with Windows Forms. Paste the code into a form and call the ChangePageUnit method when handling the form's Paint event, passing e as PaintEventArgs.

   void ChangePageUnit( PaintEventArgs^ e )
      // Create a rectangle.
      Rectangle rectangle1 = Rectangle(20,20,50,100);

      // Draw its outline.
      e->Graphics->DrawRectangle( Pens::SlateBlue, rectangle1 );

      // Change the page scale.  
      e->Graphics->PageUnit = GraphicsUnit::Point;

      // Draw the rectangle again.
      e->Graphics->DrawRectangle( Pens::Tomato, rectangle1 );

.NET Framework
Available since 1.1
Return to top
© 2015 Microsoft