Metafile Klasse

Definition

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Metafile.cs

Definiert eine grafische Metadatei. Eine Metadatei enthält Datensätze, die eine Folge von Grafikoperationen beschreiben, die aufgezeichnet (erstellt) und wiedergegeben (angezeigt) werden können. Diese Klasse kann nicht geerbt werden.

public ref class Metafile sealed : System::Drawing::Image

[System.Serializable]
public sealed class Metafile : System.Drawing.Image

[<System.Serializable>]
type Metafile = class
    inherit Image

Public NotInheritable Class Metafile
Inherits Image

Vererbung

Object

MarshalByRefObject

Image

Metafile

Attribute

SerializableAttribute

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine Metafile erstellen und die PlayRecord -Methode verwenden.

using System;
using System.Drawing;
using System.Drawing.Imaging;
using System.Windows.Forms;

// for Marshal.Copy
using System.Runtime.InteropServices; 

public class Form1 : Form
{
    private Metafile metafile1;
    private Graphics.EnumerateMetafileProc metafileDelegate;
    private Point destPoint;
    public Form1()
    {
        metafile1 = new Metafile(@"C:\Test.wmf");
        metafileDelegate = new Graphics.EnumerateMetafileProc(MetafileCallback);
        destPoint = new Point(20, 10);
    }
    protected override void OnPaint(PaintEventArgs e)
    {
        e.Graphics.EnumerateMetafile(metafile1, destPoint, metafileDelegate);
    }
    private bool MetafileCallback(
       EmfPlusRecordType recordType,
       int flags,
       int dataSize,
       IntPtr data,
       PlayRecordCallback callbackData)
    {
        byte[] dataArray = null;
        if (data != IntPtr.Zero)
        {
            // Copy the unmanaged record to a managed byte buffer 
            // that can be used by PlayRecord.
            dataArray = new byte[dataSize];
            Marshal.Copy(data, dataArray, 0, dataSize);
        }

        metafile1.PlayRecord(recordType, flags, dataSize, dataArray);

        return true;
    }

    static void Main()
    {
        Application.Run(new Form1());
    }
}

Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.Windows.Forms
' for Marshal.Copy
Imports System.Runtime.InteropServices


Public Class Form1
    Inherits Form
    Private metafile1 As Metafile
    Private metafileDelegate As Graphics.EnumerateMetafileProc
    Private destPoint As Point
    
    Public Sub New() 
        metafile1 = New Metafile("C:\test.wmf")
        metafileDelegate = New Graphics.EnumerateMetafileProc(AddressOf MetafileCallback)
        destPoint = New Point(20, 10)
    
    End Sub
    
    Protected Overrides Sub OnPaint(ByVal e As PaintEventArgs) 
        e.Graphics.EnumerateMetafile(metafile1, destPoint, metafileDelegate)
    
    End Sub
    
    Private Function MetafileCallback(ByVal recordType As _
        EmfPlusRecordType, ByVal flags As Integer, ByVal dataSize As Integer, _
        ByVal data As IntPtr, ByVal callbackData As PlayRecordCallback) As Boolean

        Dim dataArray As Byte() = Nothing
        If data <> IntPtr.Zero Then

            ' Copy the unmanaged record to a managed byte buffer 
            ' that can be used by PlayRecord.
            dataArray = New Byte(dataSize) {}
            Marshal.Copy(data, dataArray, 0, dataSize)
        End If

        metafile1.PlayRecord(recordType, flags, dataSize, dataArray)
        Return True

    End Function
    
    Shared Sub Main() 
        Application.Run(New Form1())
    End Sub

End Class

Hinweise

Wenn Sie die Save -Methode verwenden, um ein Grafikbild als WMF-Datei (Windows Metafile Format) oder EMF-Datei (Enhanced Metafile Format) zu speichern, wird die resultierende Datei stattdessen als PNG-Datei (Portable Network Graphics) gespeichert. Dieses Verhalten tritt auf, weil die GDI+-Komponente des .NET Framework über keinen Encoder verfügt, den Sie zum Speichern von Dateien als WMF- oder .emf-Dateien verwenden können.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

