Click or drag to resize

DocumentBuilderInsertParagraph Method

Inserts an Paragraph at the current position.

Namespace: SautinSoft.Document
Assembly: SautinSoft.Document (in SautinSoft.Document.dll) Version: 2024.7.18
Syntax
public Paragraph InsertParagraph(
	string text
)

Parameters

text  String
The string to insert into the paragraph.

Return Value

Paragraph
The reference to the just inserted Paragraph object.
Example

See Developer Guide: How to insert a paragraph with text and specify the paragraph formatting using DocumentBuilder

How to insert a paragraph with text and specify the paragraph formatting using DocumentBuilder in C#
using SautinSoft.Document;

namespace Example
{
    class Program
    {
        static void Main(string[] args)
        {
            // Get your free 100-day key here:   
            // https://sautinsoft.com/start-for-free/
            InsertingParagraph();
        }
        /// <summary>
        /// Create a document and insert a paragraph using DocumentBuilder.
        /// </summary>
        /// <remarks>
        /// Details: https://www.sautinsoft.com/products/document/help/net/developer-guide/documentbuilder-inserting-paragraph.php
        /// </remarks>

        static void InsertingParagraph()
        {
            // Create a new document.
            DocumentCore dc = new DocumentCore();
            // Initialize DocumentBuilder with the created document.
            DocumentBuilder db = new DocumentBuilder(dc);

            // Insert a new paragraph.
            db.Writeln("This is an example of a paragraph inserted using DocumentBuilder.");
            db.CharacterFormat.FontName = "Verdana";
            db.CharacterFormat.Size = 16.5f;
            db.CharacterFormat.AllCaps = true;
            db.CharacterFormat.Italic = true;
            db.CharacterFormat.FontColor = Color.Orange;
            db.ParagraphFormat.LeftIndentation = 30;
            db.Writeln("This paragraph has a Left Indentation of 30 points.");
            db.ParagraphFormat.SpecialIndentation = 50;
            db.Writeln("This paragraph retains the Left Indentation of 30 points and is supplemented by the first-line indent of 50 points.");

            // Save the document.
            dc.Save("Example.docx");

            // Important for Linux: Install MS Fonts
            // sudo apt install ttf-mscorefonts-installer -y

            // Open the result for demonstration purposes.
            System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo("Example.docx") { UseShellExecute = true });
        }
    }
}
How to insert a paragraph with text and specify the paragraph formatting using DocumentBuilder in VB.Net
Imports System
Imports SautinSoft.Document
Imports System.Text


Namespace Example
    Friend Class Program
        Shared Sub Main(ByVal args() As String)
            InsertingParagraph()
        End Sub
                ''' Get your free 100-day key here:   
                ''' https://sautinsoft.com/start-for-free/
        ''' <summary>
        ''' Create a document and insert a paragraph using DocumentBuilder.
        ''' </summary>
        ''' <remarks>
        ''' Details: https://www.sautinsoft.com/products/document/help/net/developer-guide/documentbuilder-inserting-paragraph.php
        ''' </remarks>

        Private Shared Sub InsertingParagraph()
            Dim dc As New DocumentCore()
            Dim db As New DocumentBuilder(dc)

            Dim resultPath As String = "result.docx"

            ' Insert the formatted text into the document using DocumentBuilder.
            db.CharacterFormat.FontName = "Verdana"
            db.CharacterFormat.Size = 16.5F
            db.CharacterFormat.AllCaps = True
            db.CharacterFormat.Italic = True
            db.CharacterFormat.FontColor = Color.Orange
            db.ParagraphFormat.LeftIndentation = 30
            db.Writeln("This paragraph has a Left Indentation of 30 points.")
            db.ParagraphFormat.SpecialIndentation = 50
            db.Writeln("This paragraph retains the Left Indentation of 30 points and is supplemented by the first-line indent of 50 points.")

            ' This method will clear all directly set formatting values.
            db.ParagraphFormat.ClearFormatting()
            db.CharacterFormat.ClearFormatting()
            db.Write("All directly set text and paragraph formatting values were cleared using DocumentBuilder.")

            ' Save the document to the file in DOCX format.
            dc.Save(resultPath)

            ' Open the result for demonstration purposes.
            System.Diagnostics.Process.Start(New System.Diagnostics.ProcessStartInfo(resultPath) With {.UseShellExecute = True})
        End Sub
    End Class
End Namespace
See Also