ExportPageSetup

HtmlSaveOptions.ExportPageSetup property

Gibt an, ob die Seiteneinrichtung in HTML, MHTML oder EPUB exportiert wird. Standard istFALSCH .

public bool ExportPageSetup { get; set; }

Bemerkungen

JedeSection im Aspose.Words-Dokumentmodell bietet Informationen zur Seiteneinrichtung überPageSetup Klasse. Wenn Sie ein Dokument ins HTML-Format exportieren, benötigen Sie diese Informationen möglicherweise für die spätere Verwendung. Insbesondere kann die Seiteneinrichtung für die Darstellung auf seitenweise Medien (Druck) oder die anschließende Konvertierung in die nativen Microsoft Word-Dateiformate (DOCX, DOC, RTF, WML) wichtig sein.

In den meisten Fällen ist HTML für die Anzeige in Browsern vorgesehen, in denen keine Seitennummerierung erfolgt. Daher ist diese Funktion standardmäßig deaktiviert.

Beispiele

Zeigt, wie Sie entscheiden, ob die Abschnittsstruktur/Seiteneinrichtungsinformationen beim Speichern im HTML-Format beibehalten werden sollen.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Write("Section 1");
builder.InsertBreak(BreakType.SectionBreakNewPage);
builder.Write("Section 2");

PageSetup pageSetup = doc.Sections[0].PageSetup;
pageSetup.TopMargin = 36.0;
pageSetup.BottomMargin = 36.0;
pageSetup.PaperSize = PaperSize.A5;

// Beim Speichern des Dokuments im HTML-Format können wir ein SaveOptions-Objekt übergeben
// um zu entscheiden, ob die Seiteneinrichtungseinstellungen beibehalten oder verworfen werden sollen.
// Wenn wir das Flag „ExportPageSetup“ auf „true“ setzen, enthält das ausgegebene HTML-Dokument unsere Seiteneinrichtungskonfiguration.
// Wenn wir das Flag "ExportPageSetup" auf "false" setzen, werden beim Speichern unsere Seiteneinrichtungseinstellungen verworfen
// für den ersten Abschnitt, und beide Abschnitte werden identisch aussehen.
HtmlSaveOptions options = new HtmlSaveOptions { ExportPageSetup = exportPageSetup };

doc.Save(ArtifactsDir + "HtmlSaveOptions.ExportPageSetup.html", options);

string outDocContents = File.ReadAllText(ArtifactsDir + "HtmlSaveOptions.ExportPageSetup.html");

if (exportPageSetup)
{
    Assert.True(outDocContents.Contains(
        "<style type=\"text/css\">" +
            "@page Section_1 { size:419.55pt 595.3pt; margin:36pt 70.85pt; -aw-footer-distance:35.4pt; -aw-header-distance:35.4pt }" +
            "@page Section_2 { size:612pt 792pt; margin:70.85pt; -aw-footer-distance:35.4pt; -aw-header-distance:35.4pt }" +
            "div.Section_1 { page:Section_1 }div.Section_2 { page:Section_2 }" +
        "</style>"));

    Assert.True(outDocContents.Contains(
        "<div class=\"Section_1\">" +
            "<p style=\"margin-top:0pt; margin-bottom:0pt\">" +
                "<span>Section 1</span>" +
            "</p>" +
        "</div>"));
}
else
{
    Assert.False(outDocContents.Contains("style type=\"text/css\">"));

    Assert.True(outDocContents.Contains(
        "<div>" +
            "<p style=\"margin-top:0pt; margin-bottom:0pt\">" +
                "<span>Section 1</span>" +
            "</p>" +
        "</div>"));
}

Siehe auch