HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Se puede utilizar para especificar opciones adicionales al guardar un documento en elHtmlFixed formato.

Para obtener más información, visite elEspecificar opciones de guardar artículo de documentación.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Constructores

NombreDescripción
HtmlFixedSaveOptions()Constructor predeterminado

Propiedades

NombreDescripción
AllowEmbeddingPostScriptFonts { get; set; }Obtiene o establece un valor booleano que indica si se permite incrustar fuentes con contornos PostScript al incrustar fuentes TrueType en un documento una vez guardado. El valor predeterminado esFALSO .
ColorMode { get; set; }Obtiene o establece un valor que determina cómo se representan los colores.
CssClassNamesPrefix { get; set; }Especifica el prefijo que se agrega a todos los nombres de clase en el archivo style.css. El valor predeterminado es"ay" .
CustomTimeZoneInfo { get; set; }Obtiene o establece la zona horaria local personalizada utilizada para los campos de fecha/hora.
DefaultTemplate { get; set; }Obtiene o establece la ruta a la plantilla predeterminada (incluido el nombre del archivo). El valor predeterminado para esta propiedad escuerda vacía (Empty).
Dml3DEffectsRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los efectos 3D.
virtual DmlEffectsRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los efectos de DrawingML.
DmlRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan las formas de DrawingML.
Encoding { get; set; }Especifica la codificación que se utilizará al exportar a HTML. El valor predeterminado esnueva codificación UTF8 (verdadero) (UTF-8 con lista de materiales).
ExportEmbeddedCss { get; set; }Especifica si el CSS (hoja de estilos en cascada) debe incrustarse en el documento HTML.
ExportEmbeddedFonts { get; set; }Especifica si las fuentes deben incrustarse en el documento HTML en formato Base64. Tenga en cuenta que configurar este indicador puede aumentar significativamente el tamaño del archivo HTML de salida.
ExportEmbeddedImages { get; set; }Especifica si las imágenes deben incrustarse en un documento HTML en formato Base64. Tenga en cuenta que configurar este indicador puede aumentar significativamente el tamaño del archivo HTML de salida.
ExportEmbeddedSvg { get; set; }Especifica si los recursos SVG deben incrustarse en el documento HTML. El valor predeterminado esverdadero .
ExportFormFields { get; set; }Obtiene o establece una indicación de si los campos del formulario se exportan como elementos interactivos (como etiqueta de “entrada”) en lugar de convertirse a texto o gráficos.
ExportGeneratorName { get; set; }cuandoverdadero , hace que el nombre y la versión de Aspose.Words se incrusten en los archivos producidos. El valor predeterminado esverdadero .
FontFormat { get; set; }Obtiene o estableceExportFontFormat utilizado para exportar fuentes. El valor predeterminado esWoff .
ImlRenderingMode { get; set; }Obtiene o establece un valor que determina cómo se representan los objetos de tinta (InkML).
JpegQuality { get; set; }Obtiene o establece un valor que determina la calidad de las imágenes JPEG dentro del documento HTML.
MemoryOptimization { get; set; }Obtiene o establece el valor que determina si se debe realizar la optimización de la memoria antes de guardar el documento. El valor predeterminado para esta propiedad esFALSO .
MetafileRenderingOptions { get; set; }Permite especificar opciones de representación de metarchivos.
NumeralFormat { get; set; }Obtiene o estableceNumeralFormat se utiliza para representar números. Los números europeos se utilizan de forma predeterminada.
override OptimizeOutput { get; set; }El indicador indica si es necesario optimizar la salida. Si este indicador está configurado, se eliminan los lienzos anidados redundantes y los lienzos vacíos, también se concatenan los glifos vecinos con el mismo formato. Nota: La precisión de la visualización del contenido puede verse afectada si esta propiedad está establecida enverdadero . El valor predeterminado esverdadero .
PageHorizontalAlignment { get; set; }Especifica la alineación horizontal de las páginas en un documento HTML. El valor predeterminado esCenter .
PageMargins { get; set; }Especifica los márgenes alrededor de las páginas en un documento HTML. El valor de los márgenes se mide en puntos y debe ser igual o mayor que 0. El valor predeterminado es 10 puntos.
PageSavingCallback { get; set; }Permite controlar cómo se guardan las páginas separadas cuando un documento se exporta a formato de página fija.
PageSet { get; set; }Obtiene o establece las páginas que se van a representar. El valor predeterminado son todas las páginas del documento.
PrettyFormat { get; set; }cuandoverdadero salida con bonitos formatos cuando corresponda. El valor predeterminado esFALSO .
ProgressCallback { get; set; }Se llama durante el guardado de un documento y acepta datos sobre el progreso del guardado.
ResourceSavingCallback { get; set; }Permite controlar cómo se guardan los recursos (imágenes, fuentes y css) cuando se exporta un documento a formato HTML de página fija.
ResourcesFolder { get; set; }Especifica la carpeta física donde se guardan los recursos (imágenes, fuentes, CSS) al exportar un documento al formato HTML. El valor predeterminado esnulo .
ResourcesFolderAlias { get; set; }Especifica el nombre de la carpeta utilizada para construir URI de imágenes escritas en un documento HTML. El valor predeterminado esnulo .
SaveFontFaceCssSeparately { get; set; }El indicador indica si las reglas CSS “@font-face” deben colocarse en un archivo separado “fontFaces.css” cuando un documento se guarda con una hoja de estilo externa (es decir, cuandoExportEmbeddedCss esFALSO ). El valor predeterminado esFALSO , todas las reglas CSS se escriben en un único archivo “styles.css”.
override SaveFormat { get; set; }Especifica el formato en el que se guardará el documento si se utiliza este objeto de opciones de guardado. Sólo se puedeHtmlFixed .
ShowPageBorder { get; set; }Especifica si se deben mostrar los bordes alrededor de las páginas. El valor predeterminado esverdadero .
TempFolder { get; set; }Especifica la carpeta para archivos temporales utilizados al guardar en un archivo DOC o DOCX. De forma predeterminada, esta propiedad esnulo y no se utilizan archivos temporales.
UpdateCreatedTimeProperty { get; set; }Obtiene o establece un valor que determina si elCreatedTime La propiedad se actualiza antes de guardar. El valor predeterminado esFALSO ;
UpdateFields { get; set; }Obtiene o establece un valor que determina si los campos de ciertos tipos deben actualizarse antes de guardar el documento en un formato de página fijo. El valor predeterminado para esta propiedad esverdadero .
UpdateLastPrintedProperty { get; set; }Obtiene o establece un valor que determina si elLastPrinted la propiedad se actualiza antes de guardar.
UpdateLastSavedTimeProperty { get; set; }Obtiene o establece un valor que determina si elLastSavedTime la propiedad se actualiza antes de guardar.
UseAntiAliasing { get; set; }Obtiene o establece un valor que determina si se utiliza o no el suavizado para la representación.
UseHighQualityRendering { get; set; }Obtiene o establece un valor que determina si se utilizan o no algoritmos de renderizado de alta calidad (es decir, lentos).
UseTargetMachineFonts { get; set; }El indicador indica si se deben usar fuentes de la máquina de destino para mostrar el documento. Si este indicador está configurado enverdadero ,FontFormat yExportEmbeddedFonts las propiedades no tienen efecto, tambiénResourceSavingCallback no se activa para las fuentes. El valor predeterminado esFALSO .

