Bitmap.GetHbitmap Metoda

Definicja

Tworzy obiekt mapy bitowej GDI z GDI+ Bitmap.

Przeciążenia

GetHbitmap()

Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .

GetHbitmap(Color)

Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .

GetHbitmap()

Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .

public:
 IntPtr GetHbitmap();
public IntPtr GetHbitmap ();
member this.GetHbitmap : unit -> nativeint
Public Function GetHbitmap () As IntPtr

Zwraca

IntPtr

nativeint

Uchwyt obiektu mapy bitowej GDI tworzonego przez tę metodę.

Wyjątki

Wysokość lub szerokość mapy bitowej jest większa niż Int16.MaxValue.

Operacja nie powiodła się.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać GetHbitmap metody .

   [System::Runtime::InteropServices::DllImportAttribute("gdi32.dll")]
   static bool DeleteObject( IntPtr hObject );

private:
   void DemonstrateGetHbitmap()
   {
      Bitmap^ bm = gcnew Bitmap( "Picture.jpg" );
      IntPtr hBitmap = bm->GetHbitmap();
      
      // Do something with hBitmap.
      DeleteObject( hBitmap );
   }
[System.Runtime.InteropServices.DllImport("gdi32.dll")]
public static extern bool DeleteObject(IntPtr hObject);

private void DemonstrateGetHbitmap()
{
    Bitmap bm = new Bitmap("Picture.jpg");
    IntPtr hBitmap = bm.GetHbitmap();

    // Do something with hBitmap.
    DeleteObject(hBitmap);
}
<System.Runtime.InteropServices.DllImportAttribute("gdi32.dll")> _
    Private Shared Function DeleteObject (ByVal hObject As IntPtr) As Boolean
    End Function
   


    Private Sub DemonstrateGetHbitmap()
        Dim bm As New Bitmap("Picture.jpg")
        Dim hBitmap As IntPtr
        hBitmap = bm.GetHbitmap()

        ' Do something with hBitmap.
        DeleteObject(hBitmap)
    End Sub

Uwagi

Użytkownik jest odpowiedzialny za wywoływanie metody GDI DeleteObject w celu zwolnienia pamięci używanej przez obiekt mapy bitowej GDI. Aby uzyskać więcej informacji na temat map bitowych GDI, zobacz Mapy bitowe w dokumentacji GDI systemu Windows.

Dotyczy

GetHbitmap(Color)

Tworzy obiekt mapy bitowej GDI na podstawie tego Bitmapobiektu .

public:
 IntPtr GetHbitmap(System::Drawing::Color background);
public IntPtr GetHbitmap (System.Drawing.Color background);
member this.GetHbitmap : System.Drawing.Color -> nativeint
Public Function GetHbitmap (background As Color) As IntPtr

Parametry

background
Color

Struktura Color określająca kolor tła. Ten parametr jest ignorowany, jeśli mapa bitowa jest całkowicie nieprzezroczysta.

Zwraca

IntPtr

nativeint

Uchwyt obiektu mapy bitowej GDI tworzonego przez tę metodę.

Wyjątki

Wysokość lub szerokość mapy bitowej jest większa niż Int16.MaxValue.

Operacja nie powiodła się.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać GetHbitmapmetody .method.

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

private void DemonstrateGetHbitmapWithColor()
{
    Bitmap bm = new Bitmap("Picture.jpg");
    IntPtr hBitmap = bm.GetHbitmap(Color.Blue);

    // Do something with hBitmap.
    DeleteObject(hBitmap);
}

Private Sub DemonstrateGetHbitmapWithColor()
    Dim bm As New Bitmap("Picture.jpg")
    Dim hBitmap As IntPtr
    hBitmap = bm.GetHbitmap(Color.Blue)

    ' Do something with hBitmap.
    DeleteObject(hBitmap)
End Sub

Uwagi

Użytkownik jest odpowiedzialny za wywoływanie metody GDI DeleteObject w celu zwolnienia pamięci używanej przez obiekt mapy bitowej GDI. Aby uzyskać więcej informacji na temat map bitowych GDI, zobacz Mapy bitowe w dokumentacji GDI systemu Windows.

Dotyczy