Bitmap Classe

Definição

Encapsula um bitmap GDI+, que consiste nos dados de pixel de uma imagem de elementos gráficos e seus atributos. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de pixel.

public ref class Bitmap sealed : System::Drawing::Image
public sealed class Bitmap : System.Drawing.Image
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
[<System.Serializable>]
type Bitmap = class
    inherit Image
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
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 a partir de um arquivo, usando os GetPixel métodos e SetPixel para recolorir a imagem. Ele também usa as PixelFormatpropriedades , Widthe Height .

Este exemplo foi projetado para ser usado com um Windows Forms que contém um Label, PictureBoxe Button chamados Label1, PictureBox1e Button1, respectivamente. Cole o código no formulário e associe o Button1_Click método ao evento do Click botão.

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 para uma imagem gráfica e seus atributos. Há muitos formatos padrão para salvar um bitmap em um arquivo. O GDI+ dá suporte aos seguintes formatos de arquivo: BMP, GIF, EXIF, JPG, PNG e TIFF. Para obter mais informações sobre formatos com suporte, consulte Tipos de Bitmaps.

Você pode criar imagens de arquivos, fluxos e outras fontes usando um dos Bitmap construtores e salvá-las em um fluxo ou no sistema de arquivos com o Save método . As imagens são desenhadas na tela ou na memória usando o DrawImage método do Graphics objeto . Para obter uma lista de tópicos sobre como trabalhar com arquivos de imagem, consulte Trabalhando com imagens, bitmaps, ícones e metarquivos.

Observação

No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só tem suporte em sistemas operacionais Windows. O uso desse tipo em aplicativos multiplataforma causa avisos de tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common com suporte apenas no Windows.

Observação

A Bitmap classe não está acessível entre domínios de aplicativo. Por exemplo, se você criar um dinâmico AppDomain e criar vários pincéis, canetas e bitmaps nesse domínio, passe esses objetos de volta para o domínio do aplicativo main, poderá usar com êxito as canetas e pincéis. No entanto, se você chamar o DrawImage método para desenhar o marshaled Bitmap, receberá a seguinte exceção:

A comunicação remota não pode localizar o campo "imagem nativa" no tipo "System.Drawing.Image".

Construtores

Bitmap(Image)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada.

Bitmap(Image, Int32, Int32)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada, dimensionada para o tamanho especificado.

Bitmap(Image, Size)

Inicializa uma nova instância da classe Bitmap da imagem existente especificada, dimensionada para o tamanho especificado.

Bitmap(Int32, Int32)

Inicializa uma nova instância da classe Bitmap com o tamanho especificado.

Bitmap(Int32, Int32, Graphics)

Inicializa uma nova instância da classe Bitmap com o tamanho especificado e a resolução do objeto Graphics especificado.

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.

Bitmap(Int32, Int32, PixelFormat)

Inicializa uma nova instância da classe Bitmap com o tamanho e o formato especificados.

Bitmap(Stream)

Inicializa uma nova instância da classe Bitmap do fluxo de dados especificado.

Bitmap(Stream, Boolean)

Inicializa uma nova instância da classe Bitmap do fluxo de dados especificado.

Bitmap(String)

Inicializa uma nova instância da classe Bitmap do arquivo especificado.

Bitmap(String, Boolean)

Inicializa uma nova instância da classe Bitmap do arquivo especificado.

Bitmap(Type, String)

Inicializa uma nova instância da classe Bitmap de um recurso especificado.

Propriedades

Flags

Obtém sinalizadores de atributo para os dados de pixel deste Image.

(Herdado de Image)
FrameDimensionsList

Obtém uma matriz de GUIDs que representam as dimensões dos quadros neste Image.

(Herdado de Image)
Height

Obtém a altura, em pixels, deste Image.

(Herdado de Image)
HorizontalResolution

Obtém a resolução horizontal, em pixels por polegada, desta Image.

(Herdado de Image)
Palette

Obtém ou define a paleta de cores usada para este Image.

(Herdado de Image)
PhysicalDimension

Obtém a largura e a altura dessa imagem.

(Herdado de Image)
PixelFormat

Obtém o formato de pixel para este Image.

(Herdado de Image)
PropertyIdList

Obtém as IDs dos itens de propriedade armazenados neste Image.

(Herdado de Image)
PropertyItems

Obtém todos os itens de propriedade (partes de metadados) armazenados neste Image.

(Herdado de Image)
RawFormat

Obtém o formato de arquivo deste Image.

(Herdado de Image)
Size

Obtém a largura e a altura, em pixels, dessa imagem.

