Bitmap Classe

Definição

Encapsula um bitmap GDI+, que consiste nos dados de pixel de uma imagem de elementos gráficos e seus atributos.Encapsulates a GDI+ bitmap, which consists of the pixel data for a graphics image and its attributes. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de pixel.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
Herança
Atributos

Exemplos

O exemplo de código a seguir demonstra como construir um novo Bitmap de um arquivo, usando os métodos GetPixel e SetPixel para recolorir a imagem.The following code example demonstrates how to construct a new Bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. Ele também usa as propriedades PixelFormat, Widthe Height.It also uses the PixelFormat, Width, and Height properties.

Este exemplo foi projetado para ser usado com um Windows Forms que contém um Label, PictureBoxe Button chamado Label1, PictureBox1e 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. Cole o código no formulário e associe o método Button1_Click ao evento Click do botão.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

Comentários

Um bitmap consiste nos dados de pixel de uma imagem gráfica e seus atributos.A bitmap consists of the pixel data for a graphics image and its attributes. Há muitos formatos padrão para salvar um bitmap em um arquivo.There are many standard formats for saving a bitmap to a file. o GDI+GDI+ dá suporte aos seguintes formatos de arquivo: BMP, GIF, EXIF, JPG, PNG e TIFF.GDI+GDI+ supports the following file formats: BMP, GIF, EXIF, JPG, PNG and TIFF. Para obter mais informações sobre formatos com suporte, consulte tipos de bitmaps.For more information about supported formats, see Types of Bitmaps.

Você pode criar imagens de arquivos, fluxos e outras fontes usando um dos construtores de Bitmap e salvá-los em um fluxo ou no sistema de arquivos com o 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. As imagens são desenhadas na tela ou na memória usando o método DrawImage do objeto Graphics.Images are drawn to the screen or to memory by using the DrawImage method of the Graphics object. Para obter uma lista de tópicos sobre como trabalhar com arquivos de imagem, consulte trabalhando com imagens, bitmaps, ícones e metaarquivos.For a list of topics about working with image files, see Working with Images, Bitmaps, Icons, and Metafiles.

Observação

A classe Bitmap não é acessível entre domínios de aplicativo.The Bitmap class is not accessible across application domains. Por exemplo, se você criar um AppDomain dinâmico e criar vários pincéis, canetas e bitmaps nesse domínio, passar esses objetos de volta para o domínio principal do aplicativo, você poderá usar com êxito as canetas e os pincéis.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. No entanto, se você chamar o método DrawImage para desenhar o Bitmapcom marshaling, você receberá a seguinte exceção.However, if you call the DrawImage method to draw the marshaled Bitmap, you receive the following exception.

A comunicação remota não pode localizar o campo "imagem nativa" no tipo "System. Drawing. Image".Remoting cannot find field "native image" on type "System.Drawing.Image".

Construtores

Bitmap(Image)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada.Initializes a new instance of the Bitmap class from the specified existing image.

Bitmap(Image, Int32, Int32)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada, dimensionada para o tamanho especificado.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Image, Size)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada, dimensionada para o tamanho especificado.Initializes a new instance of the Bitmap class from the specified existing image, scaled to the specified size.

Bitmap(Int32, Int32)

Inicializa uma nova instância da classe Bitmap com o tamanho especificado.Initializes a new instance of the Bitmap class with the specified size.

Bitmap(Int32, Int32, Graphics)

Inicializa uma nova instância da classe Bitmap com o tamanho especificado e a resolução do 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 uma nova instância da classe Bitmap com o tamanho, o formato de pixel e os dados de pixel especificados.Initializes a new instance of the Bitmap class with the specified size, pixel format, and pixel data.

Bitmap(Int32, Int32, PixelFormat)

Inicializa uma nova instância da classe Bitmap com o tamanho e o formato especificados.Initializes a new instance of the Bitmap class with the specified size and format.

Bitmap(Stream)

