Export (0) Print
Expand All
Expand Minimize

GraphicsUnit Enumeration

Specifies the unit of measure for the given data.

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

public enum GraphicsUnit

Member nameDescription
DisplaySpecifies the unit of measure of the display device. Typically pixels for video displays, and 1/100 inch for printers.
DocumentSpecifies the document unit (1/300 inch) as the unit of measure.
InchSpecifies the inch as the unit of measure.
MillimeterSpecifies the millimeter as the unit of measure.
PixelSpecifies a device pixel as the unit of measure.
PointSpecifies a printer's point (1/72 inch) as the unit of measure.
WorldSpecifies 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.

private 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(ref units);
    Rectangle bmpRectangle = Rectangle.Round(bmpRectangleF);
    formGraphics.DrawRectangle(Pens.Blue, bmpRectangle);
    formGraphics.Dispose();
}

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft