HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Può essere utilizzato per specificare opzioni aggiuntive quando si salva un documento nel fileHtmlFixed formato.

Per saperne di più, visita ilSpecificare le opzioni di salvataggio articolo di documentazione.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Costruttori

NomeDescrizione
HtmlFixedSaveOptions()Default_Costruttore

Proprietà

NomeDescrizione
AllowEmbeddingPostScriptFonts { get; set; }Ottiene o imposta un valore booleano che indica se consentire l’incorporamento di caratteri con contorni PostScript quando si incorporano caratteri TrueType in un documento al momento del salvataggio. Il valore predefinito èfalso .
ColorMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering dei colori.
CssClassNamesPrefix { get; set; }Specifica il prefisso che viene aggiunto a tutti i nomi delle classi nel file style.css. Il valore predefinito è"ah" .
CustomTimeZoneInfo { get; set; }Ottiene o imposta il fuso orario locale personalizzato utilizzato per i campi data/ora.
DefaultTemplate { get; set; }Ottiene o imposta il percorso del modello predefinito (incluso il nome file). Il valore predefinito per questa proprietà èstringa vuota (Empty).
Dml3DEffectsRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli effetti 3D.
virtual DmlEffectsRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli effetti DrawingML.
DmlRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering delle forme DrawingML.
Encoding { get; set; }Specifica la codifica da utilizzare durante l’esportazione in HTML. Il valore predefinito ènuova codifica UTF8(true) (UTF-8 con distinta base).
ExportEmbeddedCss { get; set; }Specifica se il CSS (Cascading Style Sheet) deve essere incorporato nel documento Html.
ExportEmbeddedFonts { get; set; }Specifica se i caratteri devono essere incorporati nel documento Html in formato Base64. Nota che l’impostazione di questo flag può aumentare significativamente la dimensione del file Html di output.
ExportEmbeddedImages { get; set; }Specifica se le immagini devono essere incorporate nel documento Html in formato Base64. Nota che l’impostazione di questo flag può aumentare significativamente la dimensione del file Html di output.
ExportEmbeddedSvg { get; set; }Specifica se le risorse SVG devono essere incorporate nel documento Html. Il valore predefinito èVERO .
ExportFormFields { get; set; }Ottiene o imposta l’indicazione se i campi del modulo vengono esportati come elementi interattivi (come tag ‘input’) anziché convertiti in testo o grafica.
ExportGeneratorName { get; set; }QuandoVERO , fa sì che il nome e la versione di Aspose.Words vengano incorporati nei file prodotti. Il valore predefinito èVERO .
FontFormat { get; set; }Ottiene o impostaExportFontFormat utilizzato per l’esportazione dei caratteri. Il valore predefinito èWoff .
ImlRenderingMode { get; set; }Ottiene o imposta un valore che determina la modalità di rendering degli oggetti input penna (InkML).
JpegQuality { get; set; }Ottiene o imposta un valore che determina la qualità delle immagini JPEG all’interno del documento Html.
MemoryOptimization { get; set; }Ottiene o imposta un valore che determina se l’ottimizzazione della memoria deve essere eseguita prima di salvare il documento. Il valore predefinito per questa proprietà èfalso .
MetafileRenderingOptions { get; set; }Permette di specificare le opzioni di rendering del metafile.
NumeralFormat { get; set; }Ottiene o impostaNumeralFormat utilizzato per il rendering dei numeri. I numeri europei vengono utilizzati per impostazione predefinita.
override OptimizeOutput { get; set; }Il flag indica se è necessario ottimizzare l’output. Se questo flag è impostato, le tele nidificate ridondanti e le tele vuote vengono rimosse, vengono concatenati anche i glifi vicini con la stessa formattazione. Nota: la precisione della visualizzazione del contenuto potrebbe essere influenzata se questa proprietà è impostata suVERO . L’impostazione predefinita èVERO .
PageHorizontalAlignment { get; set; }Specifica l’allineamento orizzontale delle pagine in un documento HTML. Il valore predefinito èCenter .
PageMargins { get; set; }Specifica i margini attorno alle pagine in un documento HTML. Il valore dei margini è misurato in punti e deve essere uguale o maggiore di 0. Il valore predefinito è 10 punti.
PageSavingCallback { get; set; }Permette di controllare come vengono salvate le pagine separate quando un documento viene esportato in un formato di pagina fisso.
PageSet { get; set; }Ottiene o imposta le pagine da visualizzare. L’impostazione predefinita è tutte le pagine nel documento.
PrettyFormat { get; set; }QuandoVERO formati di output graziosi dove applicabile. Il valore predefinito èfalso .
ProgressCallback { get; set; }Chiamato durante il salvataggio di un documento e accetta i dati sull’avanzamento del salvataggio.
ResourceSavingCallback { get; set; }Permette di controllare come vengono salvate le risorse (immagini, font e css) quando un documento viene esportato in formato Html a pagina fissa.
ResourcesFolder { get; set; }Specifica la cartella fisica in cui vengono salvate le risorse (immagini, caratteri, css) durante l’esportazione di un documento in formato Html. Il valore predefinito ènullo .
ResourcesFolderAlias { get; set; }Specifica il nome della cartella utilizzata per costruire gli URI di immagine scritti in un documento Html. Il valore predefinito ènullo .
SaveFontFaceCssSeparately { get; set; }Il flag indica se le regole CSS “@font-face” devono essere inserite in un file separato “fontFaces.css” quando un documento viene salvato con un foglio di stile esterno (ovvero quandoExportEmbeddedCss èfalso ). Il valore predefinito èfalso , tutte le regole CSS vengono scritte in un unico file “styles.css”.
override SaveFormat { get; set; }Specifica il formato in cui il documento verrà salvato se viene utilizzato questo oggetto opzioni di salvataggio. Può essereHtmlFixed .
ShowPageBorder { get; set; }Specifica se deve essere mostrato il bordo attorno alle pagine. L’impostazione predefinita èVERO .
TempFolder { get; set; }Specifica la cartella per i file temporanei utilizzata durante il salvataggio in un file DOC o DOCX. Per impostazione predefinita questa proprietà ènullo e non vengono utilizzati file temporanei.
UpdateCreatedTimeProperty { get; set; }Ottiene o imposta un valore che determina se ilCreatedTime la proprietà viene aggiornata prima del salvataggio. Il valore predefinito èfalso ;
UpdateFields { get; set; }Ottiene o imposta un valore che determina se i campi di determinati tipi devono essere aggiornati prima di salvare il documento in un formato di pagina fisso. Il valore predefinito per questa proprietà èVERO .
UpdateLastPrintedProperty { get; set; }Ottiene o imposta un valore che determina se ilLastPrinted la proprietà viene aggiornata prima del salvataggio.
UpdateLastSavedTimeProperty { get; set; }Ottiene o imposta un valore che determina se ilLastSavedTime la proprietà viene aggiornata prima del salvataggio.
UseAntiAliasing { get; set; }Ottiene o imposta un valore che determina se utilizzare o meno l’antialiasing per il rendering.
UseHighQualityRendering { get; set; }Ottiene o imposta un valore che determina se utilizzare o meno algoritmi di rendering di alta qualità (ovvero lenti).
UseTargetMachineFonts { get; set; }Il flag indica se è necessario utilizzare i caratteri del computer di destinazione per visualizzare il documento. Se questo flag è impostato suVERO ,FontFormat EExportEmbeddedFonts le proprietà non hanno effetto, ancheResourceSavingCallback non viene attivato per i caratteri. L’impostazione predefinita èfalso .

Metodi

NomeDescrizione
override Equals(object)Determina se l’oggetto specificato ha un valore uguale all’oggetto corrente.

Esempi

Mostra come utilizzare un callback per stampare gli URI delle risorse esterne create durante la conversione di un documento in 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 cartella specificata da ResourcesFolderAlias conterrà le risorse anziché ResourcesFolder.
    // Dobbiamo garantire che la cartella esista prima che i flussi possano inserirvi le proprie risorse.
    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>
/// Conta e stampa gli URI delle risorse contenute da mentre vengono convertiti in HTML fisso.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Se impostiamo un alias di cartella nell'oggetto SaveOptions, potremo stamparlo da qui.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // Per impostazione predefinita, "ResourceFileUri" utilizza la cartella di sistema per i caratteri.
                // Per evitare problemi su altre piattaforme è necessario specificare esplicitamente il percorso dei caratteri.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

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

        // Se abbiamo specificato una cartella nella proprietà "ResourcesFolderAlias",
        // dovremo anche reindirizzare ogni flusso per inserire la relativa risorsa in quella cartella.
        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();
}

Guarda anche