Class HtmlSaveOptions

Název místa: Aspose.Words.Saving Shromáždění: Aspose.Words.dll (25.4.0)

Může být použit k určení dalších možností při uložení dokumentu doSpolečnost Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Formát Aspose.Words.SaveFormat.Azw3 nebo formát Aspose.Words.SaveFormat.Mobi.

Chcete-li se dozvědět více, navštivte Specify Save Options Dokumentační článek .

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

Dědiční členové

SaveOptions.CreateSaveOptions(SaveFormat) , SaveOptions.CreateSaveOptions(string) , SaveOptions.SaveFormat , SaveOptions.ExportGeneratorName , SaveOptions.TempFolder , SaveOptions.PrettyFormat , SaveOptions.UseAntiAliasing , SaveOptions.UseHighQualityRendering , SaveOptions.DmlRenderingMode , SaveOptions.DmlEffectsRenderingMode , SaveOptions.ImlRenderingMode , SaveOptions.DefaultTemplate , SaveOptions.UpdateFields , SaveOptions.UpdateLastSavedTimeProperty , SaveOptions.UpdateLastPrintedProperty , SaveOptions.UpdateCreatedTimeProperty , SaveOptions.MemoryOptimization , SaveOptions.UpdateAmbiguousTextFont , SaveOptions.Dml3DEffectsRenderingMode , SaveOptions.ProgressCallback , SaveOptions.AllowEmbeddingPostScriptFonts , SaveOptions.CustomTimeZoneInfo , object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

HtmlSaveOptions()

Iniciuje nový příklad této třídy, který lze použít k uložení dokumentuv formátu Aspose.Words.SaveFormat.Html.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Iniciuje nový příklad této třídy, který lze použít k uložení dokumentuv Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Formát Aspose.Words.SaveFormat.Azw3 nebo formát Aspose.Words.SaveFormat.Mobi.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Může být Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Společnost Aspose.Words.SaveFormat.Azw3 nebo Aspose.Words.SaveFormat.Mobi.

Properties

AllowNegativeIndent

Určuje, zda jsou negativní levé a pravé podklady odstavců normalizovány, když se ušetří do HTML, MHTML nebo EPUB'.

public bool AllowNegativeIndent { get; set; }

Hodnota nemovitosti

bool

Remarks

Když negativní indent není povolen, je exportován jako nulová hranice do HTML. Když je povolen negativní indent, odstavec se může objevit částečně mimo okno prohlížeče.

CssClassNamePrefix

Určuje předpověď, která je přidána ke všem názvům třídy CSS.Předvolená hodnota je prázdný řádek a generované názvy třídy CSS nemají žádný společný předpov.

public string CssClassNamePrefix { get; set; }

Hodnota nemovitosti

string

Remarks

Pokud tato hodnota není prázdná, všechny třídy CSS generované společností Aspose.Words začnou s uvedeným předpísem.To může být užitečné, například, pokud přidáte přizpůsobený CSS k generovaným dokumentům a chcete zabránit konfliktům s názvem třídy.

Pokud hodnota není nebo je prázdná, musí to být platný identifikátor CSS.

Exceptions

ArgumentException

Hodnota není prázdná a není platným identifikátorem CSS.

CssSavingCallback

Umožňuje ovládat, jak jsou CSS styly uložené, když je dokument uložen do HTML, MHTML nebo EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

Hodnota nemovitosti

ICssSavingCallback

CssStyleSheetFileName

Určuje cestu a název souboru Cascading Style Sheet (CSS), který je napsán, když dokumentJe exportován do HTML.Default je prázdný řetězec.

public string CssStyleSheetFileName { get; set; }

Hodnota nemovitosti

string

Remarks

Tato vlastnost je účinná pouze tehdy, když je dokument uložen ve formátu HTML a externí CSS stylový list je požadován pomocí Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType.

Pokud je tato vlastnost prázdná, bude soubor CSS uložen do stejné složky a se stejným jménem jako dokument HTML, ale s rozšířením “.css.

Pokud je v této vlastnosti uveden pouze průvodce, ale žádný název souboru, bude soubor CSS uložen do specifikované složky a bude mít stejný název jako dokument HTML, ale s rozšířením “.css.

Pokud složka uvedená touto vlastností neexistuje, bude automaticky vytvořena před uložením souboru CSS.

Dalším způsobem, jak určit složku, kde je externí CSS soubor uložen, je použití Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder Aspose.Words.Saving.HtmlSaveOptions.ResourceFolderAlias Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType

CssStyleSheetType