Metafile(IntPtr, Boolean)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Handle.
Metafile(IntPtr, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Handle für einen Gerätekontext und eine neue Instanz einer EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(IntPtr, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Handle für einen Gerätekontext und eine neue Instanz einer EmfType-Enumeration, die das Format der Metafile angibt. Eine Zeichenfolge kann zum Benennen der Datei bereitgestellt werden.
Metafile(IntPtr, Rectangle)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck umschlossen wird.
Metafile(IntPtr, Rectangle, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird.
Metafile(IntPtr, Rectangle, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird, und eine neue Instanz der EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(IntPtr, Rectangle, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird, und eine neue Instanz der EmfType-Enumeration, die das Format der Metafile angibt. Eine Zeichenfolge kann zum Benennen der Datei bereitgestellt werden.
Metafile(IntPtr, RectangleF)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck umschlossen wird.
Metafile(IntPtr, RectangleF, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird.
Metafile(IntPtr, RectangleF, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird, und eine neue Instanz der EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(IntPtr, RectangleF, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Gerätekontext, die vom angegebenen Rechteck unter Verwendung der bereitgestellten Maßeinheit umschlossen wird, und eine neue Instanz der EmfType-Enumeration, die das Format der Metafile angibt. Eine Zeichenfolge kann zum Benennen der Datei bereitgestellt werden.
Metafile(IntPtr, WmfPlaceableFileHeader)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Handle und eine neue Instanz von WmfPlaceableFileHeader.
Metafile(IntPtr, WmfPlaceableFileHeader, Boolean)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Handle und eine neue Instanz von WmfPlaceableFileHeader. Zudem kann mit dem deleteWmf-Parameter das Handle gelöscht werden, wenn die Metadatei gelöscht wird.
Metafile(Stream)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Stream.
Metafile(Stream, IntPtr)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Stream.
Metafile(Stream, IntPtr, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(Stream, IntPtr, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext und eine EmfType-Enumeration, die das Format der Metafile angibt. Zudem kann eine Zeichenfolge hinzugefügt werden, die einen beschreibenden Namen für die neue Metafile enthält.
Metafile(Stream, IntPtr, Rectangle)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext und eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt.
Metafile(Stream, IntPtr, Rectangle, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit.
Metafile(Stream, IntPtr, Rectangle, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(Stream, IntPtr, Rectangle, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt. Außerdem kann eine Zeichenfolge hinzugefügt werden, die einen beschreibenden Namen für die neue Metafile enthält.
Metafile(Stream, IntPtr, RectangleF)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext und eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt.
Metafile(Stream, IntPtr, RectangleF, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit.
Metafile(Stream, IntPtr, RectangleF, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(Stream, IntPtr, RectangleF, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Datenstream, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt. Außerdem kann eine Zeichenfolge hinzugefügt werden, die einen beschreibenden Namen für die neue Metafile enthält.
Metafile(String)	Initialisiert eine neue Instanz der Metafile-Klasse aus dem angegebenen Dateinamen.
Metafile(String, IntPtr)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen.
Metafile(String, IntPtr, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(String, IntPtr, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext und eine EmfType-Enumeration, die das Format der Metafile angibt. Außerdem kann eine beschreibende Zeichenfolge hinzugefügt werden.
Metafile(String, IntPtr, Rectangle)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext und eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt.
Metafile(String, IntPtr, Rectangle, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit.
Metafile(String, IntPtr, Rectangle, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(String, IntPtr, Rectangle, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt. Eine beschreibende Zeichenfolge kann ebenfalls hinzugefügt werden.
Metafile(String, IntPtr, Rectangle, MetafileFrameUnit, String)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine Rectangle-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit. Eine beschreibende Zeichenfolge kann ebenfalls hinzugefügt werden.
Metafile(String, IntPtr, RectangleF)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext und eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt.
Metafile(String, IntPtr, RectangleF, MetafileFrameUnit)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit.
Metafile(String, IntPtr, RectangleF, MetafileFrameUnit, EmfType)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt.
Metafile(String, IntPtr, RectangleF, MetafileFrameUnit, EmfType, String)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, die bereitgestellte Maßeinheit und eine EmfType-Enumeration, die das Format der Metafile angibt. Eine beschreibende Zeichenfolge kann ebenfalls hinzugefügt werden.
Metafile(String, IntPtr, RectangleF, MetafileFrameUnit, String)	Initialisiert eine neue Instanz der Metafile-Klasse mit dem angegebenen Dateinamen, ein Windows-Handle für einen Gerätekontext, eine RectangleF-Struktur, die das Rechteck darstellt, das die neue Metafile umschließt, und die bereitgestellte Maßeinheit. Eine beschreibende Zeichenfolge kann ebenfalls hinzugefügt werden.

Eigenschaften

Flags	Ruft Attributflags für die Pixeldaten dieses Image ab. (Geerbt von Image)
FrameDimensionsList	Ruft ein Array von GUIDs ab, die die Abmessungen der Rahmen in diesem Image darstellen. (Geerbt von Image)
Height	Ruft die Höhe dieses Image in Pixel ab. (Geerbt von Image)
HorizontalResolution	Ruft die horizontale Auflösung dieses Image in Pixel pro Zoll ab. (Geerbt von Image)
Palette	Ruft die für dieses Image verwendete Farbpalette ab oder legt diese fest. (Geerbt von Image)
PhysicalDimension	Ruft die Breite und Höhe dieses Bilds ab. (Geerbt von Image)
PixelFormat	Ruft das Pixelformat für dieses Image ab. (Geerbt von Image)
PropertyIdList	Ruft IDs für die in diesem Image gespeicherten Eigenschaftenelemente ab. (Geerbt von Image)
PropertyItems	Ruft alle in diesem Image gespeicherten Eigenschaftenelemente (Metadaten) ab. (Geerbt von Image)
RawFormat	Ruft das Dateiformat dieses Image ab. (Geerbt von Image)
Size	Ruft die Breite und Höhe dieses Bilds in Pixel ab. (Geerbt von Image)
Tag	Ruft ein Objekt ab, das zusätzliche Daten zu dem Bild bereitstellt, oder legt dieses Objekt fest. (Geerbt von Image)
VerticalResolution	Ruft die vertikale Auflösung dieses Image in Pixel pro Zoll ab. (Geerbt von Image)
Width	Ruft die Breite dieses Image in Pixel ab. (Geerbt von Image)

Methoden

Clone()	Erstellt eine genaue Kopie von dieser Image. (Geerbt von Image)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle von dieser Image verwendeten Ressourcen frei. (Geerbt von Image)
Dispose(Boolean)	Gibt die von Image verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von Image)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBounds(GraphicsUnit)	Ruft die Grenzen des Bilds in der angegebenen Einheit ab. (Geerbt von Image)
GetEncoderParameterList(Guid)	Gibt Informationen über die Parameter zurück, die vom angegebenen Bildencoder unterstützt werden. (Geerbt von Image)
GetFrameCount(FrameDimension)	Gibt die Anzahl der Rahmen in der angegebenen Abmessung zurück. (Geerbt von Image)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetHenhmetafile()	Gibt ein Windows-Handle für eine erweiterte Metafile zurück.
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetMetafileHeader()	Gibt den MetafileHeader zurück, der dieser Metafile zugeordnet ist.
GetMetafileHeader(IntPtr)	Gibt die MetafileHeader zurück, die dem angegebenen Metafile zugeordnet ist.
GetMetafileHeader(IntPtr, WmfPlaceableFileHeader)	Gibt die MetafileHeader zurück, die dem angegebenen Metafile zugeordnet ist.
GetMetafileHeader(Stream)	Gibt die MetafileHeader zurück, die dem angegebenen Metafile zugeordnet ist.
GetMetafileHeader(String)	Gibt die MetafileHeader zurück, die dem angegebenen Metafile zugeordnet ist.
GetPropertyItem(Int32)	Ruft das angegebene Eigenschaftenelement aus diesem Image ab. (Geerbt von Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Gibt eine Miniaturansicht für dieses Image zurück. (Geerbt von Image)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
PlayRecord(EmfPlusRecordType, Int32, Int32, Byte[])	Gibt einen einzelnen Metadateidatensatz wieder.
RemovePropertyItem(Int32)	Entfernt das angegebene Eigenschaftenelement aus diesem Image. (Geerbt von Image)
RotateFlip(RotateFlipType)	Dreht und/oder kippt das Image. (Geerbt von Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Speichert dieses Bild mit den angegebenen Encoder- und Bildencoderparametern im angegebenen Stream. (Geerbt von Image)
Save(Stream, ImageFormat)	Speichert dieses Bild im angegebenen Format im angegebenen Stream. (Geerbt von Image)
Save(String)	Speichert dieses Image in der angegebenen Datei oder dem Stream. (Geerbt von Image)
Save(String, ImageCodecInfo, EncoderParameters)	Speichert dieses Image mit den angegebenen Encoder- und Bildencoderparametern in der angegebenen Datei. (Geerbt von Image)
Save(String, ImageFormat)	Speichert dieses Image im angegebenen Format in der angegebenen Datei. (Geerbt von Image)
SaveAdd(EncoderParameters)	Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu. Mit dieser Methode speichern Sie ausgewählte Rahmen eines Bilds mit mehreren Rahmen in einem anderen Bild mit mehreren Rahmen. (Geerbt von Image)
SaveAdd(Image, EncoderParameters)	Fügt der in einem vorherigen Aufruf der Save-Methode angegebenen Datei bzw. dem Stream einen Rahmen hinzu. (Geerbt von Image)
SelectActiveFrame(FrameDimension, Int32)	Wählt den durch die angegebene Abmessung und den Index angegebenen Rahmen aus. (Geerbt von Image)
SetPropertyItem(PropertyItem)	Speichert ein Eigenschaftenelement (Metadaten) in diesem Image. (Geerbt von Image)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind. (Geerbt von Image)