Bitmap Clase

Definición

Encapsula un mapa de bits de GDI+, que está formado por los datos de píxeles de una imagen de gráficos y sus atributos.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. Bitmap es un objeto que se utiliza para trabajar con imágenes definidas mediante datos de píxeles.A Bitmap is an object used to work with images defined by pixel data.

public ref class Bitmap sealed : System::Drawing::Image
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
Herencia
Atributos

Ejemplos

En el ejemplo de código siguiente se muestra cómo construir un nuevo Bitmap desde un archivo, utilizando los métodos GetPixel y SetPixel para cambiar el color de la imagen.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. También usa las propiedades PixelFormat, Width y Height.It also uses the PixelFormat, Width, and Height properties.

Este ejemplo está diseñado para usarse con una Windows Forms que contiene un Label, PictureBox y Button denominados Label1, PictureBox1 y Button1, respectivamente.This example is designed to be used with a Windows Forms that contains a Label, PictureBox, and Button named Label1, PictureBox1, and Button1, respectively. Pegue el código en el formulario y asocie el método Button1_Click con el evento Click del botón.Paste the code into the form and associate the Button1_Click method with the button's Click event.

private:
   Bitmap^ image1;
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         
         // Retrieve the image.
         image1 = gcnew Bitmap( "C:\\Documents and Settings\\All Users\\"
         "Documents\\My Music\\music.bmp",true );
         int x;
         int y;
         
         // Loop through the images pixels to reset color.
         for ( x = 0; x < image1->Width; x++ )
         {
            for ( y = 0; y < image1->Height; y++ )
            {
               Color pixelColor = image1->GetPixel( x, y );
               Color newColor = Color::FromArgb( pixelColor.R, 0, 0 );
               image1->SetPixel( x, y, newColor );

            }

         }
         
         // Set the PictureBox to display the image.
         PictureBox1->Image = image1;
         
         // Display the pixel format in Label1.
         Label1->Text = String::Format( "Pixel format: {0}", image1->PixelFormat );
      }
      catch ( ArgumentException^ ) 
      {
         MessageBox::Show( "There was an error."
         "Check the path to the image file." );
      }

   }
Bitmap image1;

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    try
    {
        // Retrieve the image.
        image1 = new Bitmap(@"C:\Documents and Settings\All Users\" 
            + @"Documents\My Music\music.bmp", true);

        int x, y;

        // Loop through the images pixels to reset color.
        for(x=0; x<image1.Width; x++)
        {
            for(y=0; y<image1.Height; y++)
            {
                Color pixelColor = image1.GetPixel(x, y);
                Color newColor = Color.FromArgb(pixelColor.R, 0, 0);
                image1.SetPixel(x, y, newColor);
            }
        }

        // Set the PictureBox to display the image.
        PictureBox1.Image = image1;

        // Display the pixel format in Label1.
        Label1.Text = "Pixel format: "+image1.PixelFormat.ToString();

    }
    catch(ArgumentException)
    {
        MessageBox.Show("There was an error." +
            "Check the path to the image file.");
    }
}
Dim image1 As Bitmap

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    Try
        ' Retrieve the image.
        image1 = New Bitmap( _
            "C:\Documents and Settings\All Users\Documents\My Music\music.bmp", _
            True)

        Dim x, y As Integer

        ' Loop through the images pixels to reset color.
        For x = 0 To image1.Width - 1
            For y = 0 To image1.Height - 1
                Dim pixelColor As Color = image1.GetPixel(x, y)
                Dim newColor As Color = _
                    Color.FromArgb(pixelColor.R, 0, 0)
                image1.SetPixel(x, y, newColor)
            Next
        Next

        ' Set the PictureBox to display the image.
        PictureBox1.Image = image1

        ' Display the pixel format in Label1.
        Label1.Text = "Pixel format: " + image1.PixelFormat.ToString()

    Catch ex As ArgumentException
        MessageBox.Show("There was an error." _
            & "Check the path to the image file.")
    End Try
End Sub

Comentarios

Un mapa de bits se compone de los datos de píxeles de una imagen de gráficos y sus atributos.A bitmap consists of the pixel data for a graphics image and its attributes. Hay muchos formatos estándar para guardar un mapa de bits en un archivo.There are many standard formats for saving a bitmap to a file. GDI+GDI+ admite los siguientes formatos de archivo: BMP, GIF, EXIF, JPG, PNG y TIFF.supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Para obtener más información sobre los formatos admitidos, vea tipos de mapas de bits.For more information about supported formats, see Types of Bitmaps.

