GraphicsUnit Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies the unit of measure for the given data.

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

public enum class GraphicsUnit

Member nameDescription
Display

Specifies the unit of measure of the display device. Typically pixels for video displays, and 1/100 inch for printers.

Document

Specifies the document unit (1/300 inch) as the unit of measure.

Inch

Specifies the inch as the unit of measure.

Millimeter

Specifies the millimeter as the unit of measure.

Pixel

Specifies a device pixel as the unit of measure.

Point

Specifies a printer's point (1/72 inch) as the unit of measure.

World

Specifies the world coordinate system unit as the unit of measure.

The following code example demonstrates how to load a bitmap from an Icon handle, using the GraphicsUnit enumeration, and the use of the Round method to draw the rectangle bounds of a bitmap.

This example is designed to be used with Windows Forms. Create a form that contains a button named Button2. Paste the code into the form and associate this method with the button's Click event.

void Button2_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   Bitmap^ bitmap1 = Bitmap::FromHicon( SystemIcons::Hand->Handle );
   Graphics^ formGraphics = this->CreateGraphics();
   GraphicsUnit units = GraphicsUnit::Point;
   RectangleF bmpRectangleF = bitmap1->GetBounds( units );
   Rectangle bmpRectangle = Rectangle::Round( bmpRectangleF );
   formGraphics->DrawRectangle( Pens::Blue, bmpRectangle );
   delete formGraphics;
}

.NET Framework
Available since 1.1
Return to top
Show: