FontSavingArgs

FontSavingArgs class

Proporciona datos para elFontSaving evento.

Para obtener más información, visite elGuardar un documento artículo de documentación.

public class FontSavingArgs

Propiedades

NombreDescripción
Bold { get; }Indica si la fuente actual está en negrita.
Document { get; }Obtiene el objeto del documento que se está guardando.
FontFamilyName { get; }Indica el nombre de la familia de fuentes actual.
FontFileName { get; set; }Obtiene o establece el nombre del archivo (sin ruta) donde se guardará la fuente.
FontStream { get; set; }Permite especificar la secuencia donde se guardará la fuente.
IsExportNeeded { get; set; }Permite especificar si la fuente actual se exportará como recurso de fuente. El valor predeterminado esverdadero .
IsSubsettingNeeded { get; set; }Permite especificar si la fuente actual se subdividirá antes de exportarla como recurso de fuente.
Italic { get; }Indica si la fuente actual está en cursiva.
KeepFontStreamOpen { get; set; }Especifica si Aspose.Words debe mantener la secuencia abierta o cerrarla después de guardar una fuente.
OriginalFileName { get; }Obtiene el nombre del archivo de fuente original con una extensión.
OriginalFileSize { get; }Obtiene el tamaño del archivo de fuente original.

Observaciones

Cuando Aspose.Words guarda un documento en HTML o formatos relacionados yExportFontResources está configurado enverdadero, guarda cada tema de fuente para exportarlo en un archivo separado.

FontSavingArgs controla si un recurso de fuente en particular debe exportarse y cómo.

FontSavingArgsTambién permite redefinir cómo se generan los nombres de los archivos de fuentes o evitar por completo el almacenamiento de fuentes en archivos proporcionando sus propios objetos de secuencia.

Para decidir si desea guardar un recurso de fuente en particular, utilice elIsExportNeeded propiedad.

Para guardar fuentes en secuencias en lugar de archivos, use elFontStream propiedad.

Ejemplos

Muestra cómo definir una lógica personalizada para exportar fuentes al guardar en HTML.

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

    // Configurar un objeto SaveOptions para exportar fuentes a archivos separados.
    // Establece una devolución de llamada que manejará el guardado de fuentes de forma personalizada.
    HtmlSaveOptions options = new HtmlSaveOptions
    {
        ExportFontResources = true,
        FontSavingCallback = new HandleFontSaving()
    };

    // La devolución de llamada exportará archivos .ttf y los guardará junto con el documento de salida.
    doc.Save(ArtifactsDir + "HtmlSaveOptions.SaveExportedFonts.html", options);

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

}

/// <summary>
/// Imprime información sobre las fuentes exportadas y las guarda en la misma carpeta del sistema local que su salida .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");

        // También podemos acceder al documento fuente desde aquí.
        Assert.True(args.Document.OriginalFileName.EndsWith("Rendering.docx"));

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

        // Hay dos formas de guardar una fuente exportada.
        // 1 - Guárdelo en una ubicación del sistema de archivos local:
        args.FontFileName = args.OriginalFileName.Split(Path.DirectorySeparatorChar).Last();

        // 2 - Guárdalo en una secuencia:
        args.FontStream =
            new FileStream(ArtifactsDir + args.OriginalFileName.Split(Path.DirectorySeparatorChar).Last(), FileMode.Create);
        Assert.False(args.KeepFontStreamOpen);
    }
}

Ver también

FixedPageSaveOptions Class GraphicsQualityOptions Class