Image Image Image Image Class

Definizione

Classe base astratta che fornisce funzionalità per le classi derivate Bitmap e Metafile.An abstract base class that provides functionality for the Bitmap and Metafile descended classes.

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]
[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
type Image = class
    inherit MarshalByRefObject
    interface ISerializable
    interface ICloneable
    interface IDisposable
Public MustInherit Class Image
Inherits MarshalByRefObject
Implements ICloneable, IDisposable, ISerializable
Ereditarietà
Derivato
Attributi
Implementazioni

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms.The following code example is designed for use with Windows Forms. Si tratta di un gestore per Paint l'evento.It is a handler for the Paint event. Un Graphics oggetto viene passato all'evento e viene usato per creare l'immagine nel form.A Graphics object is passed to the event and is used to draw the image on the form. Nel codice vengono eseguite le seguenti azioni:The code performs the following actions:

  • Crea un'immagine da un file denominato SampImag. jpg.Creates an image from a file named SampImag.jpg. Questo file deve trovarsi nella stessa cartella del file eseguibile dell'applicazione.This file must be located in the same folder as the application executable file.

  • Crea un punto in corrispondenza del quale viene disegnato l'angolo superiore sinistro dell'immagine.Creates a point at which to draw the upper-left corner of the image.

  • Disegna l'immagine non ridimensionata nel form.Draws the unscaled image on the form.

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

Commenti

Per creare un Image oggetto in un Windows Form, è necessario usare uno DrawImage dei metodi.To draw an Image on a Windows Form, you should use one of the DrawImage methods.

Proprietà

Flags Flags Flags Flags

Ottiene i flag di attributi per i dati pixel di questo oggetto Image.Gets attribute flags for the pixel data of this Image.

FrameDimensionsList FrameDimensionsList FrameDimensionsList FrameDimensionsList

Ottiene una matrice di GUID che rappresentano le dimensioni dei fotogrammi all'interno di questo oggetto Image.Gets an array of GUIDs that represent the dimensions of frames within this Image.

Height Height Height Height

Ottiene l'altezza in pixel di questo oggetto Image.Gets the height, in pixels, of this Image.

HorizontalResolution HorizontalResolution HorizontalResolution HorizontalResolution

Ottiene la risoluzione orizzontale in pixel per pollice di questo oggetto Image.Gets the horizontal resolution, in pixels per inch, of this Image.

Palette Palette Palette Palette

Ottiene o imposta la tavolozza dei colori usata per questo oggetto Image.Gets or sets the color palette used for this Image.

PhysicalDimension PhysicalDimension PhysicalDimension PhysicalDimension

Ottiene la larghezza e l'altezza di questa immagine.Gets the width and height of this image.

PixelFormat PixelFormat PixelFormat PixelFormat

Ottiene il formato pixel per questo oggetto Image.Gets the pixel format for this Image.

PropertyIdList PropertyIdList PropertyIdList PropertyIdList

Ottiene gli ID degli elementi di proprietà archiviati in questo oggetto Image.Gets IDs of the property items stored in this Image.

PropertyItems PropertyItems PropertyItems PropertyItems

Ottiene tutti gli elementi di proprietà (porzioni di metadati) archiviati in questo oggetto Image.Gets all the property items (pieces of metadata) stored in this Image.

RawFormat RawFormat RawFormat RawFormat

Ottiene il formato di file dell'oggetto Image.Gets the file format of this Image.

Size Size Size Size

Ottiene la larghezza e l'altezza di questa immagine in pixel.Gets the width and height, in pixels, of this image.

Tag Tag Tag Tag

Ottiene o imposta un oggetto che fornisce dati aggiuntivi relativi all'immagine.Gets or sets an object that provides additional data about the image.

VerticalResolution VerticalResolution VerticalResolution VerticalResolution

Ottiene la risoluzione verticale in pixel per pollice di questo oggetto Image.Gets the vertical resolution, in pixels per inch, of this Image.

Width Width Width Width

Ottiene la larghezza in pixel di questo oggetto Image.Gets the width, in pixels, of this Image.

Metodi

Clone() Clone() Clone() Clone()

Crea una copia esatta di questo Image.Creates an exact copy of this Image.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Rilascia tutte le risorse usate da questa classe Image.Releases all resources used by this Image.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Rilascia le risorse non gestite usate da Image e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

FromFile(String) FromFile(String) FromFile(String) FromFile(String)

Crea un oggetto Image dal file specificato.Creates an Image from the specified file.

FromFile(String, Boolean) FromFile(String, Boolean) FromFile(String, Boolean) FromFile(String, Boolean)

Crea un oggetto Image dal file specificato, usando le informazioni relative alla gestione colori incorporate nel file.Creates an Image from the specified file using embedded color management information in that file.

FromHbitmap(IntPtr) FromHbitmap(IntPtr) FromHbitmap(IntPtr) FromHbitmap(IntPtr)

Crea un oggetto Bitmap da un handle per una bitmap GDI.Creates a Bitmap from a handle to a GDI bitmap.

FromHbitmap(IntPtr, IntPtr) FromHbitmap(IntPtr, IntPtr) FromHbitmap(IntPtr, IntPtr) FromHbitmap(IntPtr, IntPtr)

Crea un oggetto Bitmap da un handle per una bitmap GDI e da un handle per una tavolozza GDI.Creates a Bitmap from a handle to a GDI bitmap and a handle to a GDI palette.

FromStream(Stream) FromStream(Stream) FromStream(Stream) FromStream(Stream)

Crea un oggetto Image dal flusso di dati specificato.Creates an Image from the specified data stream.

FromStream(Stream, Boolean) FromStream(Stream, Boolean) FromStream(Stream, Boolean) FromStream(Stream, Boolean)

Crea un oggetto Image dal flusso di dati specificato, usando se necessario le informazioni relative alla gestione colori incorporate nel flusso.Creates an Image from the specified data stream, optionally using embedded color management information in that stream.

FromStream(Stream, Boolean, Boolean) FromStream(Stream, Boolean, Boolean) FromStream(Stream, Boolean, Boolean) FromStream(Stream, Boolean, Boolean)

Crea un oggetto Image dal flusso di dati specificato, usando se necessario le informazioni relative alla gestione colori incorporate e convalidando i dati dell'immagine.Creates an Image from the specified data stream, optionally using embedded color management information and validating the image data.

GetBounds(GraphicsUnit) GetBounds(GraphicsUnit) GetBounds(GraphicsUnit) GetBounds(GraphicsUnit)

Ottiene i limiti dell'immagine nell'unità di misura specificata.Gets the bounds of the image in the specified unit.

GetEncoderParameterList(Guid) GetEncoderParameterList(Guid) GetEncoderParameterList(Guid) GetEncoderParameterList(Guid)

Restituisce informazioni sui parametri supportati dal codificatore di immagini specificato.Returns information about the parameters supported by the specified image encoder.

GetFrameCount(FrameDimension) GetFrameCount(FrameDimension) GetFrameCount(FrameDimension) GetFrameCount(FrameDimension)

Restituisce il numero dei fotogrammi della dimensione specificata.Returns the number of frames of the specified dimension.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetPixelFormatSize(PixelFormat) GetPixelFormatSize(PixelFormat) GetPixelFormatSize(PixelFormat) GetPixelFormatSize(PixelFormat)

Restituisce la profondità di colore, il numero di bit per pixel, del formato pixel specificato.Returns the color depth, in number of bits per pixel, of the specified pixel format.

GetPropertyItem(Int32) GetPropertyItem(Int32) GetPropertyItem(Int32) GetPropertyItem(Int32)

Ottiene l'elemento di proprietà specificato da questo oggetto Image.Gets the specified property item from this Image.

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

Restituisce un'anteprima di questo oggetto Image.Returns a thumbnail for this Image.

GetType() GetType() GetType() GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsAlphaPixelFormat(PixelFormat) IsAlphaPixelFormat(PixelFormat) IsAlphaPixelFormat(PixelFormat) IsAlphaPixelFormat(PixelFormat)

Restituisce un valore che indica se il formato pixel di questo oggetto Image contiene informazioni alfa.Returns a value that indicates whether the pixel format for this Image contains alpha information.

IsCanonicalPixelFormat(PixelFormat) IsCanonicalPixelFormat(PixelFormat) IsCanonicalPixelFormat(PixelFormat) IsCanonicalPixelFormat(PixelFormat)

Restituisce un valore che indica se il formato pixel è di 32 bit per pixel.Returns a value that indicates whether the pixel format is 32 bits per pixel.

IsExtendedPixelFormat(PixelFormat) IsExtendedPixelFormat(PixelFormat) IsExtendedPixelFormat(PixelFormat) IsExtendedPixelFormat(PixelFormat)

Restituisce un valore che indica se il formato pixel è di 64 bit per pixel.Returns a value that indicates whether the pixel format is 64 bits per pixel.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
RemovePropertyItem(Int32) RemovePropertyItem(Int32) RemovePropertyItem(Int32) RemovePropertyItem(Int32)

Rimuove da questo oggetto Image l'elemento di proprietà specificato.Removes the specified property item from this Image.

RotateFlip(RotateFlipType) RotateFlip(RotateFlipType) RotateFlip(RotateFlipType) RotateFlip(RotateFlipType)

Ruota, capovolge o ruota e capovolge Image.Rotates, flips, or rotates and flips the Image.

Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters) Save(Stream, ImageCodecInfo, EncoderParameters)

