GetHbitmap Method ()
Collapse the table of content
Expand the table of content

Bitmap.GetHbitmap Method ()

Creates a GDI bitmap object from this Bitmap.

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

public IntPtr GetHbitmap ()
public IntPtr GetHbitmap ()
public function GetHbitmap () : IntPtr
Not applicable.

Return Value

A handle to the GDI bitmap object that this method creates.

Exception typeCondition


The height or width of the bitmap is greater than MaxValue.


The operation failed.

You are responsible for calling the GDIDeleteObject method to free the memory used by the GDI bitmap object.

The following code example demonstrates how to use the GetHbitmap method.

public static extern bool DeleteObject(IntPtr hObject);

private void DemonstrateGetHbitmap() 
    Bitmap bm = new Bitmap("Picture.jpg");
    IntPtr hBitmap = bm.GetHbitmap();
    // Do something with hBitmap.

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0

Community Additions

© 2016 Microsoft