HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Peut être utilisé pour spécifier des options supplémentaires lors de l’enregistrement d’un document dans leHtmlFixed format.

Pour en savoir plus, visitez leSpécifier les options d’enregistrement article documentaire.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Constructeurs

Nom	La description
HtmlFixedSaveOptions()	Default_Constructor

Propriétés

Nom	La description
AllowEmbeddingPostScriptFonts { get; set; }	Obtient ou définit une valeur booléenne indiquant s’il faut autoriser l’incorporation de polices avec des contours PostScript lors de l’incorporation de polices TrueType dans un document lors de son enregistrement. La valeur par défaut est`FAUX` .
ColorMode { get; set; }	Obtient ou définit une valeur déterminant la manière dont les couleurs sont rendues.
CssClassNamesPrefix { get; set; }	Spécifie le préfixe qui est ajouté à tous les noms de classe dans le fichier style.css. La valeur par défaut est`"oh"` .
CustomTimeZoneInfo { get; set; }	Obtient ou définit le fuseau horaire local personnalisé utilisé pour les champs de date/heure.
DefaultTemplate { get; set; }	Obtient ou définit le chemin d’accès au modèle par défaut (y compris le nom de fichier). La valeur par défaut de cette propriété estchaîne vide (Empty).
Dml3DEffectsRenderingMode { get; set; }	Obtient ou définit une valeur déterminant la manière dont les effets 3D sont rendus.
virtual DmlEffectsRenderingMode { get; set; }	Obtient ou définit une valeur déterminant la façon dont les effets DrawingML sont rendus.
DmlRenderingMode { get; set; }	Obtient ou définit une valeur déterminant la façon dont les formes DrawingML sont rendues.
Encoding { get; set; }	Spécifie l’encodage à utiliser lors de l’exportation au format HTML. La valeur par défaut est`nouveau codage UTF8 (vrai)` (UTF-8 avec nomenclature).
ExportEmbeddedCss { get; set; }	Spécifie si le CSS (Cascading Style Sheet) doit être intégré dans le document HTML.
ExportEmbeddedFonts { get; set; }	Spécifie si les polices doivent être intégrées dans le document HTML au format Base64. Remarque : la définition de cet indicateur peut augmenter considérablement la taille du fichier HTML de sortie.
ExportEmbeddedImages { get; set; }	Spécifie si les images doivent être intégrées dans un document HTML au format Base64. Remarque : la définition de cet indicateur peut augmenter considérablement la taille du fichier HTML de sortie.
ExportEmbeddedSvg { get; set; }	Spécifie si les ressources SVG doivent être intégrées dans le document HTML. La valeur par défaut est`vrai` .
ExportFormFields { get; set; }	Obtient ou définit une indication indiquant si les champs de formulaire sont exportés en tant qu’éléments interactifs (en tant que balise « entrée ») plutôt que convertis en texte ou en graphiques.
ExportGeneratorName { get; set; }	Quand`vrai` , entraîne l’intégration du nom et de la version d’Aspose.Words dans les fichiers produits. La valeur par défaut est`vrai` .
FontFormat { get; set; }	Obtient ou définit`ExportFontFormat` utilisé pour l’exportation de polices. La valeur par défaut estWoff .
ImlRenderingMode { get; set; }	Obtient ou définit une valeur déterminant la manière dont les objets Ink (InkML) sont rendus.
JpegQuality { get; set; }	Obtient ou définit une valeur déterminant la qualité des images JPEG dans le document HTML.
MemoryOptimization { get; set; }	Obtient ou définit la valeur déterminant si l’optimisation de la mémoire doit être effectuée avant d’enregistrer le document. La valeur par défaut de cette propriété est`FAUX` .
MetafileRenderingOptions { get; set; }	Permet de spécifier les options de rendu du métafichier.
NumeralFormat { get; set; }	Obtient ou définit`NumeralFormat` utilisé pour le rendu des chiffres. Les chiffres européens sont utilisés par défaut.
override OptimizeOutput { get; set; }	L’indicateur indique s’il est nécessaire d’optimiser la sortie. Si cet indicateur est défini, les canevas imbriqués redondants et les canevas vides sont supprimés, également les glyphes voisins avec le même formatage sont concaténés. Remarque : la précision de l’affichage du contenu peut être affectée si cette propriété est définie sur`vrai` . La valeur par défaut est`vrai` .
PageHorizontalAlignment { get; set; }	Spécifie l’alignement horizontal des pages dans un document HTML. La valeur par défaut estCenter .
PageMargins { get; set; }	Spécifie les marges autour des pages d’un document HTML. La valeur des marges est mesurée en points et doit être égale ou supérieure à 0. La valeur par défaut est de 10 points.
PageSavingCallback { get; set; }	Permet de contrôler la façon dont les pages séparées sont enregistrées lorsqu’un document est exporté au format de page fixe.
PageSet { get; set; }	Obtient ou définit les pages à restituer. La valeur par défaut est toutes les pages du document.
PrettyFormat { get; set; }	Quand`vrai` jolis formats de sortie le cas échéant. La valeur par défaut est`FAUX` .
ProgressCallback { get; set; }	Appelé lors de l’enregistrement d’un document et accepte les données sur la progression de l’enregistrement.
ResourceSavingCallback { get; set; }	Permet de contrôler la façon dont les ressources (images, polices et CSS) sont enregistrées lorsqu’un document est exporté au format HTML de page fixe.
ResourcesFolder { get; set; }	Spécifie le dossier physique dans lequel les ressources (images, polices, CSS) sont enregistrées lors de l’exportation d’un document au format HTML. La valeur par défaut est`nul` .
ResourcesFolderAlias { get; set; }	Spécifie le nom du dossier utilisé pour construire les URI d’image écrits dans un document HTML. La valeur par défaut est`nul` .
SaveFontFaceCssSeparately { get; set; }	L’indicateur indique si les règles CSS “@font-face” doivent être placées dans un fichier séparé “fontFaces.css” lorsqu’un document est enregistré avec une feuille de style externe (c’est-à-dire lorsqu’`ExportEmbeddedCss` est`FAUX` ). La valeur par défaut est`FAUX` , toutes les règles CSS sont écrites dans un seul fichier “styles.css”.
override SaveFormat { get; set; }	Spécifie le format dans lequel le document sera enregistré si cet objet d’options de sauvegarde est utilisé. Ne peut êtreHtmlFixed .
ShowPageBorder { get; set; }	Spécifie si la bordure autour des pages doit être affichée. La valeur par défaut est`vrai` .
TempFolder { get; set; }	Spécifie le dossier des fichiers temporaires utilisé lors de l’enregistrement dans un fichier DOC ou DOCX. Par défaut, cette propriété est`nul` et aucun fichier temporaire n’est utilisé.
UpdateCreatedTimeProperty { get; set; }	Obtient ou définit une valeur déterminant si le`CreatedTime` la propriété est mise à jour avant l’enregistrement. La valeur par défaut est`FAUX` ;
UpdateFields { get; set; }	Obtient ou définit une valeur déterminant si les champs de certains types doivent être mis à jour avant d’enregistrer le document dans un format de page fixe. La valeur par défaut de cette propriété est`vrai` .
UpdateLastPrintedProperty { get; set; }	Obtient ou définit une valeur déterminant si le`LastPrinted` la propriété est mise à jour avant l’enregistrement.
UpdateLastSavedTimeProperty { get; set; }	Obtient ou définit une valeur déterminant si le`LastSavedTime` la propriété est mise à jour avant l’enregistrement.
UseAntiAliasing { get; set; }	Obtient ou définit une valeur déterminant s’il faut ou non utiliser l’anticrénelage pour le rendu.
UseHighQualityRendering { get; set; }	Obtient ou définit une valeur déterminant s’il faut ou non utiliser des algorithmes de rendu de haute qualité (c’est-à-dire lents).
UseTargetMachineFonts { get; set; }	L’indicateur indique si les polices de la machine cible doivent être utilisées pour afficher le document. Si cet indicateur est défini sur`vrai` ,`FontFormat` et`ExportEmbeddedFonts` les propriétés n’ont pas d’effet, également`ResourceSavingCallback` n’est pas déclenché pour les polices. La valeur par défaut est`FAUX` .

