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 guardado Artículo de documentación.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Constructores

Nombre	Descripción
HtmlFixedSaveOptions()	Constructor predeterminado

Propiedades

Nombre	Descripción
AllowEmbeddingPostScriptFonts { get; set; }	Obtiene o establece un valor booleano que indica si se debe permitir la incrustación de fuentes con contornos PostScript al incrustar fuentes TrueType en un documento al guardarlo. El valor predeterminado es`FALSO` .
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`"aw"` .
CustomTimeZoneInfo { get; set; }	Obtiene o establece la zona horaria local personalizada utilizada para los campos de fecha y hora.
DefaultTemplate { get; set; }	Obtiene o establece la ruta a la plantilla predeterminada (incluido el nombre del archivo). El valor predeterminado para esta propiedad escadena 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 es`nueva codificación UTF8 (verdadero)` (UTF-8 con BOM).
ExportEmbeddedCss { get; set; }	Especifica si la CSS (hoja de estilo en cascada) debe incrustarse en el documento HTML.
ExportEmbeddedFonts { get; set; }	Especifica si las fuentes deben incrustarse en el documento HTML en formato Base64. Nota: 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 el documento HTML en formato Base64. Nota: 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 es`verdadero` .
ExportFormFields { get; set; }	Obtiene o establece la indicación de si los campos de formulario se exportan como elementos interactivos (como etiqueta ‘input’) en lugar de convertirse en texto o gráficos.
ExportGeneratorName { get; set; }	Cuando`verdadero` , hace que el nombre y la versión de Aspose.Words se incrusten en los archivos producidos. El valor predeterminado es`verdadero` .
FontFormat { get; set; }	Obtiene o establece`ExportFontFormat` Se utiliza para exportar fuentes. El valor predeterminado esWoff .
IdPrefix { get; set; }	Especifica un prefijo que se antepone a todos los ID de elementos generados en el documento de salida. El valor predeterminado es nulo y no se antepone ningún prefijo.
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 un valor que determina si se debe realizar la optimización de la memoria antes de guardar el documento. El valor predeterminado para esta propiedad es`FALSO` .
MetafileRenderingOptions { get; set; }	Permite especificar opciones de representación de metarchivos.
NumeralFormat { get; set; }	Obtiene o establece`NumeralFormat` Se utiliza para la representación de 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 se establece este indicador, 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 se establece en`verdadero` . El valor predeterminado es`verdadero` .
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 un formato de página fijo.
PageSet { get; set; }	Obtiene o establece las páginas que se representarán. El valor predeterminado son todas las páginas del documento.
PrettyFormat { get; set; }	Cuando`verdadero` , formatos bonitos de salida donde corresponda. El valor predeterminado es`FALSO` .
ProgressCallback { get; set; }	Se llama al guardar un documento y acepta datos sobre el progreso del guardado.
RemoveJavaScriptFromLinks { get; set; }	Especifica si se eliminará JavaScript de los enlaces. El valor predeterminado es`FALSO` .
ResourceSavingCallback { get; set; }	Permite controlar cómo se guardan los recursos (imágenes, fuentes y css) cuando se exporta un documento al 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 es`nulo` .
ResourcesFolderAlias { get; set; }	Especifica el nombre de la carpeta utilizada para construir las URI de imágenes escritas en un documento HTML. El valor predeterminado es`nulo` .
SaveFontFaceCssSeparately { get; set; }	El indicador indica si las reglas CSS “@font-face” deben colocarse en un archivo separado “fontFaces.css” cuando se guarda un documento con una hoja de estilo externa (es decir, cuando`ExportEmbeddedCss` es`FALSO` ). El valor predeterminado es`FALSO` Todas las reglas CSS se escriben en un solo 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. Solo se puedeHtmlFixed .
ShowPageBorder { get; set; }	Especifica si se debe mostrar el borde alrededor de las páginas. El valor predeterminado es`verdadero` .
TempFolder { get; set; }	Especifica la carpeta para los archivos temporales utilizados al guardar en un archivo DOC o DOCX. De forma predeterminada, esta propiedad es`nulo` y no se utilizan archivos temporales.
UpdateAmbiguousTextFont { get; set; }	Determina si los atributos de fuente se cambiarán según el código de carácter que se esté utilizando.
UpdateCreatedTimeProperty { get; set; }	Obtiene o establece un valor que determina si el`CreatedTime` La propiedad se actualiza antes de guardar. El valor predeterminado es`FALSO` ;
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 es`verdadero` .
UpdateLastPrintedProperty { get; set; }	Obtiene o establece un valor que determina si el`LastPrinted` La propiedad se actualiza antes de guardar.
UpdateLastSavedTimeProperty { get; set; }	Obtiene o establece un valor que determina si el`LastSavedTime` La propiedad se actualiza antes de guardar.
UseAntiAliasing { get; set; }	Obtiene o establece un valor que determina si se debe utilizar o no suavizado para la representación.
UseHighQualityRendering { get; set; }	Obtiene o establece un valor que determina si se deben utilizar o no algoritmos de renderizado de alta calidad (es decir, lentos).
UseTargetMachineFonts { get; set; }	El indicador indica si se deben usar las fuentes de la máquina de destino para mostrar el documento. Si este indicador está configurado en`verdadero` ,`FontFormat` y`ExportEmbeddedFonts` las propiedades no tienen efecto, también`ResourceSavingCallback` no se activa para fuentes. El valor predeterminado es`FALSO` .

Métodos

Nombre	Descripción
override Equals(object)	Determina si el objeto especificado es igual en valor al objeto actual.

Ejemplos

Muestra cómo utilizar una devolución de llamada para imprimir las 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 los flujos 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 las URI de los recursos contenidos en él a medida que se convierten a HTML fijo.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Si establecemos 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' utiliza 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 flujo 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

class FixedPageSaveOptions
espacio de nombres Aspose.Words.Saving
asamblea Aspose.Words

HtmlFixedPageHorizontalAlignment Enum HtmlMetafileFormat Enum