Métodos

NombreDescripción
override Equals(object)Determina si el objeto especificado tiene el mismo valor que el objeto actual.

Ejemplos

Muestra cómo utilizar una devolución de llamada para imprimir los URI de recursos externos creados al convertir un documento a HTML.

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

    ResourceUriPrinter callback = new ResourceUriPrinter();

    HtmlFixedSaveOptions options = new HtmlFixedSaveOptions
    {
        SaveFormat = SaveFormat.HtmlFixed,
        ExportEmbeddedImages = false,
        ResourcesFolder = ArtifactsDir + "HtmlFixedResourceFolder",
        ResourcesFolderAlias = ArtifactsDir + "HtmlFixedResourceFolderAlias",
        ShowPageBorder = false,
        ResourceSavingCallback = callback
    };

    // Una carpeta especificada por ResourcesFolderAlias contendrá los recursos en lugar de ResourcesFolder.
    // Debemos asegurarnos de que la carpeta exista antes de que las transmisiones puedan poner sus recursos en ella.
    Directory.CreateDirectory(options.ResourcesFolderAlias);

    doc.Save(ArtifactsDir + "HtmlFixedSaveOptions.HtmlFixedResourceFolder.html", options);

    Console.WriteLine(callback.GetText());

    string[] resourceFiles = Directory.GetFiles(ArtifactsDir + "HtmlFixedResourceFolderAlias");

    Assert.False(Directory.Exists(ArtifactsDir + "HtmlFixedResourceFolder"));
    Assert.AreEqual(6, resourceFiles.Count(f => f.EndsWith(".jpeg") || f.EndsWith(".png") || f.EndsWith(".css")));
}

/// <summary>
/// Cuenta e imprime los URI de los recursos contenidos en a medida que se convierten a HTML fijo.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Si configuramos un alias de carpeta en el objeto SaveOptions, podremos imprimirlo desde aquí.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // De forma predeterminada, 'ResourceFileUri' usa la carpeta del sistema para las fuentes.
                // Para evitar problemas en otras plataformas debes especificar explícitamente la ruta de las fuentes.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

        mText.AppendLine("\t" + args.ResourceFileUri);

        // Si hemos especificado una carpeta en la propiedad "ResourcesFolderAlias",
        // también necesitaremos redirigir cada secuencia para colocar su recurso en esa carpeta.
        args.ResourceStream = new FileStream(args.ResourceFileUri, FileMode.Create);
        args.KeepResourceStreamOpen = false;
    }

    public string GetText()
    {
        return mText.ToString();
    }

    private int mSavedResourceCount;
    private readonly StringBuilder mText = new StringBuilder();
}

Ver también