Puede crear imágenes de archivos, secuencias y otros orígenes mediante uno de los constructores Bitmap y guardarlos en una secuencia o en el sistema de archivos con el método Save.You can create images from files, streams, and other sources by using one of the Bitmap constructors and save them to a stream or to the file system with the Save method. Las imágenes se dibujan en la pantalla o en la memoria mediante el método DrawImage del objeto Graphics.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. Para obtener una lista de temas sobre cómo trabajar con archivos de imagen, vea trabajar con imágenes, mapas de bits, iconos y metaarchivos.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

Nota

No se puede obtener acceso a la clase Bitmap a través de dominios de aplicación.The Bitmap class is not accessible across application domains. Por ejemplo, si crea una @no__t dinámica-0 y crea varios pinceles, lápices y mapas de bits en ese dominio y, a continuación, pasa estos objetos de nuevo al dominio de aplicación principal, puede usar los lápices y pinceles correctamente.For example, if you create a dynamic AppDomain and create several brushes, pens, and bitmaps in that domain, then pass these objects back to the main application domain, you can successfully use the pens and brushes. Sin embargo, si llama al método DrawImage para dibujar el @no__t de cálculo de referencias, recibirá la siguiente excepción.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

La comunicación remota no encuentra el campo "imagen nativa" en el tipo "System. Drawing. Image".Remoting cannot find field "native image" on type "System.Drawing.Image".

Constructores

Bitmap(Image)

Inicializa una nueva instancia de la clase Bitmap a partir de la imagen especificada existente.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

Inicializa una nueva instancia de la clase Bitmap a partir de la imagen existente especificada, escalada al tamaño especificado.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

Inicializa una nueva instancia de la clase Bitmap a partir de la imagen existente especificada, escalada al tamaño especificado.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

Inicializa una nueva instancia de la clase Bitmap con el tamaño especificado.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

Inicializa una nueva instancia de la clase Bitmap con el tamaño especificado y la resolución del objeto Graphics especificado.Initializes a new instance of the Bitmap class with the specified size and with the resolution of the specified Graphics object.

Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)

Inicializa una nueva instancia de la clase Bitmap con el tamaño, el formato de píxel y los datos de píxel especificados.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

Inicializa una nueva instancia de la clase Bitmap con el tamaño y el formato especificados.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

Inicializa una nueva instancia de la clase Bitmap a partir del flujo de datos especificado.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

Inicializa una nueva instancia de la clase Bitmap a partir del flujo de datos especificado.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

Inicializa una nueva instancia de la clase Bitmap a partir del archivo especificado.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

Inicializa una nueva instancia de la clase Bitmap a partir del archivo especificado.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

Inicializa una nueva instancia de la clase Bitmap a partir de un recurso especificado.Initializes a new instance of the Bitmap class from a specified resource.

Propiedades

Flags

Obtiene marcadores de atributo para los datos de píxel de Image.Gets attribute flags for the pixel data of this Image.

(Heredado de Image)
FrameDimensionsList

Obtiene una matriz de GUID que representa las dimensiones de los marcos dentro de Image.Gets an array of GUIDs that represent the dimensions of frames within this Image.

(Heredado de Image)
Height

Obtiene el alto en píxeles de Image.Gets the height, in pixels, of this Image.

(Heredado de Image)
HorizontalResolution

Obtiene la resolución horizontal, en píxeles por pulgada, de Image.Gets the horizontal resolution, in pixels per inch, of this Image.

(Heredado de Image)
Palette

Obtiene o establece la paleta de colores utilizada para Image.Gets or sets the color palette used for this Image.

(Heredado de Image)
PhysicalDimension

Obtiene el ancho y el alto de esta imagen.Gets the width and height of this image.

(Heredado de Image)
PixelFormat

Obtiene el formato de píxel de Image.Gets the pixel format for this Image.

(Heredado de Image)
PropertyIdList

Obtiene los identificadores de los elementos de propiedad almacenados en Image.Gets IDs of the property items stored in this Image.

(Heredado de Image)
PropertyItems

Obtiene todos los elementos de propiedad (fragmentos de metadatos) almacenados en Image.Gets all the property items (pieces of metadata) stored in this Image.

(Heredado de Image)
RawFormat

Obtiene el formato de archivo de este Image.Gets the file format of this Image.

(Heredado de Image)
Size

Obtiene el ancho y el alto de esta imagen, expresado en píxeles.Gets the width and height, in pixels, of this image.

(Heredado de Image)
Tag

Obtiene o establece un objeto que proporciona datos adicionales sobre la imagen.Gets or sets an object that provides additional data about the image.

(Heredado de Image)
VerticalResolution

Obtiene la resolución vertical, en píxeles por pulgada, de Image.Gets the vertical resolution, in pixels per inch, of this Image.

(Heredado de Image)
Width

Obtiene el ancho en píxeles de Image.Gets the width, in pixels, of this Image.