Inicializa uma nova instância da classe Bitmap do fluxo de dados especificado.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(Stream, Boolean)

Inicializa uma nova instância da classe Bitmap do fluxo de dados especificado.Initializes a new instance of the Bitmap class from the specified data stream.

Bitmap(String)

Inicializa uma nova instância da classe Bitmap do arquivo especificado.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(String, Boolean)

Inicializa uma nova instância da classe Bitmap do arquivo especificado.Initializes a new instance of the Bitmap class from the specified file.

Bitmap(Type, String)

Inicializa uma nova instância da classe Bitmap de um recurso especificado.Initializes a new instance of the Bitmap class from a specified resource.

Propriedades

Flags

Obtém sinalizadores de atributo para os dados de pixel deste Image.Gets attribute flags for the pixel data of this Image.

(Herdado de Image)
FrameDimensionsList

Obtém uma matriz de GUIDs que representam as dimensões dos quadros neste Image.Gets an array of GUIDs that represent the dimensions of frames within this Image.

(Herdado de Image)
Height

Obtém a altura, em pixels, deste Image.Gets the height, in pixels, of this Image.

(Herdado de Image)
HorizontalResolution

Obtém a resolução horizontal, em pixels por polegada, desta Image.Gets the horizontal resolution, in pixels per inch, of this Image.

(Herdado de Image)
Palette

Obtém ou define a paleta de cores usada para este Image.Gets or sets the color palette used for this Image.

(Herdado de Image)
PhysicalDimension

Obtém a largura e a altura dessa imagem.Gets the width and height of this image.

(Herdado de Image)
PixelFormat

Obtém o formato de pixel para este Image.Gets the pixel format for this Image.

(Herdado de Image)
PropertyIdList

Obtém as IDs dos itens de propriedade armazenados neste Image.Gets IDs of the property items stored in this Image.

(Herdado de Image)
PropertyItems

Obtém todos os itens de propriedade (partes de metadados) armazenados neste Image.Gets all the property items (pieces of metadata) stored in this Image.

(Herdado de Image)
RawFormat

Obtém o formato de arquivo deste Image.Gets the file format of this Image.

(Herdado de Image)
Size

Obtém a largura e a altura, em pixels, dessa imagem.Gets the width and height, in pixels, of this image.

(Herdado de Image)
Tag

Obtém ou define um objeto que fornece dados adicionais sobre a imagem.Gets or sets an object that provides additional data about the image.

(Herdado de Image)
VerticalResolution

Obtém a resolução vertical, em pixels por polegada, dessa Image.Gets the vertical resolution, in pixels per inch, of this Image.

(Herdado de Image)
Width

Obtém a largura, em pixels, desse Image.Gets the width, in pixels, of this Image.

(Herdado de Image)

Métodos

Clone()

Cria uma cópia exata deste Image.Creates an exact copy of this Image.

(Herdado de Image)
Clone(Rectangle, PixelFormat)

Cria uma cópia da seção deste Bitmap definida pela estrutura Rectangle e com uma enumeração PixelFormat especificada.Creates a copy of the section of this Bitmap defined by Rectangle structure and with a specified PixelFormat enumeration.

Clone(RectangleF, PixelFormat)

Cria uma cópia da seção desse Bitmap definida com uma enumeração PixelFormat especificada.Creates a copy of the section of this Bitmap defined with a specified PixelFormat enumeration.

CreateObjRef(Type)

Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados por este Image.Releases all resources used by this Image.

(Herdado de Image)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Image e, opcionalmente, libera os recursos gerenciados.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

(Herdado de Image)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
FromHicon(IntPtr)

Cria um Bitmap de um identificador do Windows para um ícone.Creates a Bitmap from a Windows handle to an icon.

FromResource(IntPtr, String)

Cria um Bitmap do recurso do Windows especificado.Creates a Bitmap from the specified Windows resource.

GetBounds(GraphicsUnit)

Obtém os limites da imagem na unidade especificada.Gets the bounds of the image in the specified unit.

