Class HtmlSaveOptions

A név: Aspose.Words.Saving Összefoglaló: Aspose.Words.dll (25.4.0)

Használható további opciók meghatározására, amikor egy dokumentumot tárol aAz ASPOSE.Words.SaveFormat.Html, az ASPOSE.Words.SaveFormat.Mhtml, az ASPOSE.Words.SaveFormat.EpubAspose.Words.SaveFormat.Azw3 vagy Aspose.Words.SaveFormat.Mobi formátum.

Ha többet szeretne megtudni, látogasson el Specify Save Options A dokumentációs cikk.

public class HtmlSaveOptions : SaveOptions

Inheritance

object ← SaveOptions ← HtmlSaveOptions

Örökletes tagok

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()

Kezdődik egy új példány ebben az osztályban, amelyet egy dokumentum mentésére lehet használniaz Aspose.Words.SaveFormat.Html formátumban.

public HtmlSaveOptions()

HtmlSaveOptions(SaveFormat)

Kezdődik egy új példány ebben az osztályban, amelyet egy dokumentum mentésére lehet használniaz Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Aspose.Words.SaveFormat.Azw3 vagy Aspose.Words.SaveFormat.Mobi formátum.

public HtmlSaveOptions(SaveFormat saveFormat)

Parameters

saveFormat SaveFormat

Lehet Aspose.Words.SaveFormat.Html, Aspose.Words.SaveFormat.Mhtml, Aspose.Words.SaveFormat.Epub,Az Aspose.Words.SaveFormat.Azw3 vagy az Aspose.Words.SaveFormat.Mobi.

Properties

AllowNegativeIndent

Meghatározza, hogy a negatív bal és jobb bekezdések normalizálódnak-e, ha HTML, MHTML vagy EPUB-ra mentünk.

public bool AllowNegativeIndent { get; set; }

ingatlan értéke

bool

Remarks

Ha a negatív indent nem megengedett, akkor nulla marginként exportálódik a HTML-be. Ha a negatív indent megengedett, akkor egy bekezdés részben megjelenhet a böngésző ablakán kívül.

CssClassNamePrefix

Megadja a prefixet, amely hozzáadódik az összes CSS osztálynevhez.Az alapértelmezett érték egy üres sor, és a generált CSS osztálynevek nem rendelkeznek közös előfizetéssel.

public string CssClassNamePrefix { get; set; }

ingatlan értéke

string

Remarks

Ha ez az érték nem üres, az Aspose.Words által generált összes CSS-osztály a megadott előfizetéssel kezdődik.Ez hasznos lehet például, ha a létrehozott dokumentumokhoz személyre szabott CSS-t ad, és az osztálynevek konfliktusát meg akarja akadályozni.

Ha az érték nem vagy üres, akkor érvényes CSS azonosítónak kell lennie.

Exceptions

ArgumentException

Az érték nem üres, és nem érvényes CSS azonosító.

CssSavingCallback

Lehetővé teszi, hogy ellenőrizze, hogyan mentett CSS stílusok, amikor egy dokumentum mentett HTML, MHTML vagy EPUB.

public ICssSavingCallback CssSavingCallback { get; set; }

ingatlan értéke

ICssSavingCallback

CssStyleSheetFileName

Megadja az útvonalat és a Cascading Style Sheet (CSS) fájl nevét, amikor egy dokumentumA HTML-re exportálható.Default egy üres szalag.

public string CssStyleSheetFileName { get; set; }

ingatlan értéke

string

Remarks

Ez a tulajdonság csak akkor működik, ha egy dokumentumot HTML formátumban mentünk, és külső CSS stíluslapot kérünk a Aspose.Words.Saving.HtmlSaveOptions.CssStyleSheetType használatával.

Ha ez a tulajdonság üres, a CSS fájlt ugyanazon a mappába és ugyanazon a nevével, mint a HTML dokumentum, de a “css” kiterjesztés.