Salva questa immagine nel flusso specificato, con i parametri di codificatore specificato e codificatore di immagini.Saves this image to the specified stream, with the specified encoder and image encoder parameters.

Save(Stream, ImageFormat) Save(Stream, ImageFormat) Save(Stream, ImageFormat) Save(Stream, ImageFormat)

Salva questa immagine nel flusso e nel formato specificati.Saves this image to the specified stream in the specified format.

Save(String) Save(String) Save(String) Save(String)

Salva questo oggetto Image nel file o flusso specificato.Saves this Image to the specified file or stream.

Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters) Save(String, ImageCodecInfo, EncoderParameters)

Salva l'immagine Image nel file specificato, con i parametri di codificatore specificato e di codificatore di immagini.Saves this Image to the specified file, with the specified encoder and image-encoder parameters.

Save(String, ImageFormat) Save(String, ImageFormat) Save(String, ImageFormat) Save(String, ImageFormat)

Salva questo oggetto Image nel file e nel formato specificati.Saves this Image to the specified file in the specified format.

SaveAdd(EncoderParameters) SaveAdd(EncoderParameters) SaveAdd(EncoderParameters) SaveAdd(EncoderParameters)

Aggiunge un fotogramma al file o al flusso specificato in una precedente chiamata al metodo Save.Adds a frame to the file or stream specified in a previous call to the Save method. Usare questo metodo per salvare i fotogrammi selezionati da un'immagine a più fotogrammi in un'altra immagine a più fotogrammi.Use this method to save selected frames from a multiple-frame image to another multiple-frame image.

SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters) SaveAdd(Image, EncoderParameters)

Aggiunge un fotogramma al file o al flusso specificato in una precedente chiamata al metodo Save.Adds a frame to the file or stream specified in a previous call to the Save method.

SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32) SelectActiveFrame(FrameDimension, Int32)

Seleziona il fotogramma specificato in base alla dimensione e all'indice.Selects the frame specified by the dimension and index.

SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem) SetPropertyItem(PropertyItem)

Archivia un elemento di proprietà (porzione di metadati) in questo oggetto Image.Stores a property item (piece of metadata) in this Image.

ToString() ToString() ToString() ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.Populates a SerializationInfo with the data needed to serialize the target object.

Si applica a

Vedi anche