Image Classe

Definição

Uma classe base abstrata que fornece funcionalidade para as classes descendentes Bitmap e Metafile.

public ref class Image abstract : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter("System.Drawing.ImageConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
[System.Serializable]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter("System.Drawing.ImageConverter, System.Windows.Extensions, Version=4.0.0.0, Culture=neutral, PublicKeyToken=cc7b13ffcd2ddd51")>]
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
type Image = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
[<System.Serializable>]
type Image = class
    inherit MarshalByRefObject
    interface IDisposable
    interface ICloneable
    interface ISerializable
[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Image = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public MustInherit Class Image
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Herança
Derivado
Atributos
Implementações

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms. É um manipulador para o Paint evento. Um Graphics objeto é passado para o evento e é usado para desenhar a imagem no formulário. O código executa as seguintes ações:

  • Cria uma imagem de um arquivo chamado SampImag.jpg. Esse arquivo deve estar localizado na mesma pasta que o arquivo executável do aplicativo.

  • Cria um ponto no qual desenhar o canto superior esquerdo da imagem.

  • Desenha a imagem não dimensionada no formulário.

private:
   void ImageExampleForm_Paint(System::Object^  sender, System::Windows::Forms::PaintEventArgs^  e) 
   {
      // Create image.
      Image^ newImage = Image::FromFile( "SampImag.jpg" );

      // Create Point for upper-left corner of image.
      Point ulCorner = Point(100,100);

      // Draw image to screen.
      e->Graphics->DrawImage( newImage, ulCorner );
   }
private void ImageExampleForm_Paint(object sender, PaintEventArgs e)
{         
    // Create image.
    Image newImage = Image.FromFile("SampImag.jpg");
             
    // Create Point for upper-left corner of image.
    Point ulCorner = new Point(100, 100);
             
    // Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner);
}
Private Sub ImageExampleForm_Paint _
    (ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.PaintEventArgs) _
    Handles MyBase.Paint


    ' Create image.
    Dim newImage As Image = Image.FromFile("SampImag.jpg")

    ' Create Point for upper-left corner of image.
    Dim ulCorner As New Point(100, 100)

    ' Draw image to screen.
    e.Graphics.DrawImage(newImage, ulCorner)
End Sub

Comentários

Para desenhar um Image em um Formulário do Windows, use um dos DrawImage métodos.

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.

Propriedades

Flags

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

FrameDimensionsList

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

Height

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

HorizontalResolution

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

Palette

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

PhysicalDimension

Obtém a largura e a altura dessa imagem.

PixelFormat

Obtém o formato de pixel para este Image.

PropertyIdList

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

PropertyItems

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

RawFormat

Obtém o formato de arquivo deste Image.

Size

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

Tag

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

VerticalResolution

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

Width

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

Métodos

Clone()

Cria uma cópia exata deste Image.

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.

Dispose(Boolean)

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

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
Finalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.

FromFile(String)

Cria um Image com base no arquivo especificado.

FromFile(String, Boolean)

Cria um Image do arquivo especificado usando informações de gerenciamento de cores incorporadas nesse arquivo.

FromHbitmap(IntPtr)

Cria um Bitmap de um identificador para um bitmap de GDI.

FromHbitmap(IntPtr, IntPtr)

Cria um Bitmap de um identificador para um bitmap GDI e um identificador para uma paleta GDI.

FromStream(Stream)

Cria um Image do fluxo de dados especificado.

FromStream(Stream, Boolean)

Cria um Image por meio do fluxo de dados especificado, opcionalmente usando as informações de gerenciamento de cores inseridas nesse fluxo.

FromStream(Stream, Boolean, Boolean)

Cria um Image por meio do fluxo de dados especificado, opcionalmente usando as informações de gerenciamento de cores inseridas e validando os dados da imagem.

GetBounds(GraphicsUnit)

Obtém os limites da imagem na unidade especificada.

GetEncoderParameterList(Guid)

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

GetFrameCount(FrameDimension)

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

GetHashCode()

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

(Herdado de Object)
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)
GetPixelFormatSize(PixelFormat)

Retorna a intensidade da cor, em número de bits por pixel, do formato de pixel especificado.

GetPropertyItem(Int32)

Obtém o item de propriedade especificado deste Image.

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

Retorna uma miniatura para este 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)
IsAlphaPixelFormat(PixelFormat)

Retorna um valor que indica se o formato de pixel para esta Image contém informações de alfa.

IsCanonicalPixelFormat(PixelFormat)

Retorna um valor que indica se o formato de pixel é de 32 bits por pixel.

IsExtendedPixelFormat(PixelFormat)

Retorna um valor que indica se o formato de pixel é de 64 bits por pixel.

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.

RotateFlip(RotateFlipType)

Gira, inverte ou gira e inverte o Image.

Save(Stream, ImageCodecInfo, EncoderParameters)

Salva essa imagem no fluxo especificado, com os parâmetros de codificador de imagens e codificador especificados.

Save(Stream, ImageFormat)

Salva essa imagem no fluxo especificado no formato especificado.

Save(String)

Salva este Image no arquivo ou fluxo especificado.

Save(String, ImageCodecInfo, EncoderParameters)

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

Save(String, ImageFormat)

Salva essa Image no arquivo especificado no formato especificado.

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.

SaveAdd(Image, EncoderParameters)

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

SelectActiveFrame(FrameDimension, Int32)

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

SetPropertyItem(PropertyItem)

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

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Implantações explícitas de interface

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

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

Aplica-se a

Confira também