FontSavingArgs

FontSavingArgs class

Fornisce dati per ilFontSaving evento.

Per saperne di più, visita ilSalva un documento articolo di documentazione.

public class FontSavingArgs

Proprietà

NomeDescrizione
Bold { get; }Indica se il carattere corrente è in grassetto.
Document { get; }Ottiene l’oggetto documento che viene salvato.
FontFamilyName { get; }Indica il nome della famiglia di font corrente.
FontFileName { get; set; }Ottiene o imposta il nome del file (senza percorso) in cui verrà salvato il font.
FontStream { get; set; }Consente di specificare il flusso in cui verrà salvato il font.
IsExportNeeded { get; set; }Consente di specificare se il font corrente verrà esportato come risorsa font. Il valore predefinito èVERO .
IsSubsettingNeeded { get; set; }Consente di specificare se il font corrente verrà sottoposto a sottoinsieme prima dell’esportazione come risorsa font.
Italic { get; }Indica se il carattere corrente è corsivo.
KeepFontStreamOpen { get; set; }Specifica se Aspose.Words deve mantenere aperto il flusso o chiuderlo dopo aver salvato un font.
OriginalFileName { get; }Ottiene il nome del file del font originale con estensione .
OriginalFileSize { get; }Ottiene la dimensione originale del file del font.

Osservazioni

Quando Aspose.Words salva un documento in HTML o in formati correlati eExportFontResources è impostato suVERO, salva ogni tipo di font per l’esportazione in un file separato.

FontSavingArgs controlla se una particolare risorsa di font deve essere esportata e come.

FontSavingArgsconsente inoltre di ridefinire il modo in cui vengono generati i nomi dei file dei font o di aggirare completamente il salvataggio dei font nei file fornendo i propri oggetti stream.

Per decidere se salvare una particolare risorsa di font, utilizzareIsExportNeeded proprietà.

Per salvare i font in flussi anziché in file, utilizzareFontStream proprietà.

Esempi

Mostra come definire una logica personalizzata per l’esportazione dei font durante il salvataggio in HTML.

public void SaveExportedFonts()
{
    Document doc = new Document(MyDir + "Rendering.docx");

    // Configura un oggetto SaveOptions per esportare i font in file separati.
    // Imposta un callback che gestirà il salvataggio dei font in modo personalizzato.
    HtmlSaveOptions options = new HtmlSaveOptions
    {
        ExportFontResources = true,
        FontSavingCallback = new HandleFontSaving()
    };

    // Il callback esporterà i file .ttf e li salverà insieme al documento di output.
    doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveExportedFonts.html", options);

    foreach (string fontFilename in Array.FindAll(Directory.GetFiles(ArtifactsDir), s => s.EndsWith(".ttf")))
    {
        Console.WriteLine(fontFilename);
    }

}

/// <summary>
/// Stampa informazioni sui font esportati e li salva nella stessa cartella di sistema locale del loro output .html.
/// </summary>
public class HandleFontSaving : IFontSavingCallback
{
    void IFontSavingCallback.FontSaving(FontSavingArgs args)
    {
        Console.Write($"Font:\t{args.FontFamilyName}");
        if (args.Bold) Console.Write(", bold");
        if (args.Italic) Console.Write(", italic");
        Console.WriteLine($"\nSource:\t{args.OriginalFileName}, {args.OriginalFileSize} bytes\n");

        // Da qui possiamo anche accedere al documento sorgente.
        Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));

        Assert.True(args.IsExportNeeded);
        Assert.True(args.IsSubsettingNeeded);

        // Esistono due modi per salvare un font esportato.
        // 1 - Salvalo in una posizione del file system locale:
        args.FontFileName = args.OriginalFileName.Split(Path.DirectorySeparatorChar).Last();

        // 2 - Salvalo in uno stream:
        args.FontStream =
            new FileStream(ArtifactsDir + args.OriginalFileName.Split(Path.DirectorySeparatorChar).Last(), FileMode.Create);
        Assert.False(args.KeepFontStreamOpen);
    }
}

Guarda anche

FixedPageSaveOptions Class GraphicsQualityOptions Class