Bitmap.GetHbitmap Methode

  • Referenz

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Paket:
System.Drawing.Common v6.0.0
Paket:
System.Drawing.Common v7.0.0
Paket:
System.Drawing.Common v8.0.0
Paket:
System.Drawing.Common v9.0.0-preview.2.24128.3

Erstellt ein GDI-Bitmapobjekt aus einem GDI+-Bitmap.

Überlädt

GetHbitmap()

Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.
GetHbitmap(Color)

Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.

GetHbitmap()

Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs

Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.

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

Gibt zurück

IntPtr

nativeint

Ein Handle für das GDI-Bitmapobjekt, das von dieser Methode erstellt wird.

Ausnahmen

ArgumentException

Die Höhe oder Breite der Bitmap ist größer als Int16.MaxValue.

Exception

Fehler beim Vorgang.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die GetHbitmap-Methode verwenden.

   [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

Hinweise

Sie sind dafür verantwortlich, die GDI-Methode DeleteObject aufzurufen, um den vom GDI-Bitmapobjekt verwendeten Arbeitsspeicher freizugeben. Weitere Informationen zu GDI-Bitmaps finden Sie unter Bitmaps in der Windows GDI-Dokumentation.

Gilt für:

GetHbitmap(Color)

Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs

Erstellt ein GDI-Bitmapobjekt aus diesem Bitmap.

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

Parameter

background
Color

Eine Color-Struktur, die die Hintergrundfarbe angibt. Dieser Parameter wird ignoriert, wenn die Bitmap nicht transparent ist.

Gibt zurück

IntPtr

nativeint

Ein Handle für das GDI-Bitmapobjekt, das von dieser Methode erstellt wird.

Ausnahmen

ArgumentException

Die Höhe oder Breite der Bitmap ist größer als Int16.MaxValue.

Exception

Fehler beim Vorgang.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetHbitmapMETHODE verwendet wird.

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

Hinweise

Sie sind dafür verantwortlich, die GDI-Methode DeleteObject aufzurufen, um den vom GDI-Bitmapobjekt verwendeten Arbeitsspeicher freizugeben. Weitere Informationen zu GDI-Bitmaps finden Sie unter Bitmaps in der Windows GDI-Dokumentation.

Gilt für: