Image Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
public ref class Image abstract : MarshalByRefObject, ICloneable, IDisposable, System::Runtime::Serialization::ISerializable[System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public abstract class Image : MarshalByRefObject, ICloneable, IDisposable, System.Runtime.Serialization.ISerializable[<System.ComponentModel.TypeConverter(typeof(System.Drawing.ImageConverter))>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type Image = class
inherit MarshalByRefObject
interface ISerializable
interface ICloneable
interface IDisposablePublic MustInherit Class Image
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable- Herança
- Derivado
- Atributos
- Implementações
Exemplos
O seguinte exemplo de código foi concebido para uso com Windows Forms. É um responsável pelo Paint evento. Um Graphics objeto é passado ao evento e é usado para desenhar a imagem no formulário. O código executa as seguintes ações:
Cria uma imagem a partir de um ficheiro chamado SampImag.jpg. Este ficheiro deve estar localizado na mesma pasta do ficheiro executável da aplicação.
Cria um ponto onde se desenha o canto superior esquerdo da imagem.
Desenha a imagem não escalada 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
Observações
Para desenhar um Image num formulário Windows, utilize um dos métodos DrawImage.
Note
No .NET 6 e versões posteriores, o pacote System.Drawing.Common, que inclui esse tipo, só é suportado em sistemas operacionais Windows. O uso deste tipo em aplicações multiplataforma causa avisos em tempo de compilação e exceções em tempo de execução. Para obter mais informações, consulte System.Drawing.Common suportado apenas no Windows.
Propriedades
| Name | Description |
|---|---|
| Flags |
Obtém flags de atributos para os dados de píxeis deste Image. |
| FrameDimensionsList |
Obtém um array de GUIDs que representam as dimensões dos frames dentro deste Image. |
| Height |
Obtém a altura, em pixels, deste Image. |
| HorizontalResolution |
Obtém a resolução horizontal, em píxeis por polegada, desta Image. |
| Palette |
Obtém ou define a paleta de cores usada para isto Image. |
| PhysicalDimension |
Obtém a largura e altura desta imagem. |
| PixelFormat |
Obtém o formato de píxeis para isto Image. |
| PropertyIdList |
Obtém IDs dos itens da propriedade armazenados neste Image. |
| PropertyItems |
Obtém todos os itens de propriedade (metadados) armazenados neste Image. |
| RawFormat |
Obtém o formato de ficheiro deste Image. |
| Size |
Obtém a largura e altura, em píxeis, desta imagem. |
| Tag |
Obtém ou define um objeto que fornece dados adicionais sobre a imagem. |
| VerticalResolution |
Obtém a resolução vertical, em píxeis por polegada, deste Image. |
| Width |
Obtém a largura, em pixels, deste Image. |
Métodos
| Name | Description |
|---|---|
| Clone() |
Cria uma cópia exata deste Image. |
| CreateObjRef(Type) |
Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto. (Herdado de MarshalByRefObject) |
| Dispose() |
Liberta todos os recursos utilizados por este Image. |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo Image e opcionalmente liberta os recursos geridos. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| Finalize() |
Permite que um objeto tente libertar recursos e realizar outras operações de limpeza antes de ser recuperado pela recolha de lixo. |
| FromFile(String, Boolean) |
Cria um Image a partir do ficheiro especificado usando informação de gestão de cor incorporada nesse ficheiro. |
| FromFile(String) |
Cria um Image a partir do ficheiro especificado. |
| FromHbitmap(IntPtr, IntPtr) |
Cria um Bitmap de um handle para um bitmap GDI e um handle para uma paleta GDI. |
| FromHbitmap(IntPtr) |
Cria um Bitmap de um handle para um bitmap GDI. |
| FromStream(Stream, Boolean, Boolean) |
Cria um Image a partir do fluxo de dados especificado, opcionalmente usando informação de gestão de cor embutida e validando os dados da imagem. |
| FromStream(Stream, Boolean) |
Cria um Image a partir do fluxo de dados especificado, usando opcionalmente informação de gestão de cor incorporada nesse fluxo. |
| FromStream(Stream) |
Cria um Image a partir do fluxo de dados especificado. |
| GetBounds(GraphicsUnit) |
Obtém os limites da imagem na unidade especificada. |
| GetEncoderParameterList(Guid) |
Devolve informação sobre os parâmetros suportados pelo codificador de imagem especificado. |
| GetFrameCount(FrameDimension) |
Devolve o número de frames da dimensão especificada. |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso. (Herdado de MarshalByRefObject) |
| GetPixelFormatSize(PixelFormat) |
Devolve a profundidade de cor, em número de bits por píxel, do formato de píxel especificado. |
| GetPropertyItem(Int32) |
Obtém o item de propriedade especificado a partir deste Image. |
| GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr) |
Devolve uma miniatura para isto Image. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| IsAlphaPixelFormat(PixelFormat) |
Devolve um valor que indica se o formato de píxeis para este Image contém informação alfa. |
| IsCanonicalPixelFormat(PixelFormat) |
Devolve um valor que indica se o formato de píxel é de 32 bits por píxel. |
| IsExtendedPixelFormat(PixelFormat) |
Devolve um valor que indica se o formato de píxel é de 64 bits por píxel. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| RemovePropertyItem(Int32) |
Remove o item de propriedade especificado deste Image. |
| RotateFlip(RotateFlipType) |
Roda, vira ou roda e vira o Image. |
| Save(Stream, ImageCodecInfo, EncoderParameters) |
Guarda esta imagem no fluxo especificado, com os parâmetros do codificador e do codificador de imagem especificados. |
| Save(Stream, ImageFormat) |
Guarda esta imagem no fluxo especificado no formato especificado. |
| Save(String, ImageCodecInfo, EncoderParameters) |
Guarda isto Image no ficheiro especificado, com os parâmetros especificados do codificador e do codificador de imagem. |
| Save(String, ImageFormat) |
Guarda isto Image no ficheiro especificado no formato especificado. |
| Save(String) |
Guarda isto Image no ficheiro ou stream especificado. |
| SaveAdd(EncoderParameters) |
Adiciona um frame ao ficheiro ou stream especificado numa chamada anterior ao Save método. Use este método para guardar fotogramas selecionados de uma imagem de múltiplos quadros para outra imagem de múltiplos quadros. |
| SaveAdd(Image, EncoderParameters) |
Adiciona um frame ao ficheiro ou stream especificado numa chamada anterior ao Save método. |
| SelectActiveFrame(FrameDimension, Int32) |
Seleciona o referencial especificado pela dimensão e índice. |
| SetPropertyItem(PropertyItem) |
Armazena um item de propriedade (metadado) neste Image. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| ISerializable.GetObjectData(SerializationInfo, StreamingContext) |
Preenche a SerializationInfo com os dados necessários para serializar o objeto alvo. |