Bitmap.GetHbitmap Método

Definición

Crea un objeto de mapa de bits de GDI a partir de un objeto Bitmap de GDI+.Creates a GDI bitmap object from a GDI+ Bitmap.

Sobrecargas

GetHbitmap()

Crea un objeto de mapa de bits de GDIGDI a partir de este objeto Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

Crea un objeto de mapa de bits de GDIGDI a partir de este objeto Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap()

Crea un objeto de mapa de bits de GDIGDI a partir de este objeto 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

Devoluciones

IntPtr

Identificador del objeto de mapa de bits GDIGDI que crea este método.A handle to the GDIGDI bitmap object that this method creates.

Excepciones

El alto o ancho del mapa de bits es mayor que MaxValue.The height or width of the bitmap is greater than MaxValue.

Error en la operación.The operation failed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método GetHbitmap.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

Comentarios

Usted es responsable de llamar al GDIGDI DeleteObject método para liberar la memoria que usa el GDIGDI objeto de mapa de bits.You are responsible for calling the GDIGDI DeleteObject method to free the memory used by the GDIGDI bitmap object. Para obtener más información acerca de los mapas de bits de GDI, vea mapas de bits en la documentación de Windows GDI.For more information about GDI bitmaps, see Bitmaps in the Windows GDI documentation.

Se aplica a

GetHbitmap(Color)

Crea un objeto de mapa de bits de GDIGDI a partir de este objeto 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

Parámetros

background
Color

Estructura Color que especifica el color de fondo.A Color structure that specifies the background color. Este parámetro se pasa por alto si el mapa de bits es totalmente opaco.This parameter is ignored if the bitmap is totally opaque.

Devoluciones

IntPtr

Identificador del objeto de mapa de bits GDIGDI que crea este método.A handle to the GDIGDI bitmap object that this method creates.

Excepciones

El alto o ancho del mapa de bits es mayor que MaxValue.The height or width of the bitmap is greater than MaxValue.

Error en la operación.The operation failed.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el GetHbitmap método.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

Comentarios

Usted es responsable de llamar al GDIGDI DeleteObject método para liberar la memoria que usa el GDIGDI objeto de mapa de bits.You are responsible for calling the GDIGDI DeleteObject method to free the memory used by the GDIGDI bitmap object. Para obtener más información acerca de los mapas de bits de GDI, vea mapas de bits en la documentación de Windows GDI.For more information about GDI bitmaps, see Bitmaps in the Windows GDI documentation.

Se aplica a