Bitmap.GetHbitmap Method (Color)

Creates a GDI bitmap object from this Bitmap.

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

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

Parameters

background

A Color structure that specifies the background color. This parameter is ignored if the bitmap is totally opaque.

Return Value

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

Exception typeCondition

ArgumentException

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

Exception

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.

void DemonstrateGetHbitmapWithColor()
{
   Bitmap^ bm = gcnew Bitmap( "Picture.jpg" );
   IntPtr hBitmap = bm->GetHbitmap( Color::Blue );
   
   // Do something with hBitmap.
   DeleteObject( 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

Community Additions

ADD
Show: