HtmlFixedSaveOptions

HtmlFixedSaveOptions class

Может использоваться для указания дополнительных параметров при сохранении документа вHtmlFixed формат.

Чтобы узнать больше, посетитеУкажите параметры сохранения документальная статья.

public class HtmlFixedSaveOptions : FixedPageSaveOptions

Конструкторы

ИмяОписание
HtmlFixedSaveOptions()Конструктор по умолчанию.

Характеристики

ИмяОписание
AllowEmbeddingPostScriptFonts { get; set; }Возвращает или задает логическое значение, указывающее, разрешать ли встраивание шрифтов с контурами PostScript при встраивании шрифтов TrueType в документ при его сохранении. Значение по умолчанию:ЛОЖЬ .
ColorMode { get; set; }Возвращает или задает значение, определяющее способ отображения цветов.
CssClassNamesPrefix { get; set; }Указывает префикс, который добавляется ко всем именам классов в файле style.css. Значение по умолчанию:"ой" .
CustomTimeZoneInfo { get; set; }Возвращает или задает пользовательский локальный часовой пояс, используемый для полей даты/времени.
DefaultTemplate { get; set; }Возвращает или задает путь к шаблону по умолчанию (включая имя файла). Значение по умолчанию для этого свойства:пустая строка (Empty ).
Dml3DEffectsRenderingMode { get; set; }Возвращает или задает значение, определяющее способ визуализации 3D-эффектов.
virtual DmlEffectsRenderingMode { get; set; }Возвращает или задает значение, определяющее способ визуализации эффектов DrawingML.
DmlRenderingMode { get; set; }Возвращает или задает значение, определяющее способ визуализации фигур DrawingML.
Encoding { get; set; }Указывает кодировку, используемую при экспорте в HTML. Значение по умолчанию:новая кодировка UTF8(истина) (UTF-8 с BOM).
ExportEmbeddedCss { get; set; }Указывает, следует ли встраивать CSS (каскадную таблицу стилей) в HTML-документ.
ExportEmbeddedFonts { get; set; }Указывает, следует ли встраивать шрифты в HTML-документ в формате Base64. Обратите внимание, что установка этого флага может значительно увеличить размер выходного HTML-файла.
ExportEmbeddedImages { get; set; }Указывает, следует ли встраивать изображения в HTML-документ в формате Base64. Обратите внимание, что установка этого флага может значительно увеличить размер выходного HTML-файла.
ExportEmbeddedSvg { get; set; }Указывает, следует ли встраивать ресурсы SVG в документ HTML. Значение по умолчанию:истинный .
ExportFormFields { get; set; }Возвращает или задает указание того, экспортируются ли поля формы как интерактивные элементы (как тег «input»), а не преобразуются в текст или графику.
ExportGeneratorName { get; set; }Когдаистинный , приводит к внедрению имени и версии Aspose.Words в создаваемые файлы. Значение по умолчанию:истинный .
FontFormat { get; set; }Получает или устанавливаетExportFontFormat используется для экспорта шрифтов. Значение по умолчанию:Woff .
IdPrefix { get; set; }Указывает префикс, который добавляется ко всем сгенерированным идентификаторам элементов в выходном документе. Значение по умолчанию — null, и префикс не добавляется.
ImlRenderingMode { get; set; }Возвращает или задает значение, определяющее способ визуализации объектов рукописного ввода (InkML).
JpegQuality { get; set; }Возвращает или задает значение, определяющее качество изображений JPEG внутри документа HTML.
MemoryOptimization { get; set; }Возвращает или задает значение, определяющее, следует ли выполнять оптимизацию памяти перед сохранением документа. Значение по умолчанию для этого свойства:ЛОЖЬ .
MetafileRenderingOptions { get; set; }Позволяет указать параметры рендеринга метафайла.
NumeralFormat { get; set; }Получает или устанавливаетNumeralFormat используется для отображения цифр. По умолчанию используются европейские цифры.
override OptimizeOutput { get; set; }Флаг указывает, требуется ли оптимизировать вывод. Если этот флаг установлен, избыточные вложенные холсты и пустые холсты удаляются, также объединяются соседние глифы с одинаковым форматированием. Примечание: Точность отображения содержимого может быть затронута, если это свойство установлено вистинный . По умолчаниюистинный .
PageHorizontalAlignment { get; set; }Задает горизонтальное выравнивание страниц в документе HTML. Значение по умолчанию:Center .
PageMargins { get; set; }Задает поля вокруг страниц в документе HTML. Значение полей измеряется в пунктах и должно быть равно или больше 0. Значение по умолчанию — 10 пунктов.
PageSavingCallback { get; set; }Позволяет контролировать, как сохраняются отдельные страницы при экспорте документа в формат фиксированной страницы.
PageSet { get; set; }Получает или задает страницы для отображения. По умолчанию — все страницы в документе.
PrettyFormat { get; set; }Когдаистинный , красивые форматы вывода, где это применимо. Значение по умолчанию:ЛОЖЬ .
ProgressCallback { get; set; }Вызывается во время сохранения документа и принимает данные о ходе сохранения.
RemoveJavaScriptFromLinks { get; set; }Указывает, будет ли JavaScript удален из ссылок. Значение по умолчанию:ЛОЖЬ .
ResourceSavingCallback { get; set; }Позволяет контролировать, как сохраняются ресурсы (изображения, шрифты и css) при экспорте документа в формат HTML с фиксированной страницей.
ResourcesFolder { get; set; }Указывает физическую папку, в которой сохраняются ресурсы (изображения, шрифты, css) при экспорте документа в формат HTML. Значение по умолчанию:нулевой .
ResourcesFolderAlias { get; set; }Указывает имя папки, используемой для создания URI изображений, записанных в HTML-документ. Значение по умолчанию:нулевой .
SaveFontFaceCssSeparately { get; set; }Флаг указывает, следует ли помещать правила CSS “@font-face” в отдельный файл “fontFaces.css” при сохранении документа с внешней таблицей стилей (то есть, когдаExportEmbeddedCss этоЛОЖЬ ). Значение по умолчанию:ЛОЖЬ , все правила CSS записаны в один файл “styles.css”.
override SaveFormat { get; set; }Указывает формат, в котором будет сохранен документ, если используется этот объект параметров сохранения. Может быть толькоHtmlFixed .
ShowPageBorder { get; set; }Указывает, следует ли отображать границу вокруг страниц. Значение по умолчанию:истинный .
TempFolder { get; set; }Указывает папку для временных файлов, используемых при сохранении в файл DOC или DOCX. По умолчанию это свойствонулевой и временные файлы не используются.
UpdateAmbiguousTextFont { get; set; }Определяет, будут ли изменяться атрибуты шрифта в соответствии с используемым кодом символа.
UpdateCreatedTimeProperty { get; set; }Возвращает или задает значение, определяющее, является лиCreatedTime свойство обновляется перед сохранением. Значение по умолчанию:ЛОЖЬ ;
UpdateFields { get; set; }Возвращает или задает значение, определяющее, следует ли обновлять поля определенных типов перед сохранением документа в фиксированном формате страницы. Значение по умолчанию для этого свойства:истинный .
UpdateLastPrintedProperty { get; set; }Возвращает или задает значение, определяющее, является лиLastPrinted свойство обновляется перед сохранением.
UpdateLastSavedTimeProperty { get; set; }Возвращает или задает значение, определяющее, является лиLastSavedTime свойство обновляется перед сохранением.
UseAntiAliasing { get; set; }Возвращает или задает значение, определяющее, следует ли использовать сглаживание при рендеринге.
UseHighQualityRendering { get; set; }Возвращает или задает значение, определяющее, следует ли использовать высококачественные (т. е. медленные) алгоритмы рендеринга.
UseTargetMachineFonts { get; set; }Флаг указывает, должны ли использоваться шрифты с целевой машины для отображения документа. Если этот флаг установлен вистинный ,FontFormat иExportEmbeddedFonts свойства не имеют эффекта, такжеResourceSavingCallback не запускается для шрифтов. По умолчаниюЛОЖЬ .