Určuje, jak CSS (Cascading Style Sheet) styly jsou exportovány do HTML, MHTML nebo EPUB.Předvolená hodnota je Aspose.Words.Saving.CssStyleSheetType.Inline pro HTML/MHTML aAspose.Words.Saving.CssStyleSheetType.External pro EPUB.

public CssStyleSheetType CssStyleSheetType { get; set; }

Hodnota nemovitosti

CssStyleSheetType

Remarks

Úspora CSS stylového listu do externího souboru je podporována pouze při úsporu do HTML. Když se vyvážíte do jednoho z formátů kontejneru (EPUB nebo MHTML) a specifikace Aspose.Words.Saving.CssStyleSheetType.External, CSS soubory budou encapsulated do výstupního balíčku.

Vidět také

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Umožňuje ovládat, jak jsou části dokumentu uloženy, když je dokument uložena do HTML nebo EPUB.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

Hodnota nemovitosti

IDocumentPartSavingCallback

DocumentSplitCriteria

Určuje, jak by měl být dokument rozdělen při uložení do Aspose.Words.SaveFormat.Html,Formát Aspose.Words.SaveFormat.Epub nebo formát Aspose.Words.SaveFormat.Azw3.Podmínkou je Aspose.Words.Saving.DocumentSplitCriteria.None pro HTML aAspose.Words.Saving.DocumentSplitCriteria.HeadingParagraf pro EPUB a AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

Hodnota nemovitosti

DocumentSplitCriteria

Remarks

Obvykle byste chtěli dokument uložený do HTML jako jediný soubor. Ale v některých případech je lepší rozdělit výstup do několika menších HTML stránek. Když uložit do formátu HTML tyto stránky budou vystupovat na jednotlivé soubory nebo toky.

Dokument nelze rozdělit při uložení ve formátu MHTML.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitHeadingLevel Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

DocumentSplitHeadingLevel

Ukazuje maximální úroveň titulků, na které se dokument rozdělí.Default hodnoty je ‘2’.

public int DocumentSplitHeadingLevel { get; set; }

Hodnota nemovitosti

int

Remarks

Když Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria zahrnuje Wl26.Poskytnutí dokumentů.HeadingParagraph a tato vlastnost je nastaven na hodnotu od 1 do 9, dokument bude rozdělen na odstavce formátované pomocí , , atd. stylů až do specifikované úrovně názvu.

Podle výchozího nastavení, pouze a odstavce způsobují, že dokument bude rozdělen. Nastavení této vlastnosti na nulu způsobí, aby dokument nebyl rozdělena v hlavních odstavcích vůbec.

Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria Aspose.Words.Saving.HtmlSaveOptions.DocumentPartSavingCallback

Encoding

Specifikuje kódování pro použití při exportu do HTML, MHTML nebo EPUB.Default hodnotou je ’nový UTF8Encoding(false)’ (UTF-8 bez BOM).

public Encoding Encoding { get; set; }

Hodnota nemovitosti

Encoding

ExportCidUrlsForMhtmlResources

Určuje, zda použít CID (Content-ID) URL k referenčním zdrojům (obrázky, písma, CSS) zahrnutých v MHTML dokumentech'.

public bool ExportCidUrlsForMhtmlResources { get; set; }

Hodnota nemovitosti

bool

Remarks

Tato možnost se týká pouze dokumentů, které jsou uloženy v MHTML.

Ve výchozím nastavení jsou zdroje v dokumentech MHTML odkazovány názvem souboru (např. „image.png“), které se vyrovnávají s titulky „Content-Location“ částí MIME.

Tato možnost umožňuje alternativní metodu, kde jsou odkazy na zdrojové soubory psány jako CID (Content-ID) URL (např. „cid:image.png“) a odpovídají titulkům „Content-ID.

V teorii by mezi těmito dvěma referenčními metodami neměl být žádný rozdíl a ani jeden z nich by měl fungovat dobře v jakémkoli prohlížeči nebo e-mailovém agentu. V praxi však někteří agenti nedokáží získat zdroje podle názvu souboru. Pokud váš prohlížeč nebo e-mailový agent odmítá načítat zdroje obsažené v dokumentu MTHML (neobrazuje obrázky nebo neobsahuje CSS styly), zkuste exportovat dokument s adresami CID.

ExportDocumentProperties

Určuje, zda vyvážet vestavěné a přizpůsobené vlastnosti dokumentu do HTML, MHTML nebo EPUB.Default hodnoty jsou “falšovan'.

public bool ExportDocumentProperties { get; set; }

Hodnota nemovitosti

bool