Méthodes

Nom	La description
override Equals(object)	Détermine si l’objet spécifié a une valeur égale à l’objet actuel.

Exemples

Montre comment utiliser un rappel pour imprimer les URI des ressources externes créées lors de la conversion d’un document en 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
    };

    // Un dossier spécifié par ResourcesFolderAlias contiendra les ressources au lieu de ResourcesFolder.
    // Nous devons nous assurer que le dossier existe avant que les flux puissent y placer leurs ressources.
    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>
/// Compte et imprime les URI des ressources contenues par au fur et à mesure de leur conversion en HTML fixe.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Si nous définissons un alias de dossier dans l'objet SaveOptions, nous pourrons l'imprimer à partir d'ici.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // Par défaut, 'ResourceFileUri' utilise le dossier système pour les polices.
                // Pour éviter des problèmes sur d'autres plateformes, vous devez spécifier explicitement le chemin des polices.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

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

        // Si nous avons spécifié un dossier dans la propriété "ResourcesFolderAlias",
        // nous devrons également rediriger chaque flux pour mettre sa ressource dans ce dossier.
        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();
}

Voir également

class FixedPageSaveOptions
espace de noms Aspose.Words.Saving
Assemblée Aspose.Words

HtmlFixedPageHorizontalAlignment Enum HtmlMetafileFormat Enum