Graphics.AddMetafileComment(Byte[]) Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Quelle:

Graphics.cs

Fügt dem aktuellen Metafileeinen Kommentar hinzu.

C#

public void AddMetafileComment(byte[] data);

Parameter

data

Byte[]

Array von Bytes, die den Kommentar enthalten.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers sowie thisForm, des Form für das Beispiel handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt eine temporäre Graphics zum Erstellen der Metadatei und ruft eine hdc, ein Handle für den Gerätekontext.

• Erstellt mithilfe der hdceine neue Metadatei.

• Erstellt eine Graphics für die Anzeige der Metadatei aus dem Metafile.

• Zeichnet ein Rechteck auf die Metadatei.

• Fügt der Metadatei einen Kommentar hinzu.

• Entfernt die Graphics für die Metadatei, die die Metadatei schließt.

• Entfernt die Metadatei.

• Gibt die temporäre hdcfrei.

• Entfernt die temporäre Graphics.

• Erstellt eine zweite Metadatei aus der zuvor erstellten Datei.

• Zeichnet die Metadatei auf den Bildschirm.

• Entfernt die Metadatei.

C#

private void AddMetafileCommentBytes(PaintEventArgs e)
{
    // Create temporary Graphics object for metafile
    //  creation and get handle to its device context.
    Graphics newGraphics = this.CreateGraphics();
    IntPtr hdc = newGraphics.GetHdc();
             
    // Create metafile object to record.
    Metafile metaFile1 = new Metafile("SampMeta.emf", hdc);
             
    // Create graphics object to record metaFile.
    Graphics metaGraphics = Graphics.FromImage(metaFile1);
             
    // Draw rectangle in metaFile.
    metaGraphics.DrawRectangle(new Pen(Color.Black, 5), 0, 0, 100, 100);
             
    // Create comment and add to metaFile.
    byte[] metaComment = {(byte)'T', (byte)'e', (byte)'s', (byte)'t'};
    metaGraphics.AddMetafileComment(metaComment);
             
    // Dispose of graphics object.
    metaGraphics.Dispose();
             
    // Dispose of metafile.
    metaFile1.Dispose();
             
    // Release handle to temporary device context.
    newGraphics.ReleaseHdc(hdc);
             
    // Dispose of scratch graphics object.
    newGraphics.Dispose();
             
    // Create existing metafile object to draw.
    Metafile metaFile2 = new Metafile("SampMeta.emf");
             
    // Draw metaFile to screen.
    e.Graphics.DrawImage(metaFile2, new Point(0, 0));
             
    // Dispose of metafile.
    metaFile2.Dispose();
}

Hinweise

Diese Methode ist nur gültig, wenn diese Graphics einem Metafilezugeordnet ist.

Gilt für: