GraphicsUnit Enumeration

 

Specifies the unit of measure for the given data.

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

Public Enumeration 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.

Private Sub Button2_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button2.Click

    Dim bitmap1 As Bitmap = Bitmap.FromHicon(SystemIcons.Hand.Handle)
    Dim formGraphics As Graphics = Me.CreateGraphics()
    Dim units As GraphicsUnit = GraphicsUnit.Point
    Dim bmpRectangleF As RectangleF = bitmap1.GetBounds(units)
    Dim bmpRectangle As Rectangle = Rectangle.Round(bmpRectangleF)
    formGraphics.DrawRectangle(Pens.Blue, bmpRectangle)
    formGraphics.Dispose()
End Sub

.NET Framework
Available since 1.1
Return to top
Show: