Image Image Image Image Class

Definition

Eine abstrakte Basisklasse, die Funktionen für die von Bitmap und Metafile abgeleiteten Klassen bereitstellt.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
Vererbung
Abgeleitet
Attribute
Implementiert

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert.The following code example is designed for use with Windows Forms. Es handelt sich um einen Handler Paint für das-Ereignis.It is a handler for the Paint event. Ein Graphics -Objekt wird an das-Ereignis weitergegeben und wird zum Zeichnen des Bilds auf dem Formular verwendet.A Graphics object is passed to the event and is used to draw the image on the form. Der Code führt die folgenden Aktionen aus:The code performs the following actions:

  • Erstellt ein Bild aus einer Datei mit dem Namen SampImag. jpg.Creates an image from a file named SampImag.jpg. Diese Datei muss sich im gleichen Ordner befinden wie die ausführbare Datei der Anwendung.This file must be located in the same folder as the application executable file.

  • Erstellt einen Punkt, an dem die obere linke Ecke des Bilds gezeichnet werden soll.Creates a point at which to draw the upper-left corner of the image.

  • Zeichnet das nicht skalierte Bild im Formular.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

Hinweise

Verwenden Sie eine Image DrawImage der-Methoden, um einen in einem Windows Form zu zeichnen.To draw an Image on a Windows Form, you should use one of the DrawImage methods.

Eigenschaften

Flags Flags Flags Flags

Ruft Attributflags für die Pixeldaten dieses Image ab.Gets attribute flags for the pixel data of this Image.

FrameDimensionsList FrameDimensionsList FrameDimensionsList FrameDimensionsList

Ruft ein Array von GUIDs ab, die die Abmessungen der Rahmen in diesem Image darstellen.Gets an array of GUIDs that represent the dimensions of frames within this Image.

Height Height Height Height

Ruft die Höhe dieses Image in Pixel ab.Gets the height, in pixels, of this Image.

HorizontalResolution HorizontalResolution HorizontalResolution HorizontalResolution

Ruft die horizontale Auflösung dieses Image in Pixel pro Zoll ab.Gets the horizontal resolution, in pixels per inch, of this Image.

Palette Palette Palette Palette

Ruft die für dieses Image verwendete Farbpalette ab oder legt diese fest.Gets or sets the color palette used for this Image.

PhysicalDimension PhysicalDimension PhysicalDimension PhysicalDimension

Ruft die Breite und Höhe dieses Bilds ab.Gets the width and height of this image.

PixelFormat PixelFormat PixelFormat PixelFormat

Ruft das Pixelformat für dieses Image ab.Gets the pixel format for this Image.

PropertyIdList PropertyIdList PropertyIdList PropertyIdList

Ruft IDs für die in diesem Image gespeicherten Eigenschaftenelemente ab.Gets IDs of the property items stored in this Image.

PropertyItems PropertyItems PropertyItems PropertyItems

Ruft alle in diesem Image gespeicherten Eigenschaftenelemente (Metadaten) ab.Gets all the property items (pieces of metadata) stored in this Image.

RawFormat RawFormat RawFormat RawFormat

Ruft das Dateiformat dieses Image ab.Gets the file format of this Image.

Size Size Size Size

Ruft die Breite und Höhe dieses Bilds in Pixel ab.Gets the width and height, in pixels, of this image.

Tag Tag Tag Tag

Ruft ein Objekt ab, das zusätzliche Daten zu dem Bild bereitstellt, oder legt dieses Objekt fest.Gets or sets an object that provides additional data about the image.

VerticalResolution VerticalResolution VerticalResolution VerticalResolution

Ruft die vertikale Auflösung dieses Image in Pixel pro Zoll ab.Gets the vertical resolution, in pixels per inch, of this Image.

Width Width Width Width

Ruft die Breite dieses Image in Pixel ab.Gets the width, in pixels, of this Image.

Methoden

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

Erstellt eine genaue Kopie von dieser Image.Creates an exact copy of this Image.

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

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.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()

Gibt alle von dieser Image verwendeten Ressourcen frei.Releases all resources used by this Image.

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

Gibt die von Image verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Image and optionally releases the managed resources.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.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)

Erstellt ein Image aus der angegebenen Datei.Creates an Image from the specified file.

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

Erstellt ein Image aus der angegebenen Datei unter Verwendung der in der Datei eingebetteten Farbverwaltungsinformationen.Creates an Image from the specified file using embedded color management information in that file.

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

Erstellt eine Bitmap aus einem Handle für eine GDI-Bitmap.Creates a Bitmap from a handle to a GDI bitmap.

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

Erstellt eine Bitmap aus einem Handle für eine GDI-Bitmap und einem Handle für eine GDI-Palette.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)

Erstellt eine Image aus dem angegebenen Datenstream.Creates an Image from the specified data stream.

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

Erstellt ein Image aus dem angegebenen Datenstream unter optionaler Verwendung der im Stream eingebetteten Farbverwaltungsinformationen.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)

Erstellt ein Image aus dem angegebenen Datenstream. Optional werden dabei eingebettete Farbverwaltungsinformationen verwendet und die Bilddaten überprüft.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)

Ruft die Grenzen des Bilds in der angegebenen Einheit ab.Gets the bounds of the image in the specified unit.

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

Gibt Informationen über die Parameter zurück, die vom angegebenen Bildencoder unterstützt werden.Returns information about the parameters supported by the specified image encoder.

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

Gibt die Anzahl der Rahmen in der angegebenen Abmessung zurück.Returns the number of frames of the specified dimension.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.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)

Gibt die Farbtiefe des angegebenen Pixelformats in der Anzahl der Bits pro Pixel zurück.Returns the color depth, in number of bits per pixel, of the specified pixel format.

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

Ruft das angegebene Eigenschaftenelement aus diesem Image ab.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)

Gibt eine Miniaturansicht für dieses Image zurück.Returns a thumbnail for this Image.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Gibt einen Wert zurück, der angibt, ob das Pixelformat für dieses Image Alphainformationen enthält.Returns a value that indicates whether the pixel format for this Image contains alpha information.

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

Gibt einen Wert zurück, der angibt, ob das Pixelformat 32 Bits pro Pixel beträgt.Returns a value that indicates whether the pixel format is 32 bits per pixel.

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

Gibt einen Wert zurück, der angibt, ob das Pixelformat 64 Bits pro Pixel beträgt.Returns a value that indicates whether the pixel format is 64 bits per pixel.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

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

Entfernt das angegebene Eigenschaftenelement aus diesem Image.Removes the specified property item from this Image.

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

Dreht und/oder kippt das 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)

Speichert dieses Bild mit den angegebenen Encoder- und Bildencoderparametern im angegebenen Stream.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)

Speichert dieses Bild im angegebenen Format im angegebenen Stream.Saves this image to the specified stream in the specified format.

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

Speichert dieses Image in der angegebenen Datei oder dem Stream.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)

Speichert dieses Image mit den angegebenen Encoder- und Bildencoderparametern in der angegebenen Datei.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)

Speichert dieses Image im angegebenen Format in der angegebenen Datei.Saves this Image to the specified file in the specified format.

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

Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu.Adds a frame to the file or stream specified in a previous call to the Save method. Mit dieser Methode speichern Sie ausgewählte Rahmen eines Bilds mit mehreren Rahmen in einem anderen Bild mit mehreren Rahmen.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)

Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu.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)

Wählt den durch die angegebene Abmessung und den Index angegebenen Rahmen aus.Selects the frame specified by the dimension and index.

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

Speichert ein Eigenschaftenelement (Metadaten) in diesem Image.Stores a property item (piece of metadata) in this Image.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.Populates a SerializationInfo with the data needed to serialize the target object.

Gilt für:

Siehe auch