Ha ebben a tulajdonságban csak útvonal, de nincs fájl neve megadott, a CSS fájl a megadott mappába kerül mentésre, és ugyanazt a nevet kapja, mint a HTML dokumentum, de a “css” kiterjesztéssel.

Ha az e tulajdonság által meghatározott mappát nem létezik, akkor a CSS fájl mentése előtt automatikusan jön létre.

Egy másik módja annak, hogy egy mappát, ahol a külső CSS fájl mentett használja a Aspose.Words.Saving.HtmlSaveOptions.ResourceFolder.

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

CssStyleSheetType

Meghatározza, hogy a CSS (Cascading Style Sheet) stílusok hogyan exportálódnak HTML, MHTML vagy EPUB.Az alapértelmezett érték az Aspose.Words.Saving.CssStyleSheetType.Inline HTML/MHTML ésAz ASPOSE.Words.Saving.CssStyleSheetType.External az EPUB számára.

public CssStyleSheetType CssStyleSheetType { get; set; }

ingatlan értéke

CssStyleSheetType

Remarks

A CSS stíluslap mentése egy külső fájlba csak akkor támogatható, ha HTML-re ment. Amikor az egyik tartályformátumra exportál (EPUB vagy MHTML) és a Aspose.Words.Saving.CssStyleSheetType.External, a CSS-fájlt a kimeneti csomagba kapszulálják.

Lásd még

HtmlSaveOptions . CssStyleSheetFileName

DocumentPartSavingCallback

Lehetővé teszi, hogy ellenőrizze, hogy a dokumentumrészek hogyan kerülnek mentésre, amikor a dokumentumot HTML-re vagy EPUB-ra mentjük.

public IDocumentPartSavingCallback DocumentPartSavingCallback { get; set; }

ingatlan értéke

IDocumentPartSavingCallback

DocumentSplitCriteria

Meghatározza, hogy a dokumentumot hogyan kell felosztani az Aspose.Words.SaveFormat.Html-re való mentés során,Aspose.Words.SaveFormat.Epub vagy Aspose.Words.SaveFormat.Azw3 formátum.Az alapértelmezett Aspose.Words.Saving.DocumentSplitCriteria.Nincs HTML ésAspose.Words.Saving.DocumentSplitCriteria.HeadingParagraph for EPUB and AZW3.

public DocumentSplitCriteria DocumentSplitCriteria { get; set; }

ingatlan értéke

DocumentSplitCriteria

Remarks

Általában egy dokumentumot szeretne menteni a HTML-re egyetlen fájlként. De bizonyos esetekben előnyös, hogy a kimenetet több kisebb HTML oldalra osztja. A HTML formátumban mentésekor ezeket az oldalakat egyedi szoftverek vagy áramlásoknak adják ki.

A dokumentumot nem lehet megosztani az MHTML formátumban történő mentésekor.

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

DocumentSplitHeadingLevel

Határozza meg a címek maximális szintjét, amelyre osztja meg a dokumentumot.Az alapértelmezett érték ‘2’.

public int DocumentSplitHeadingLevel { get; set; }

ingatlan értéke

int

Remarks

Amikor a Aspose.Words.Saving.HtmlSaveOptions.DocumentSplitCriteria tartalmazza a Wl26.Megmentesítve a dokumentumSplatcritéria.HeadingParagraph és ez a tulajdonság értéke 1 és 9 között van beállítva, az anyagot a formázott bekezdésekbe osztják , stb. stílusok a megadott címszintig.

Alapértelmezés szerint csak és a bekezdések okozzák a dokumentum megosztását.Ez a tulajdonság nullára történő elhelyezése azt eredményezi, hogy a Dokumentumot nem osztják meg a felsorolt bekezdésekben.

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

Encoding

Specifikálja a kódolást a HTML, MHTML vagy EPUB-ba történő exportálás során.Az alapértelmezett érték az ‘új UTF8Encoding(false)’ (UTF-8 BOM nélkül).

public Encoding Encoding { get; set; }

ingatlan értéke

Encoding

ExportCidUrlsForMhtmlResources