(Heredado de Image)

Métodos

Clone()

Crea una copia exacta de este objeto Image.Creates an exact copy of this Image.

(Heredado de Image)
Clone(Rectangle, PixelFormat)

Crea una copia de la sección de este objeto Bitmap definida por la estructura Rectangle y con una enumeración PixelFormat especificada.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

Crea una copia de la sección de este objeto Bitmap definida con una enumeración PixelFormat especificada.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos utilizados por este Image.Releases all resources used by this Image.

(Heredado de Image)
Dispose(Boolean)

Libera los recursos no administrados que usa Image y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(Heredado de Image)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
FromHicon(IntPtr)

Crea un objeto Bitmap a partir de un identificador de Windows para un icono.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

Crea un objeto Bitmap a partir del recurso de Windows especificado.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

Obtiene los límites de la imagen en la unidad especificada.Gets the bounds of the image in the specified unit.

(Heredado de Image)
GetEncoderParameterList(Guid)

Devuelve información sobre los parámetros que admite el codificador de imágenes especificado.Returns information about the parameters supported by the specified image encoder.

(Heredado de Image)
GetFrameCount(FrameDimension)

Devuelve el número de marcos de la dimensión especificada.Returns the number of frames of the specified dimension.

(Heredado de Image)
GetHashCode()

Sirve como función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
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.

GetHicon()

Devuelve el identificador de un icono.Returns the handle to an icon.

GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetPixel(Int32, Int32)

Obtiene el color del píxel especificado en este Bitmap.Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

Obtiene el elemento de propiedad especificado de Image.Gets the specified property item from this Image.

(Heredado de Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)

Devuelve una miniatura de Image.Returns a thumbnail for this Image.

(Heredado de Image)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)

Bloquea un objeto Bitmap en la memoria del sistema.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Bloquea un objeto Bitmap en la memoria del sistema.Locks a Bitmap into system memory.

MakeTransparent()

Hace que el color predeterminado sea transparente en este Bitmap.Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

Hace que el color especificado sea transparente para este objeto Bitmap.Makes the specified color transparent for this Bitmap.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
RemovePropertyItem(Int32)

Quita el elemento de propiedad especificado de Image.Removes the specified property item from this Image.

(Heredado de Image)
RotateFlip(RotateFlipType)

Gira, voltea o gira y voltea el Image.Rotates, flips, or rotates and flips the Image.

(Heredado de Image)
Save(Stream, ImageCodecInfo, EncoderParameters)

Guarda esta imagen en la secuencia especificada, con el codificador y los parámetros de codificador de imagen especificados.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(Heredado de Image)
Save(Stream, ImageFormat)

Guarda esta imagen en la secuencia especificada con el formato especificado.Saves this image to the specified stream in the specified format.

(Heredado de Image)
Save(String)

Guarda Image en la secuencia o archivo especificado.Saves this Image to the specified file or stream.

(Heredado de Image)
Save(String, ImageCodecInfo, EncoderParameters)

Guarda Image en el archivo especificado, con el codificador y los parámetros de codificador de imagen especificados.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(Heredado de Image)
Save(String, ImageFormat)

Guarda Image en el archivo especificado con el formato especificado.Saves this Image to the specified file in the specified format.

(Heredado de Image)
SaveAdd(EncoderParameters)

Agrega un marco al archivo o la secuencia especificados en una llamada anterior al método Save.Adds a frame to the file or stream specified in a previous call to the Save method. Utilice este método para guardar los marcos seleccionados de una imagen de varios marcos en otra imagen de varios marcos.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(Heredado de Image)
SaveAdd(Image, EncoderParameters)

Agrega un marco al archivo o la secuencia especificados en una llamada anterior al método Save.Adds a frame to the file or stream specified in a previous call to the Save method.

(Heredado de Image)
SelectActiveFrame(FrameDimension, Int32)

Selecciona el marco que especifican la dimensión y el índice.Selects the frame specified by the dimension and index.

(Heredado de Image)
SetPixel(Int32, Int32, Color)

Establece el color en el píxel especificado en este Bitmap.Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

Almacena un elemento de propiedad (fragmento de metadatos) en Image.Stores a property item (piece of metadata) in this Image.

(Heredado de Image)
SetResolution(Single, Single)

Establece la resolución de este objeto Bitmap.Sets the resolution for this Bitmap.

ToString()

Devuelve un valor de tipo string que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)
UnlockBits(BitmapData)

Desbloquea este objeto Bitmap en la memoria del sistema.Unlocks this Bitmap from system memory.

Implementaciones de interfaz explícitas

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino.Populates a SerializationInfo with the data needed to serialize the target object.

(Heredado de Image)

Se aplica a

Consulte también: