MetafileRenderingOptions

MetafileRenderingOptions class

Consente di specificare opzioni aggiuntive di rendering dei metafile.

Per saperne di più, visita ilGestione dei metafile di Windows articolo di documentazione.

public class MetafileRenderingOptions

Costruttori

NomeDescrizione
MetafileRenderingOptions()Default_Costruttore

Proprietà

NomeDescrizione
EmfPlusDualRenderingMode { get; set; }Ottiene o imposta un valore che determina come devono essere renderizzati i metafile EMF+ Dual.
EmulateRasterOperations { get; set; }Ottiene o imposta un valore che determina se le operazioni raster devono essere emulate o meno.
EmulateRenderingToSizeOnPage { get; set; }Ottiene o imposta un valore che determina se il rendering del metafile emula la visualizzazione del metafile in base alle dimensioni sulla pagina o la visualizzazione del metafile nella sua dimensione predefinita.
EmulateRenderingToSizeOnPageResolution { get; set; }Ottiene o imposta la risoluzione in pixel per pollice per l’emulazione del rendering dei metafile in base alle dimensioni della pagina.
RenderingMode { get; set; }Ottiene o imposta un valore che determina come devono essere renderizzate le immagini metafile.
UseEmfEmbeddedToWmf { get; set; }Ottiene o imposta un valore che determina come devono essere renderizzati i metafile WMF con metafile EMF incorporati.
UseGdiRasterOperationsEmulation { get; set; }Ottiene o imposta un valore che determina se utilizzare o meno GDI+ per l’emulazione delle operazioni raster.

Esempi

Mostra l’aggiunta di un fallback al rendering bitmap e la modifica del tipo di avviso sui record di metafile non supportati.

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

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // Imposta la proprietà "EmulateRasterOperations" su "false" per tornare alla bitmap quando
    // incontra un metafile che richiederà operazioni raster per essere renderizzato nel PDF di output.
    metafileRenderingOptions.EmulateRasterOperations = false;

    // Impostare la proprietà "RenderingMode" su "VectorWithFallback" per provare a eseguire il rendering di ogni metafile utilizzando la grafica vettoriale.
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // Creiamo un oggetto "PdfSaveOptions" che possiamo passare al metodo "Save" del documento
    // per modificare il modo in cui quel metodo converte il documento in .PDF e applica la configurazione
    // nel nostro oggetto MetafileRenderingOptions per l'operazione di salvataggio.
    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>
/// Stampa e raccoglie gli avvisi relativi alla perdita di formattazione che si verificano durante il salvataggio di un documento.
/// </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();
}

Guarda anche