DocumentBuilderInsertParagraph Method

Inserts a paragraph break into the document.

Namespace:  Aspose.Words
Assembly:  Aspose.Words (in Aspose.Words.dll) Version: 20.7.0

Syntax

public Paragraph InsertParagraph()

Return Value

Type: Paragraph
The paragraph node that was just inserted. It is the same node as CurrentParagraph.

Remarks

Current paragraph formatting specified by the ParagraphFormat property is used.

Breaks the current paragraph in two. After inserting the paragraph, the cursor is placed at the beginning of the new paragraph.

Examples

Shows how to insert a paragraph into the document.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Specify font formatting
Font font = builder.Font;
font.Size = 16;
font.Bold = true;
font.Color = Color.Blue;
font.Name = "Arial";
font.Underline = Underline.Dash;

// Specify paragraph formatting
ParagraphFormat paragraphFormat = builder.ParagraphFormat;
paragraphFormat.FirstLineIndent = 8;
paragraphFormat.Alignment = ParagraphAlignment.Justify;
paragraphFormat.AddSpaceBetweenFarEastAndAlpha = true;
paragraphFormat.AddSpaceBetweenFarEastAndDigit = true;
paragraphFormat.KeepTogether = true;

// Using Writeln() ends the paragraph after writing and makes a new one, while Write() stays on the same paragraph
builder.Writeln("A whole paragraph.");

// We can use this flag to ensure that we're at the end of the document
Assert.True(builder.CurrentParagraph.IsEndOfDocument);

See Also