Graphics.PageUnit Property

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Package:

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

Source:

Graphics.cs

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

public:
 property System::Drawing::GraphicsUnit PageUnit { System::Drawing::GraphicsUnit get(); void set(System::Drawing::GraphicsUnit value); };

public System.Drawing.GraphicsUnit PageUnit { get; set; }

member this.PageUnit : System.Drawing.GraphicsUnit with get, set

Public Property PageUnit As GraphicsUnit

Property Value

GraphicsUnit

One of the GraphicsUnit values other than World.

Exceptions

InvalidEnumArgumentException

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

Examples

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.

private:
   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 );
   }

private void ChangePageUnit(PaintEventArgs e)
{

    // Create a rectangle.
    Rectangle rectangle1 = new 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);
}

Private Sub ChangePageUnit(ByVal e As PaintEventArgs)

    ' Create a rectangle.
    Dim rectangle1 As New 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)

End Sub

Remarks

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

See also

• Types of Coordinate Systems