Image Image Image Image Class

Definición

Clase base abstracta que proporciona funcionalidad para las clases descendentes Bitmap y 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)]
[Serializable]
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
Herencia
Derivado
Atributos
Implementaciones

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms.The following code example is designed for use with Windows Forms. Es un controlador para el Paint eventos.It is a handler for the Paint event. Un Graphics objeto se pasa al evento y se usa para dibujar la imagen en el formulario.A Graphics object is passed to the event and is used to draw the image on the form. El código realiza las siguientes acciones:The code performs the following actions:

  • Crea una imagen desde un archivo denominado SampImag.jpg.Creates an image from a file named SampImag.jpg. Este archivo debe encontrarse en la misma carpeta que el archivo ejecutable de aplicación.This file must be located in the same folder as the application executable file.

  • Crea un punto en el que se va a dibujar la esquina superior izquierda de la imagen.Creates a point at which to draw the upper-left corner of the image.

  • Dibuja la imagen sin ajustar a escala en el formulario.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

Comentarios

Para dibujar un Image en un formulario de Windows, debe usar uno de los DrawImage métodos.To draw an Image on a Windows Form, you should use one of the DrawImage methods.

Propiedades

Flags Flags Flags Flags

Obtiene marcadores de atributo para los datos de píxel de Image. Gets attribute flags for the pixel data of this Image.

FrameDimensionsList FrameDimensionsList FrameDimensionsList FrameDimensionsList

Obtiene una matriz de GUID que representa las dimensiones de los marcos dentro de Image. Gets an array of GUIDs that represent the dimensions of frames within this Image.

Height Height Height Height

Obtiene el alto en píxeles de Image. Gets the height, in pixels, of this Image.

HorizontalResolution HorizontalResolution HorizontalResolution HorizontalResolution

Obtiene la resolución horizontal, en píxeles por pulgada, de Image. Gets the horizontal resolution, in pixels per inch, of this Image.

Palette Palette Palette Palette

Obtiene o establece la paleta de colores utilizada para Image. Gets or sets the color palette used for this Image.

PhysicalDimension PhysicalDimension PhysicalDimension PhysicalDimension

Obtiene el ancho y el alto de esta imagen. Gets the width and height of this image.

PixelFormat PixelFormat PixelFormat PixelFormat

Obtiene el formato de píxel de Image. Gets the pixel format for this Image.

PropertyIdList PropertyIdList PropertyIdList PropertyIdList

Obtiene los identificadores de los elementos de propiedad almacenados en Image. Gets IDs of the property items stored in this Image.

PropertyItems PropertyItems PropertyItems PropertyItems

Obtiene todos los elementos de propiedad (fragmentos de metadatos) almacenados en Image. Gets all the property items (pieces of metadata) stored in this Image.

RawFormat RawFormat RawFormat RawFormat

Obtiene el formato de archivo de este Image. Gets the file format of this Image.

Size Size Size Size

Obtiene el ancho y el alto de esta imagen, expresado en píxeles. Gets the width and height, in pixels, of this image.

Tag Tag Tag Tag

Obtiene o establece un objeto que proporciona datos adicionales sobre la imagen. Gets or sets an object that provides additional data about the image.

VerticalResolution VerticalResolution VerticalResolution VerticalResolution

Obtiene la resolución vertical, en píxeles por pulgada, de Image. Gets the vertical resolution, in pixels per inch, of this Image.

Width Width Width Width

Obtiene el ancho en píxeles de Image. Gets the width, in pixels, of this Image.

Métodos

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

Crea una copia exacta de este objeto Image. Creates an exact copy of this Image.

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

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto 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()

Libera todos los recursos utilizados por este Image. Releases all resources used by this Image.

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

Libera los recursos no administrados que usa Image y, de forma opcional, libera los recursos administrados. Releases the unmanaged resources used by the Image and optionally releases the managed resources.

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

Determina si el objeto especificado es igual al objeto actual. Determines whether the specified object is equal to the current object.

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

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados. 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 Image a partir del archivo especificado. Creates an Image from the specified file.

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

Crea Image a partir del archivo especificado utilizando información de administración del color incrustada en dicho archivo. 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 Bitmap a partir de un identificador de un mapa de bits de la 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 Bitmap a partir de un identificador de un mapa de bits de la GDI y un identificador de una paleta de la 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 Image a partir del flujo de datos especificado. Creates an Image from the specified data stream.

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

Crea un Image a partir del flujo de datos especificado, utilizando opcionalmente información de administración del color incrustada en dicho flujo. 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 Image a partir del flujo de datos especificado, utilizando opcionalmente la información de administración del color incrustada y validando los datos de la imagen. 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)

Obtiene los límites de la imagen en la unidad especificada. Gets the bounds of the image in the specified unit.

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

Devuelve información sobre los parámetros que admite el codificador de imágenes especificado. Returns information about the parameters supported by the specified image encoder.

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

Devuelve el número de marcos de la dimensión especificada. Returns the number of frames of the specified dimension.

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

Sirve como la función hash predeterminada. Serves as the default hash function.

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

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. 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)

Devuelve la profundidad de color, en número de bits por píxel, del formato de píxel especificado. Returns the color depth, in number of bits per pixel, of the specified pixel format.

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

Obtiene el elemento de propiedad especificado de 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)

Devuelve una miniatura de Image. Returns a thumbnail for this Image.

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

Obtiene el Type de la instancia actual. Gets the Type of the current instance.

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

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. Obtains a lifetime service object to control the lifetime policy for this instance.

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

Devuelve un valor que indica si el formato de píxel de Image contiene información alfa. Returns a value that indicates whether the pixel format for this Image contains alpha information.

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

Devuelve un valor que indica si el formato de píxel es 32 bits por píxel. Returns a value that indicates whether the pixel format is 32 bits per pixel.

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

Devuelve un valor que indica si el formato de píxel es 64 bits por píxel. Returns a value that indicates whether the pixel format is 64 bits per pixel.

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

Crea una copia superficial del Object actual. Creates a shallow copy of the current Object.

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

Crea una copia superficial del objeto MarshalByRefObject actual. Creates a shallow copy of the current MarshalByRefObject object.

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

Quita el elemento de propiedad especificado de Image. Removes the specified property item from this Image.

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

Gira, voltea o gira y voltea el 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)

Guarda esta imagen en la secuencia especificada, con el codificador y los parámetros de codificador de imagen especificados. 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)

Guarda esta imagen en la secuencia especificada con el formato especificado. Saves this image to the specified stream in the specified format.

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

Guarda Image en la secuencia o archivo especificado. 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)

Guarda Image en el archivo especificado, con el codificador y los parámetros de codificador de imagen especificados. 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)

Guarda Image en el archivo especificado con el formato especificado. Saves this Image to the specified file in the specified format.

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

Agrega un marco al archivo o la secuencia especificados en una llamada anterior al método Save. Adds a frame to the file or stream specified in a previous call to the Save method. Utilice este método para guardar los marcos seleccionados de una imagen de varios marcos en otra imagen de varios marcos. 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)

Agrega un marco al archivo o la secuencia especificados en una llamada anterior al método 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)

Selecciona el marco que especifican la dimensión y el índice. Selects the frame specified by the dimension and index.

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

Almacena un elemento de propiedad (fragmento de metadatos) en Image. Stores a property item (piece of metadata) in this Image.

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

Devuelve una cadena que representa el objeto actual. Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

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

Llena SerializationInfo con los datos necesarios para serializar el objeto de destino. Populates a SerializationInfo with the data needed to serialize the target object.

Se aplica a

Consultar también