Warnrückrufe für Schriftart-Substitution in .NET erhalten

Übersicht

Aspose.Slides for .NET ermöglicht das Empfangen von Warnungsrückrufen für die Schriftartsubstitution, wenn eine erforderliche Schriftart während der Wiedergabe nicht auf dem System verfügbar ist. Diese Rückrufe helfen, Probleme mit fehlenden oder nicht zugänglichen Schriftarten zu diagnostizieren.

Warnungsrückrufe aktivieren

Aspose.Slides for .NET bietet einfache APIs, um Warnungsrückrufe beim Rendern von Präsentationsfolien zu erhalten. Befolgen Sie diese Schritte, um Warnungsrückrufe zu konfigurieren:

1. Erstellen Sie eine benutzerdefinierte Callback‑Klasse, die das IWarningCallback Interface implementiert, um Warnungen zu behandeln.
2. Setzen Sie den Warnungs‑Callback mithilfe von Optionsklassen wie RenderingOptions, PdfOptions, HtmlOptions und anderen.
3. Laden Sie eine Präsentation, die eine Schriftart verwendet, die auf dem Zielcomputer nicht verfügbar ist.
4. Erzeugen Sie ein Folien‑Miniaturbild oder exportieren Sie die Präsentation, um die Wirkung zu beobachten.

Benutzerdefinierte Warnungs‑Callback‑Klasse:

class FontWarningHandler : IWarningCallback
{
    public ReturnAction Warning(IWarningInfo warning)
    {
        if (warning.WarningType == WarningType.DataLoss)
        {
            Console.WriteLine(warning.Description);
        }

        return ReturnAction.Continue;
    }
}

// Beispielausgabe:
//
// Schriftart wird von XYZ zu {Calibri,Cambria Math,MS Gothic,Gulim,Arial Unicode,SimSun,Segoe UI Symbol}}

Folien‑Miniaturbild erzeugen:

// Richten Sie einen Warnungs-Callback ein, um schriftenbezogene Warnungen beim Rendern von Folien zu behandeln.
var options = new RenderingOptions();
options.WarningCallback = new FontWarningHandler();

// Laden Sie die Präsentation vom angegebenen Dateipfad.
using var presentation = new Presentation("sample.pptx");

// Erzeugen Sie ein Miniaturbild für jede Folie in der Präsentation.
foreach (var slide in presentation.Slides)
{
    // Holen Sie das Folien-Miniaturbild mit den angegebenen Renderoptionen.
    using var image = slide.GetImage(options);
    // ...
}

Exportieren in das PDF‑Format:

// Richten Sie einen Warnungs-Callback ein, um schriftenbezogene Warnungen beim PDF-Export zu behandeln.
var options = new PdfOptions();
options.WarningCallback = new FontWarningHandler();

// Laden Sie die Präsentation vom angegebenen Dateipfad.
using var presentation = new Presentation("sample.pptx");

// Exportieren Sie die Präsentation als PDF.
using var stream = new MemoryStream();
presentation.Save(stream, SaveFormat.Pdf, options);
// ...

Exportieren in das HTML‑Format:

// Richten Sie einen Warnungs-Callback ein, um schriftenbezogene Warnungen beim HTML-Export zu behandeln.
var options = new HtmlOptions();
options.WarningCallback = new FontWarningHandler();

// Laden Sie die Präsentation vom angegebenen Dateipfad.
using var presentation = new Presentation("sample.pptx");

// Exportieren Sie die Präsentation im HTML-Format.
using var stream = new MemoryStream();
presentation.Save(stream, SaveFormat.Html, options);
// ...