Методы

ИмяОписание
override Equals(object)Определяет, равен ли указанный объект по значению текущему объекту.

Примеры

Показывает, как использовать обратный вызов для печати URI внешних ресурсов, созданных при преобразовании документа в 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
    };

    // Папка, указанная ResourcesFolderAlias, будет содержать ресурсы вместо ResourcesFolder.
    // Мы должны убедиться, что папка существует, прежде чем потоки смогут поместить в нее свои ресурсы.
    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>
/// Подсчитывает и выводит URI ресурсов, содержащихся в, по мере их преобразования в фиксированный HTML.
/// </summary>
private class ResourceUriPrinter : IResourceSavingCallback
{
    void IResourceSavingCallback.ResourceSaving(ResourceSavingArgs args)
    {
        // Если мы зададим псевдоним папки в объекте SaveOptions, мы сможем распечатать его отсюда.
        mText.AppendLine($"Resource #{++mSavedResourceCount} \"{args.ResourceFileName}\"");

        string extension = Path.GetExtension(args.ResourceFileName);
        switch (extension)
        {
            case ".ttf":
            case ".woff":
            {
                // По умолчанию «ResourceFileUri» использует системную папку для шрифтов.
                // Чтобы избежать проблем на других платформах, необходимо явно указать путь к шрифтам.
                args.ResourceFileUri = ArtifactsDir + Path.DirectorySeparatorChar + args.ResourceFileName;
                break;
            }
        }

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

        // Если мы указали папку в свойстве "ResourcesFolderAlias",
        // нам также потребуется перенаправить каждый поток, чтобы поместить его ресурс в эту папку.
        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();
}

Смотрите также