Bitmap.GetHbitmap Metoda

Definice

Vytvoří objekt rastrového obrázku GDI z rozhraní GDI+ Bitmap .Creates a GDI bitmap object from a GDI+ Bitmap.

Přetížení

GetHbitmap()

Vytvoří GDIGDI z tohoto objektu rastrový objekt Bitmap .Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

Vytvoří GDIGDI z tohoto objektu rastrový objekt Bitmap .Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap()

Vytvoří GDIGDI z tohoto objektu rastrový objekt Bitmap .Creates a GDIGDI bitmap object from this Bitmap.

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

Návraty

IntPtr

Popisovač GDIGDI objektu rastrového obrázku, který tato metoda vytvoří.A handle to the GDIGDI bitmap object that this method creates.

Výjimky

Výška nebo šířka rastrového obrázku je větší než MaxValue .The height or width of the bitmap is greater than MaxValue.

Operace se nezdařila.The operation failed.

Příklady

Následující příklad kódu ukazuje, jak použít GetHbitmap metodu.The following code example demonstrates how to use the GetHbitmap method.

   [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

Poznámky

Zodpovídáte za volání GDIGDI DeleteObject metody pro uvolnění paměti používané GDIGDI objektem rastrového obrázku.You are responsible for calling the GDIGDI DeleteObject method to free the memory used by the GDIGDI bitmap object. Další informace o rastrových obrázkech GDI najdete v části bitmapy v dokumentaci k Windows GDI.For more information about GDI bitmaps, see Bitmaps in the Windows GDI documentation.

GetHbitmap(Color)

Vytvoří GDIGDI z tohoto objektu rastrový objekt Bitmap .Creates a GDIGDI bitmap object from this 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

Parametry

background
Color

ColorStruktura, která určuje barvu pozadí.A Color structure that specifies the background color. Tento parametr je ignorován, pokud je rastr zcela neprůhledný.This parameter is ignored if the bitmap is totally opaque.

Návraty

IntPtr

Popisovač GDIGDI objektu rastrového obrázku, který tato metoda vytvoří.A handle to the GDIGDI bitmap object that this method creates.

Výjimky

Výška nebo šířka rastrového obrázku je větší než MaxValue .The height or width of the bitmap is greater than MaxValue.

Operace se nezdařila.The operation failed.

Příklady

Následující příklad kódu ukazuje, jak použít GetHbitmap metodu.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 );
}

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

Poznámky

Zodpovídáte za volání GDIGDI DeleteObject metody pro uvolnění paměti používané GDIGDI objektem rastrového obrázku.You are responsible for calling the GDIGDI DeleteObject method to free the memory used by the GDIGDI bitmap object. Další informace o rastrových obrázkech GDI najdete v části bitmapy v dokumentaci k Windows GDI.For more information about GDI bitmaps, see Bitmaps in the Windows GDI documentation.

Platí pro