(Herdado de Image)
Tag

Obtém ou define um objeto que fornece dados adicionais sobre a imagem.

(Herdado de Image)
VerticalResolution

Obtém a resolução vertical, em pixels por polegada, dessa Image.

(Herdado de Image)
Width

Obtém a largura, em pixels, desse Image.

(Herdado de Image)

Métodos

ApplyEffect(Effect, Rectangle)

Encapsula um bitmap GDI+, que consiste nos dados de pixel de uma imagem de elementos gráficos e seus atributos. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de pixel.

Clone()

Cria uma cópia exata deste 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.

Clone(RectangleF, PixelFormat)

Cria uma cópia da seção desse Bitmap definida com uma enumeração PixelFormat especificada.

ConvertFormat(PixelFormat)

Encapsula um bitmap GDI+, que consiste nos dados de pixel de uma imagem de elementos gráficos e seus atributos. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de pixel.

ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)

Encapsula um bitmap GDI+, que consiste nos dados de pixel de uma imagem de elementos gráficos e seus atributos. A Bitmap é um objeto usado para trabalhar com imagens definidas por dados de pixel.

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.

(Herdado de MarshalByRefObject)
Dispose()

Libera todos os recursos usados por este Image.

(Herdado de Image)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Image e opcionalmente libera os recursos gerenciados.

(Herdado de Image)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FromHicon(IntPtr)

Cria um Bitmap de um identificador do Windows para um ícone.

FromResource(IntPtr, String)

Cria um Bitmap do recurso do Windows especificado.

GetBounds(GraphicsUnit)

Obtém os limites da imagem na unidade especificada.

(Herdado de Image)
GetEncoderParameterList(Guid)

Retorna informações sobre os parâmetros com suporte do codificador de imagem especificado.

(Herdado de Image)
GetFrameCount(FrameDimension)

Retorna o número de quadros da dimensão especificada.

(Herdado de Image)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetHbitmap()

Cria um objeto de bitmap GDI com base neste Bitmap.

GetHbitmap(Color)

Cria um objeto de bitmap GDI com base neste Bitmap.

GetHicon()

Retorna o identificador para um ícone.

GetLifetimeService()
Obsoleto.

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.

(Herdado de MarshalByRefObject)
GetPixel(Int32, Int32)

Obtém a cor do pixel especificado neste Bitmap.

GetPropertyItem(Int32)

Obtém o item de propriedade especificado deste Image.

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

Retorna uma miniatura para este Image.

(Herdado de Image)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
InitializeLifetimeService()
Obsoleto.

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.

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

Bloqueia um Bitmap na memória do sistema.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Bloqueia um Bitmap na memória do sistema.

MakeTransparent()

Torna a cor transparente padrão transparente para este Bitmap.

MakeTransparent(Color)

Torna a cor especificada transparente para este Bitmap.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.

(Herdado de MarshalByRefObject)
RemovePropertyItem(Int32)

Remove o item de propriedade especificado desta Image.

(Herdado de Image)
RotateFlip(RotateFlipType)

Gira, inverte ou gira e inverte o 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.

(Herdado de Image)
Save(Stream, ImageFormat)

Salva essa imagem no fluxo especificado no formato especificado.

(Herdado de Image)
Save(String)

Salva este Image no arquivo ou fluxo especificado.

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

Salva esse Image no arquivo especificado, com os parâmetros de codificador de imagens e codificador especificados.

(Herdado de Image)
Save(String, ImageFormat)

Salva essa Image no arquivo especificado no formato especificado.

(Herdado de Image)
SaveAdd(EncoderParameters)

Adiciona um quadro para o arquivo ou fluxo especificado em uma chamada anterior para o método Save. Use esse método para salvar quadros selecionados de uma imagem de vários quadros em outra imagem de vários quadros.

(Herdado de Image)
SaveAdd(Image, EncoderParameters)

Adiciona um quadro para o arquivo ou fluxo especificado em uma chamada anterior para o método Save.

(Herdado de Image)
SelectActiveFrame(FrameDimension, Int32)

Seleciona o quadro especificado pela dimensão e pelo índice.

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

Define a cor do pixel especificado neste Bitmap.

SetPropertyItem(PropertyItem)

Armazena um item de propriedade (parte de metadados) neste Image.

(Herdado de Image)
SetResolution(Single, Single)

Define a resolução para esse Bitmap.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
UnlockBits(BitmapData)

Desbloqueia este Bitmap da memória do sistema.

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popula um SerializationInfo com os dados necessários para serializar o objeto de destino.

(Herdado de Image)

Aplica-se a

Confira também