DocumentSplitHeadingLevel

HtmlSaveOptions.DocumentSplitHeadingLevel property

Specifica il livello massimo di intestazioni a cui dividere il documento. Il valore predefinito è2 .

public int DocumentSplitHeadingLevel { get; set; }

Osservazioni

QuandoDocumentSplitCriteria includeHeadingParagraph e questa proprietà è impostata su un valore compreso tra 1 e 9, il documento verrà diviso in paragrafi formattati utilizzando Rubrica 1 ,Rubrica 2 ,Rubrica 3ecc. stili fino al livello di intestazione specificato.

Solo per impostazione predefinitaRubrica 1 ERubrica 2 i paragrafi causano la divisione del documento. Impostando questa proprietà su zero, il documento non verrà affatto diviso nei paragrafi di intestazione.

Esempi

Mostra come dividere un documento HTML di output in base alle intestazioni in più parti.

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

// Ogni paragrafo che formattiamo utilizzando lo stile "Intestazione" può fungere da intestazione.
// Ogni intestazione può anche avere un livello di intestazione, determinato dal numero del suo stile di intestazione.
// I titoli seguenti sono di livello 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");

// Crea un oggetto HtmlSaveOptions e imposta i criteri di suddivisione su "HeadingParagraph".
// Questi criteri divideranno il documento in paragrafi con stili "Intestazione" in diversi documenti più piccoli,
// e salva ciascun documento in un file HTML separato nel file system locale.
// Imposteremo anche il livello massimo di intestazione, che divide il documento in 2.
// Il salvataggio del documento lo dividerà nelle intestazioni dei livelli 1 e 2, ma non da 3 a 9.
HtmlSaveOptions options = new HtmlSaveOptions
{
    DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph,
    DocumentSplitHeadingLevel = 2
};

// Il nostro documento ha quattro titoli di livello 1 - 2. Uno di questi titoli non lo sarà
// un punto di divisione poiché si trova all'inizio del documento.
// L'operazione di salvataggio dividerà il nostro documento in tre posti, in quattro documenti più piccoli.
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());

Guarda anche

HtmlSaveOptions.DocumentSplitCriteria HtmlSaveOptions.Encoding