ExportDropDownFormFieldAsText

Ovládá, jak jsou položky formy drop-down uloženy do HTML nebo MHTML.Default hodnoty jsou “falešn'.

public bool ExportDropDownFormFieldAsText { get; set; }

Hodnota nemovitosti

bool

Remarks

Když je nastaven na , exportuje drop-down formy pole jako normální text. Když , exportuje drop-down formy pole jako SELECT prvek v HTML.

Při exportu do EPUB jsou textové položky formy vždy uložené jako text kvůli požadavkům tohoto formátu.

ExportFontResources

Určuje, zda by měly být zdroje písma exportovány do HTML, MHTML nebo EPUB.Default je “falešn'.

public bool ExportFontResources { get; set; }

Hodnota nemovitosti

bool

Remarks

<p>Exporting font resources allows for consistent document rendering independent of the fonts available
         in a given user's environment.</p>

Pokud Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources je nastaven na , hlavní HTML dokument bude odkazovat na každý font prostřednictvím CSS 3 v řadě a fonty budou vydány jako samostatné soubory.

Pokud je nastaven na Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 , fonty nebudou uloženy do samostatných soubor.

Při vývozu fontových zdrojů by se měly vzít v úvahu problémy s licencí fontů. Autorové, kteří chtějí používat konkrétní fonty prostřednictvím stáhovatelného fontového mechanismu, musí vždy pečlivě ověřit, že jejich zamýšlené použití je v rámci rozsahu licence font. Mnoho komerčních fontov v současné době neumožňuje webové stahování jejich písmen v jakékoli formě. Licenční dohody, které pokrývají některé písmena specificky poznamenává, że používání pomocí pravidel v CSS stylových listů není povoleno.

Společnost Aspose.Words.Saving.HtmlSaveOptions.FontResourcesSubsettingSizeThreshold

ExportFontsAsBase64

Ukazuje, zda by zdroje fontů měly být vkládány do HTML v Base64 kódování.Default je ‘falešn’.

public bool ExportFontsAsBase64 { get; set; }

Hodnota nemovitosti

bool

Remarks

Podle výchozího nastavení jsou písma psána do samostatných souborů.Pokud je tato možnost nastavená, budou písma vestavěna do CSS dokumentu v kódování Base64.

ExportHeadersFootersMode

Určuje, jak jsou hlavice a stopy výstupem do HTML, MHTML nebo EPUB.Předvolená hodnota je Aspose.Words.Saving.ExportHeadersFootersMode.PerSection pro HTML/MHTMLa Aspose.Words.Saving.ExportHeadersFootersMode.Nikdo pro EPUB.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

Hodnota nemovitosti

ExportHeadersFootersMode

Remarks

Je těžké smysluplně vytvářet titulky a stopy do HTML, protože HTML není zobrazen.

Když je tato vlastnost Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, Aspose.Words vyváží pouze primární hlavice a nohy na začátku a konci každého oddílu.

Když je Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectionFooter se vyváží pouze první primární název a poslední primární stopu (včetně odkazů na předchozí).

Můžete deaktivovat export hlavic a nohou úplně nastavením této vlastnosti na Aspose.Words.Saving.ExportHeadersFootersMode.None.

ExportImagesAsBase64

Určuje, zda jsou obrázky uloženy ve formátu Base64 do výstupu HTML, MHTML nebo EPUB.Default je ‘falešn’.

public bool ExportImagesAsBase64 { get; set; }

Hodnota nemovitosti

bool

Remarks

Když je tato vlastnost nastavena na obrázky, data jsou exportovány přímo do prvků a samostatné soubory nejsou vytvořeny.

ExportLanguageInformation

Určuje, zda jsou jazykové informace exportovány do HTML, MHTML nebo EPUB.Default je “falešn'.

public bool ExportLanguageInformation { get; set; }

Hodnota nemovitosti

bool

Remarks

Když je tato vlastnost nastavená na Aspose.Words vyjde HTML atribut na prvky dokumentu, které specifikují jazyk.

ExportListLabels

Zkontroluje, jak jsou seznamové štítky vystupovány do HTML, MHTML nebo EPUB.Předvolená hodnota je Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

Hodnota nemovitosti

ExportListLabels

ExportOriginalUrlForLinkedImages

Určuje, zda by se původní URL mělo používat jako URL propojených obrázků.Default je ‘falešn’.

public bool ExportOriginalUrlForLinkedImages { get; set; }

Hodnota nemovitosti

bool

Remarks

Pokud je hodnota nastavená na Aspose.Words.Drawing.ImageData.SourceFullName hodnota se používá jako URL propojených obrázků a propojených obrázků nejsou nahrány do složky dokumentu nebo Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Pokud je hodnota nastavená na připojené obrázky jsou přenášeny do složky dokumentu nebo Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder a URL každého propojeného obrazu je konstruován v závislosti na složce dokumentu, __ WL26.

ExportPageMargins

Určuje, zda jsou stránky margin exportovány do HTML, MHTML nebo EPUB.Default je “falešn'.

public bool ExportPageMargins { get; set; }

Hodnota nemovitosti

bool

Remarks

Aspose.Words nezobrazuje výchozí rozsah stránek.Pokud jsou některé prvky zcela nebo částečně klepnuty okrajem dokumentu, může být zobrazená oblast rozšířena oTuto možnost.

ExportPageSetup

Určuje, zda je nastavení stránky exportováno do HTML, MHTML nebo EPUB.Default je “falešn'.

public bool ExportPageSetup { get; set; }

Hodnota nemovitosti

bool

Remarks

Každý Aspose.Words.Section v modelu dokumentu Aspose.Words poskytuje informace o nastavení stránky prostřednictvím třídy Aspose.Words.PageSetup.Když exportujete dokument do formátu HTML, možná budete muset tyto informace uchovávat pro další použití.Zejména, nastavení stránky může být důležité pro renderování do vytištěných médií (tisk) nebo následné konverze do původních formátů souborů Microsoft Word (DOCX, DOC, RTF, WML).

Ve většině případů je HTML určen pro zobrazení v prohlížečích, kde není vyhledávání prováděno.

ExportRelativeFontSize

Určuje, zda by velikost písma měla být výstupem v relativních jednotkách, když se ušetří na HTML, MHTML nebo EPUB.Default je “falešn'.

public bool ExportRelativeFontSize { get; set; }

Hodnota nemovitosti

bool

Remarks

V mnoha existujících dokumentech (HTML, IDPF EPUB) jsou velikost písma specifikována v relativních jednotkách. To umožňuje aplikacím upravit velikostí textu při prohlížení / zpracování dokumentů. Například, Microsoft Internet Explorer má podmenu “View->Text Size”, Adobe Digital Editions má dva tlačítka: Zvýšení / snížení Text Size. Pokud očekáváte, že tato funkce bude fungovat, pak nastavte Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize vlastnost na .

Aspose Words dokument model obsahuje a funguje pouze s absolutní velikost písma jednotky. Relativní jednotka potřebuje dodatečnou logiku, aby byla přepočítána z některé počáteční (standardní) velikosti. Font rozměr dokumentu styl je považován za standard. Například, pokud má 12pt písmo a některý text je 18pt pak to bude výstup podle HTML.

Když je tato možnost aktivována, prvky dokumentu jiné než text bude stále mít absolutní rozměry. Také některé text-související atributy mohou být vyjádřeny absolutně. Zejména, line spacing specifikované s “přesně” pravidlo může produkovat nežádoucí výsledky při skalování textu. Takže zdrojové dokumenty by měly být řádně navrženy a testovány při exportování s Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize nastaven na .

ExportRoundtripInformation

Upozorňuje, zda je nutné psát informace o okruhu při ušetření do HTML, MHTML nebo EPUB.Default hodnoty jsou “pravdivé” pro HTML a “falšované” pro MHTML a EPUB.

public bool ExportRoundtripInformation { get; set; }

Hodnota nemovitosti

bool

Remarks

Shromažďování informací o okruhu umožňuje obnovit vlastnosti dokumentu, jako jsou stopy tabulek, komentáře, titulky a stopy během HTML dokumentů nabíjení zpět do objektu Aspose.Words.Dokument.

Když jsou informace o kroužku exportovány jako -aw-* CSS vlastnosti příslušných prvků HTML.

Když , nezpůsobuje žádnou informaci, aby byl výstup do vyrobených soubor.

ExportShapesAsSvg

Zkontroluje, zda jsou uzly Aspose.Words.Drawing.Shape převedeny na SVG obrázky při ukládání na HTML, MHTML, EPUB nebo AZW3'.

public bool ExportShapesAsSvg { get; set; }

Hodnota nemovitosti

bool

Remarks

Pokud je tato možnost nastavená na , Aspose.Words.Drawing.Shape uzly jsou exportovány jako

ExportTextInputFormFieldAsText

Ovládá, jak jsou textové vstupní formuláře pole uložené do HTML nebo MHTML.Default hodnoty jsou ‘falešn’.

publicboolExportTextInputFormFieldAsText{get;set;}