Meghatározza, hogy használja-e a CID (Content-ID) URL-eket a hivatkozási erőforrásokhoz (képek, betűtípusok, CSS) az MHTML dokumentumokban.

public bool ExportCidUrlsForMhtmlResources { get; set; }

ingatlan értéke

bool

Remarks

Ez az opció csak az MHTML-re mentett dokumentumokat érinti.

Alapértelmezés szerint az MHTML dokumentumokban található erőforrások fájlnevével (például “image.png”), amelyek a MIME részek “Content-Location” címkéivel összhangban vannak.

Ez az opció lehetővé teszi az alternatív módszert, ahol az erőforrás-fájlokra vonatkozó hivatkozások CID (Content-ID) URL-ek (például „cid:image.png”) formájában kerülnek megírásra, és a „Content-ID” címkékkel összhangban vannak.

Elméletileg nem szabad különbséget tenni a két referenciamódszer között, és mindegyikük jól működik bármely böngészőben vagy e-mail ügynökben. A gyakorlatban azonban egyes ügynökök nem tudnak fájlnév alapján forrásokat rögzíteni. Ha a böngésző vagy e-mail ügynök nem hajlandó feltölteni az MTHML dokumentumban szereplő forrásokat (nem jeleníti meg a képeket vagy nem terhel CSS stílusokat), próbálja ki exportálni a dokumentumot CID URL-ekkel.

ExportDocumentProperties

Meghatározza, hogy a beépített és személyre szabott dokumentum tulajdonságokat exportálja-e a HTML, MHTML vagy EPUB-ba.Az alapértelmezett érték hamis.

public bool ExportDocumentProperties { get; set; }

ingatlan értéke

bool

ExportDropDownFormFieldAsText

Ellenőrizze, hogy a drop-down formanyomtatvány mezők mentése HTML vagy MHTML.Az alapértelmezett érték hamis.

public bool ExportDropDownFormFieldAsText { get; set; }

ingatlan értéke

bool

Remarks

Amikor be van állítva, a drop-down form mezők exportálása normál szövegként. amikor a drop-down form mezők exportálása SELECT elemként HTML-ben.

Az EPUB-ra történő exportálás során a text drop-down formanyomtatvány mezők mindig szövegként tárolódnak ennek a formátumnak a követelményeinek köszönhetően.

ExportFontResources

Meghatározza, hogy a betűtípus erőforrásokat exportálni kell-e HTML, MHTML vagy EPUB.Default ‘való’.

public bool ExportFontResources { get; set; }

ingatlan értéke

bool

Remarks

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

Ha a Aspose.Words.Saving.HtmlSaveOptions.ExportFontResources be van állítva , a fő HTML dokumentum minden betűtípusra hivatkozik a CSS 3-on keresztül, és a betűt külön fájlként adják ki.

Ha Aspose.Words.Saving.HtmlSaveOptions.ExportFontsAsBase64 be van állítva , a betűtípusok nem kerülnek mentésre külön fájlok.

Ha font erőforrásokat exportál, font licenc kérdéseit kell figyelembe venni. A szerzők, akik szeretnék használni bizonyos fontok keresztül egy letölthető font mechanizmus mindig óvatosan ellenőrizni, hogy a szándékos használata a font engedély hatálya alá tartozik. Sok kereskedelmi font jelenleg nem teszi lehetővé a webes letöltése a betűk bármilyen formában. Licenc megállapodások, amelyek fedezik néhány betűt kifejezetten megjegyzi, a használat a szabályok révén a CSS stílusú lapok nem engedélyezett.

HtmlSaveOptions.FontResourcesTáblázatSizeThreshold

ExportFontsAsBase64

Meghatározza, hogy a betűtípus erőforrásokat be kell-e illeszkedni a HTML-be a Base64 kódolásban.Default ‘való’.

public bool ExportFontsAsBase64 { get; set; }

ingatlan értéke

bool

Remarks

Alapértelmezés szerint a betűtípusokat külön fájlokra írják. ha ezt az opciót beállítják, a betűtípusokat a Base64 kódolásban a dokumentum CSS-ébe fogják beépíteni.

