Freigeben über

Bitmap.GetHbitmap Methode

Definition

Namespace:
System.Drawing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Paket:
System.Drawing.Common v11.0.0-preview.3.26207.106

Erstellt ein GDI-Bitmapobjekt aus einem GDI+ Bitmap.

Überlädt

Name Beschreibung
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
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
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 von dieser Methode erstellten GDI-Bitmapobjekt.

Ausnahmen

ArgumentException

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

Exception

Dieser Vorgang ist fehlgeschlagen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetHbitmap Methode veranschaulicht.

   [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 aufzurufen, um den vom GDI-Bitmapobjekt DeleteObject verwendeten Arbeitsspeicher freizugeben. Weitere Informationen zu GDI-Bitmaps finden Sie in der Windows GDI-Dokumentation unter Bitmaps .

Gilt für:

GetHbitmap(Color)

Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
Quelle:
Bitmap.cs
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 völlig undurchsichtig ist.

Gibt zurück

IntPtr

nativeint

Ein Handle für das von dieser Methode erstellten GDI-Bitmapobjekt.

Ausnahmen

ArgumentException

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

Exception

Dieser Vorgang ist fehlgeschlagen.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der GetHbitmap.-Methode veranschaulicht.

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 aufzurufen, um den vom GDI-Bitmapobjekt DeleteObject verwendeten Arbeitsspeicher freizugeben. Weitere Informationen zu GDI-Bitmaps finden Sie in der Windows GDI-Dokumentation unter Bitmaps .

Gilt für: