MetafileRenderingOptions

MetafileRenderingOptions class

Ermöglicht die Angabe zusätzlicher Optionen für die Metadateiwiedergabe.

Um mehr zu erfahren, besuchen Sie dieUmgang mit Windows-Metadateien Dokumentationsartikel.

public class MetafileRenderingOptions

Konstrukteure

NameBeschreibung
MetafileRenderingOptions()Default_Constructor

Eigenschaften

NameBeschreibung
EmfPlusDualRenderingMode { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie EMF+ Dual-Metadateien gerendert werden sollen.
EmulateRasterOperations { get; set; }Ruft einen Wert ab oder legt ihn fest, der bestimmt, ob die Rasteroperationen emuliert werden sollen oder nicht.
EmulateRenderingToSizeOnPage { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob beim Rendern der Metadatei die Anzeige der Metadatei entsprechend der Größe auf Seite oder die Anzeige der Metadatei in ihrer Standardgröße emuliert wird.
EmulateRenderingToSizeOnPageResolution { get; set; }Ruft die Auflösung in Pixeln pro Zoll für die Emulation der Metadateiwiedergabe auf die Größe auf der Seite ab oder legt sie fest.
RenderingMode { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie Metadateibilder gerendert werden sollen.
UseEmfEmbeddedToWmf { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, wie WMF-Metadateien mit eingebetteten EMF-Metadateien gerendert werden sollen.
UseGdiRasterOperationsEmulation { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob GDI+ für die Emulation von Rasteroperationen verwendet werden soll oder nicht.

Beispiele

Zeigt einen Fallback für die Bitmap-Wiedergabe und eine Änderung der Art der Warnungen zu nicht unterstützten Metadateidatensätzen an.

public void HandleBinaryRasterWarnings()
{
    Document doc = new Document(MyDir + "WMF with image.docx");

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // Setzen Sie die Eigenschaft "EmulateRasterOperations" auf "false", um auf Bitmap zurückzugreifen, wenn
    // Es wird auf eine Metadatei gestoßen, die Rasteroperationen erfordert, um sie im Ausgabe-PDF darzustellen.
    metafileRenderingOptions.EmulateRasterOperations = false;

    // Setzen Sie die Eigenschaft „RenderingMode“ auf „VectorWithFallback“, um zu versuchen, jede Metadatei mithilfe von Vektorgrafiken zu rendern.
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // Erstellen Sie ein "PdfSaveOptions"-Objekt, das wir an die "Save"-Methode des Dokuments übergeben können
    // um zu ändern, wie diese Methode das Dokument in .PDF konvertiert und die Konfiguration anwendet
    // in unserem MetafileRenderingOptions-Objekt zum Speichervorgang.
    PdfSaveOptions saveOptions = new PdfSaveOptions();
    saveOptions.MetafileRenderingOptions = metafileRenderingOptions;

    HandleDocumentWarnings callback = new HandleDocumentWarnings();
    doc.WarningCallback = callback;

    doc.Save(ArtifactsDir + "PdfSaveOptions.HandleBinaryRasterWarnings.pdf", saveOptions);

    Assert.AreEqual(1, callback.Warnings.Count);
    Assert.AreEqual("'R2_XORPEN' binary raster operation is not supported.",
        callback.Warnings[0].Description);
}

/// <summary>
/// Druckt und sammelt Warnungen bezüglich Formatierungsverlust, die beim Speichern eines Dokuments auftreten.
/// </summary>
public class HandleDocumentWarnings : IWarningCallback
{
    public void Warning(WarningInfo info)
    {
        if (info.WarningType == WarningType.MinorFormattingLoss)
        {
            Console.WriteLine("Unsupported operation: " + info.Description);
            Warnings.Warning(info);
        }
    }

    public WarningInfoCollection Warnings = new WarningInfoCollection();
}

Siehe auch