ExportHeadersFootersMode

Meghatározza, hogy a fejjelek és lábjelek hogyan származnak HTML, MHTML vagy EPUB-ra.Az alapértelmezett érték az Aspose.Words.Saving.ExportHeadersFootersMode.PerSection HTML/MHTMLés Aspose.Words.Saving.ExportHeadersFootersMode.Nincs az EPUB számára.

public ExportHeadersFootersMode ExportHeadersFootersMode { get; set; }

ingatlan értéke

ExportHeadersFootersMode

Remarks

Nehéz értelmesen kiadni a HTML címkéket és lábnyomokat, mert a HTML nem oldalsó.

Ha ez a tulajdonság Aspose.Words.Saving.ExportHeadersFootersMode.PerSection, Aspose.Words exportálja csak az elsődleges fejek és lábak a kezdetén és végén minden szakaszban.

Amikor az Aspose.Words.Saving.ExportHeadersFootersMode.FirstSectionHeaderLastSectFooter csak az első fő fejjel és az utolsó fő lábjel (beleértve a korábbihoz kapcsolódó) exportálódnak.

A fejek és lábak exportját kizárhatja azáltal, hogy ezt a tulajdonságot az Aspose.Words.Saving.ExportHeadersFootersMode.None címre állítja be.

ExportImagesAsBase64

Megadja, hogy a képeket a Base64 formátumban mentették-e a HTML, MHTML vagy EPUB kimenetelhez.Az alapértelmezés hamis.

public bool ExportImagesAsBase64 { get; set; }

ingatlan értéke

bool

Remarks

Amikor ezt a tulajdonságot a képekre állítják be, az adatok közvetlenül az elemekbe exportálódnak, és külön fájlokat nem hoznak létre.

ExportLanguageInformation

Megjelöli, hogy a nyelvi információkat exportálják-e HTML, MHTML vagy EPUB-ra.Az alapértelmezés hamis.

public bool ExportLanguageInformation { get; set; }

ingatlan értéke

bool

Remarks

Amikor ez a tulajdonság be van állítva Aspose.Words kimeneti HTML attribútum a dokumentum elemeit, amelyek meghatározzák a nyelvet.

ExportListLabels

Ellenőrizze, hogy a lista címkék hogyan jönnek HTML, MHTML vagy EPUB.Az alapértelmezett érték az Aspose.Words.Saving.ExportListLabels.Auto.

public ExportListLabels ExportListLabels { get; set; }

ingatlan értéke

ExportListLabels

ExportOriginalUrlForLinkedImages

Megjelöli, hogy az eredeti URL-t a kapcsolódó képek URL-jeként kell-e használni.Az alapértelmezett értéke hamis.

public bool ExportOriginalUrlForLinkedImages { get; set; }

ingatlan értéke

bool

Remarks

Ha az értéket az Aspose.Words.Drawing.ImageData.SourceFullName értéket használja a linkelt képek URL-je, és a linkelt képek nem kerülnek a dokumentum mappájába vagy az Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder.

Ha az értéket a kapcsolódó képekre állítják be, a dokumentum mappájába vagy a Aspose.Words.Saving.HtmlSaveOptions.ImagesFolder és az egyes kapcsolódott képek URL-jei attól függően alakulnak ki, hogy melyik dokumentumból származik, Wl26.Visszatérítést kapunk.

ExportPageMargins

Meghatározza, hogy az oldalmargins exportálható-e HTML, MHTML vagy EPUB.Default ‘való’.

public bool ExportPageMargins { get; set; }

ingatlan értéke

bool

Remarks

Az Aspose.Words nem jeleníti meg az oldalsó marginok tartományát alapértelmezés szerint.Ha bármely elemet teljesen vagy részben a dokumentum szélén rögzítenek, a megjelenített terület meghosszabbítható aEz az opció.

ExportPageSetup

Meghatározza, hogy az oldal beállítása exportálódik-e HTML, MHTML vagy EPUB-ra.Az alapértelmezés hamis.

