MetafileRenderingOptions

MetafileRenderingOptions class

Permet de spécifier des options de rendu de métafichier supplémentaires.

Pour en savoir plus, visitez leGestion des métafichiers Windows article documentaire.

public class MetafileRenderingOptions

Constructeurs

NomLa description
MetafileRenderingOptions()Default_Constructor

Propriétés

NomLa description
EmfPlusDualRenderingMode { get; set; }Obtient ou définit une valeur déterminant comment les métafichiers EMF+ Dual doivent être rendus.
EmulateRasterOperations { get; set; }Obtient ou définit une valeur déterminant si les opérations raster doivent être émulées ou non.
EmulateRenderingToSizeOnPage { get; set; }Obtient ou définit une valeur déterminant si le rendu du métafichier émule l’affichage du métafichier en fonction de la taille sur la page ou l’affichage du métafichier dans sa taille par défaut.
EmulateRenderingToSizeOnPageResolution { get; set; }Obtient ou définit la résolution en pixels par pouce pour l’émulation du rendu des métafichiers à la taille de la page.
RenderingMode { get; set; }Obtient ou définit une valeur déterminant la façon dont les images de métafichier doivent être rendues.
UseEmfEmbeddedToWmf { get; set; }Obtient ou définit une valeur déterminant comment les métafichiers WMF avec des métafichiers EMF intégrés doivent être rendus.
UseGdiRasterOperationsEmulation { get; set; }Obtient ou définit une valeur déterminant s’il faut ou non utiliser GDI+ pour l’émulation des opérations raster.

Exemples

Affiche l’ajout d’une solution de secours au rendu bitmap et la modification du type d’avertissements concernant les enregistrements de métafichiers non pris en charge.

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

    MetafileRenderingOptions metafileRenderingOptions = new MetafileRenderingOptions();

    // Définissez la propriété "EmulateRasterOperations" sur "false" pour revenir au bitmap lorsque
    // il rencontre un métafichier, qui nécessitera le rendu des opérations raster dans le PDF de sortie.
    metafileRenderingOptions.EmulateRasterOperations = false;

    // Définissez la propriété "RenderingMode" sur "VectorWithFallback" pour essayer de restituer chaque métafichier à l'aide de graphiques vectoriels.
    metafileRenderingOptions.RenderingMode = MetafileRenderingMode.VectorWithFallback;

    // Crée un objet "PdfSaveOptions" que l'on peut passer à la méthode "Save" du document
    // pour modifier la façon dont cette méthode convertit le document en .PDF et applique la configuration
    // dans notre objet MetafileRenderingOptions à l'opération de sauvegarde.
    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>
/// Imprime et collecte les avertissements liés à la perte de formatage qui se produisent lors de l'enregistrement d'un document.
/// </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();
}

Voir également