DocumentSplitHeadingLevel

HtmlSaveOptions.DocumentSplitHeadingLevel property

Spécifie le niveau maximum de titres auquel diviser le document. La valeur par défaut est2 .

public int DocumentSplitHeadingLevel { get; set; }

Remarques

QuandDocumentSplitCriteria comprendHeadingParagraph et que cette propriété est définie sur une valeur comprise entre 1 et 9, le document sera divisé en paragraphes formatés à l’aide de Titre 1 ,Titre 2 ,Titre 3etc. styles jusqu’au niveau de titre spécifié.

Par défaut, seulementTitre 1 etTitre 2 Les paragraphes entraînent la division du document. Si cette propriété est définie sur zéro, le document ne sera pas du tout divisé en paragraphes d’en-tête.

Exemples

Montre comment diviser un document HTML de sortie par titres en plusieurs parties.

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

// Chaque paragraphe que nous formatons en utilisant un style "Titre" peut servir de titre.
// Chaque titre peut également avoir un niveau de titre, déterminé par le numéro de son style de titre.
// Les titres ci-dessous sont des niveaux 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");

// Créez un objet HtmlSaveOptions et définissez les critères de partage sur "HeadingParagraph".
// Ces critères diviseront le document en paragraphes avec des styles "Titre" en plusieurs documents plus petits,
// et enregistrez chaque document dans un fichier HTML distinct dans le système de fichiers local.
// Nous définirons également le niveau de titre maximum, qui divise le document en 2.
// L'enregistrement du document le divisera en en-têtes de niveaux 1 et 2, mais pas en 3 à 9.
HtmlSaveOptions options = new HtmlSaveOptions
{
    DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph,
    DocumentSplitHeadingLevel = 2
};

// Notre document comporte quatre rubriques de niveaux 1 à 2. L'une de ces rubriques ne sera pas
// un point de partage puisqu'il se trouve au début du document.
// L'opération de sauvegarde divisera notre document à trois endroits, en quatre documents plus petits.
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());

Voir également

HtmlSaveOptions.DocumentSplitCriteria HtmlSaveOptions.Encoding