public bool ExportPageSetup { get; set; }

ingatlan értéke

bool

Remarks

Minden Aspose.Words.Section az Aspose.Words dokumentummal rendelkezik oldal beállítási információkat az Aspose.Words.PageSetup osztály. Amikor exportál egy dokumentum HTML formátumban lehet, hogy meg kell tartani ezt az információt további használatra. Különösen, oldal beállítása fontos lehet a rendering a paged média (nyomtatás) vagy a későbbi konverzió a szülői Microsoft Word fájl formátumok (DOCX, DOC, RTF, WML).

A legtöbb esetben a HTML olyan böngészőkben való megtekintés céljából készült, ahol a weboldalt nem végezzük el. Ez a funkció alapértelmezés szerint inaktív.

ExportRelativeFontSize

Meghatározza, hogy a betűméreteket relatív egységekben kell-e adni, ha HTML, MHTML vagy EPUB-ra mentjük.Az alapértelmezés hamis.

public bool ExportRelativeFontSize { get; set; }

ingatlan értéke

bool

Remarks

Számos meglévő dokumentumban (HTML, IDPF EPUB) a betűtípus mérete relatív egységekben van meghatározva. Ez lehetővé teszi az alkalmazások számára, hogy szövegméretét módosítsák, amikor megtekintheti / feldolgozza a dokumentumait. Például a Microsoft Internet Explorer “View->Text Size” almennyel rendelkezik, az Adobe Digital Editions két gombot tartalmaz: növelje / csökkenti a szöveges méretet. Ha várja ezt a funkciót, akkor állítsa be a Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize tulajdonságát .

Aspose A Words dokumentummodell csak abszolút betűméretű egységekkel rendelkezik és működik.A relatív egységek további logikát igényelnek, hogy néhány kezdeti (szabványos) méretből újra kiszámolhassanak.Az alapértelmezés szerint a szöveg stílusának betéti méretét.Például, ha 12pt betűt tartalmaz, és néhány szöveg 18pt, akkor a HTML-hez kapcsolódó kimenetel lesz.

Ha ezt a lehetőséget engedélyezik, a dokumentum elemek nem szöveges lesz még abszolút méretű. Ezenkívül néhány szöveg kapcsolódó attribútumok kifejeződhet teljesen. Különösen, vonal spacing meghatározott “pontos” szabály okozhat nem kívánt eredményeket, amikor skálázza a szöveget. Így a forráskodok kell megfelelően tervezett és tesztelt, ha exportál a Aspose.Words.Saving.HtmlSaveOptions.ExportRelativeFontSize beállított .

ExportRoundtripInformation

Meghatározza, hogy írja-e a körforgásos információt, amikor HTML, MHTML vagy EPUB.Az alapértelmezett érték “valódi” HTML és “valódi” MHTML és EPUB.

public bool ExportRoundtripInformation { get; set; }

ingatlan értéke

bool

Remarks

A körforgásos információk megtakarítása lehetővé teszi a dokumentum tulajdonságainak helyreállítását, mint például a lapállomások, a megjegyzések, a fejezetek és a lábak a HTML dokumentumok feltöltésének során egy Aspose.Words.Document objektumba.

Amikor a körforgásos információt a megfelelő HTML elemek -aw-* CSS tulajdonságaként exportálják.

Amikor , nem okozza a körforgásos információt, hogy a termelett fájlokat.

ExportShapesAsSvg

Ellenőrizze, hogy az Aspose.Words.Drawing.Shape csomópontokat a HTML, MHTML, EPUB vagy AZW3 mentésekor SVG képekké alakítják-e.

public bool ExportShapesAsSvg { get; set; }

ingatlan értéke

bool

Remarks

Ha ez az opció be van állítva, a Aspose.Words.Drawing.Shape csomópontokat

ExportTextInputFormFieldAsText

Ellenőrizze, hogy a szöveges beviteli űrlap mezők mentése HTML vagy MHTML.Az alapértelmezett érték “hamis”.

publicboolExportTextInputFormFieldAsText{get;set;}