DocumentSplitHeadingLevel
Inhalt
[
Ausblenden
]HtmlSaveOptions.DocumentSplitHeadingLevel property
Gibt die maximale Überschriftenebene an, bei der das Dokument aufgeteilt werden soll. Der Standardwert ist2
.
public int DocumentSplitHeadingLevel { get; set; }
Bemerkungen
WannDocumentSplitCriteria
beinhaltetHeadingParagraph und diese Eigenschaft ist auf einen Wert zwischen 1 und 9 eingestellt, dann wird das Dokument in Absätze aufgeteilt, die mit formatiert sind.Überschrift 1 ,Überschrift 2 ,Überschrift 3usw. Stile bis zur angegebenen Überschriftenebene.
Standardmäßig nurÜberschrift 1 UndÜberschrift 2 Absätze führen dazu, dass das Dokument aufgeteilt wird. Wenn Sie diese Eigenschaft auf Null setzen, wird das Dokument bei Überschriftenabsätzen überhaupt nicht aufgeteilt.
Beispiele
Zeigt, wie ein ausgegebenes HTML-Dokument anhand von Überschriften in mehrere Teile aufgeteilt wird.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Jeder Absatz, den wir mit einem „Überschrift“-Stil formatieren, kann als Überschrift dienen.
// Jede Überschrift kann auch eine Überschriftenebene haben, die durch die Nummer ihres Überschriftenstils bestimmt wird.
// Die folgenden Überschriften beziehen sich auf die Ebenen 1–3.
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 1"];
builder.Writeln("Heading #1");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 2"];
builder.Writeln("Heading #2");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 3"];
builder.Writeln("Heading #3");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 1"];
builder.Writeln("Heading #4");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 2"];
builder.Writeln("Heading #5");
builder.ParagraphFormat.Style = builder.Document.Styles["Heading 3"];
builder.Writeln("Heading #6");
// Erstellen Sie ein HtmlSaveOptions-Objekt und legen Sie die Aufteilungskriterien auf „HeadingParagraph“ fest.
// Diese Kriterien teilen das Dokument an Absätzen mit dem Stil "Überschrift" in mehrere kleinere Dokumente auf,
// und speichern Sie jedes Dokument in einer separaten HTML-Datei im lokalen Dateisystem.
// Wir legen auch die maximale Überschriftenebene fest, die das Dokument in zwei Teile aufteilt.
// Beim Speichern des Dokuments wird es in Überschriften der Ebenen 1 und 2 aufgeteilt, nicht jedoch in Überschriften der Ebenen 3 bis 9.
HtmlSaveOptions options = new HtmlSaveOptions
{
DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph,
DocumentSplitHeadingLevel = 2
};
// Unser Dokument hat vier Überschriften der Ebenen 1 - 2. Eine dieser Überschriften wird nicht
// ein Teilungspunkt, da er sich am Anfang des Dokuments befindet.
// Der Speichervorgang teilt unser Dokument an drei Stellen in vier kleinere Dokumente auf.
doc.Save(ArtifactsDir + "HtmlSaveOptions.HeadingLevels.html", options);
doc = new Document(ArtifactsDir + "HtmlSaveOptions.HeadingLevels.html");
Assert.AreEqual("Heading #1", doc.GetText().Trim());
doc = new Document(ArtifactsDir + "HtmlSaveOptions.HeadingLevels-01.html");
Assert.AreEqual("Heading #2\r" +
"Heading #3", doc.GetText().Trim());
doc = new Document(ArtifactsDir + "HtmlSaveOptions.HeadingLevels-02.html");
Assert.AreEqual("Heading #4", doc.GetText().Trim());
doc = new Document(ArtifactsDir + "HtmlSaveOptions.HeadingLevels-03.html");
Assert.AreEqual("Heading #5\r" +
"Heading #6", doc.GetText().Trim());
Siehe auch
- class HtmlSaveOptions
- namensraum Aspose.Words.Saving
- Montage Aspose.Words