(Herdado de Image)
GetEncoderParameterList(Guid)

Retorna informações sobre os parâmetros com suporte do codificador de imagem especificado.Returns information about the parameters supported by the specified image encoder.

(Herdado de Image)
GetFrameCount(FrameDimension)

Retorna o número de quadros da dimensão especificada.Returns the number of frames of the specified dimension.

(Herdado de Image)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetHbitmap()

Cria um objeto de bitmap GDIGDI com base neste Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHbitmap(Color)

Cria um objeto de bitmap GDIGDI com base neste Bitmap.Creates a GDIGDI bitmap object from this Bitmap.

GetHicon()

Retorna o identificador para um ícone.Returns the handle to an icon.

GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Herdado de MarshalByRefObject)
GetPixel(Int32, Int32)

Obtém a cor do pixel especificado neste Bitmap.Gets the color of the specified pixel in this Bitmap.

GetPropertyItem(Int32)

Obtém o item de propriedade especificado deste Image.Gets the specified property item from this Image.

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

Retorna uma miniatura para este Image.Returns a thumbnail for this Image.

(Herdado de Image)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Bloqueia um Bitmap na memória do sistema.Locks a Bitmap into system memory.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Bloqueia um Bitmap na memória do sistema.Locks a Bitmap into system memory.

MakeTransparent()

Torna a cor transparente padrão transparente para este Bitmap.Makes the default transparent color transparent for this Bitmap.

MakeTransparent(Color)

Torna a cor especificada transparente para este Bitmap.Makes the specified color transparent for this Bitmap.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Herdado de MarshalByRefObject)
RemovePropertyItem(Int32)

Remove o item de propriedade especificado desta Image.Removes the specified property item from this Image.

(Herdado de Image)
RotateFlip(RotateFlipType)

Gira, inverte ou gira e inverte o Image.Rotates, flips, or rotates and flips the Image.

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

Salva essa imagem no fluxo especificado, com os parâmetros de codificador de imagens e codificador especificados.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

(Herdado de Image)
Save(Stream, ImageFormat)

Salva essa imagem no fluxo especificado no formato especificado.Saves this image to the specified stream in the specified format.

(Herdado de Image)
Save(String)

Salva este Image no arquivo ou fluxo especificado.Saves this Image to the specified file or stream.

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

Salva esse Image no arquivo especificado, com os parâmetros de codificador de imagens e codificador especificados.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

(Herdado de Image)
Save(String, ImageFormat)

Salva essa Image no arquivo especificado no formato especificado.Saves this Image to the specified file in the specified format.

(Herdado de Image)
SaveAdd(EncoderParameters)

Adiciona um quadro para o arquivo ou fluxo especificado em uma chamada anterior para o método Save.Adds a frame to the file or stream specified in a previous call to the Save method. Use esse método para salvar quadros selecionados de uma imagem de vários quadros em outra imagem de vários quadros.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

(Herdado de Image)
SaveAdd(Image, EncoderParameters)

Adiciona um quadro para o arquivo ou fluxo especificado em uma chamada anterior para o método Save.Adds a frame to the file or stream specified in a previous call to the Save method.

(Herdado de Image)
SelectActiveFrame(FrameDimension, Int32)

Seleciona o quadro especificado pela dimensão e pelo índice.Selects the frame specified by the dimension and index.

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

Define a cor do pixel especificado neste Bitmap.Sets the color of the specified pixel in this Bitmap.

SetPropertyItem(PropertyItem)

Armazena um item de propriedade (parte de metadados) neste Image.Stores a property item (piece of metadata) in this Image.

(Herdado de Image)
SetResolution(Single, Single)

Define a resolução para esse Bitmap.Sets the resolution for this Bitmap.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
UnlockBits(BitmapData)

Desbloqueia este Bitmap da memória do sistema.Unlocks this Bitmap from system memory.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.Populates a SerializationInfo with the data needed to serialize the target object.

(Herdado de Image)

Aplica-se a

Veja também