DocumentSplitHeadingLevel

HtmlSaveOptions.DocumentSplitHeadingLevel property

Especifica el nivel máximo de encabezados en el que se dividirá el documento. El valor predeterminado es2 .

public int DocumentSplitHeadingLevel { get; set; }

Observaciones

CuandoDocumentSplitCriteria incluyeHeadingParagraph y esta propiedad se establece en un valor de 1 a 9, el documento se dividirá en párrafos formateados usando Título 1 ,Título 2 ,Título 3etc. estilos hasta el nivel de encabezado especificado.

De forma predeterminada, soloTítulo 1 yTítulo 2 Los párrafos hacen que el documento se divida. Establecer esta propiedad en cero hará que el documento no se divida en absoluto en los párrafos de encabezado.

Ejemplos

Muestra cómo dividir un documento HTML de salida por encabezados en varias partes.

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

//Cada párrafo que formateamos utilizando un estilo "Encabezado" puede servir como encabezado.
// Cada encabezado también puede tener un nivel de encabezado, determinado por el número de su estilo de encabezado.
//Los títulos a continuación son de los niveles 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");

// Cree un objeto HtmlSaveOptions y establezca el criterio de división en "HeadingParagraph".
// Estos criterios dividirán el documento en párrafos con estilos de "Encabezado" en varios documentos más pequeños,
// y guarde cada documento en un archivo HTML separado en el sistema de archivos local.
// También estableceremos el nivel de encabezado máximo, que divide el documento en 2.
//Al guardar el documento se dividirá en los encabezados de los niveles 1 y 2, pero no del 3 al 9.
HtmlSaveOptions options = new HtmlSaveOptions
{
    DocumentSplitCriteria = DocumentSplitCriteria.HeadingParagraph,
    DocumentSplitHeadingLevel = 2
};

//Nuestro documento tiene cuatro encabezados de niveles 1 - 2. Uno de esos encabezados no será
// un punto de división ya que está al principio del documento.
// La operación de guardar dividirá nuestro documento en tres lugares, en cuatro documentos más pequeños.
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());

Ver también

HtmlSaveOptions.DocumentSplitCriteria HtmlSaveOptions.Encoding