Document.InsertSection(DocumentPosition) Method

Inserts a new section into the document’s Document.Sections collection at a specified position.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v20.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.WindowsDesktop.RichEdit.Core

Declaration

C#

Section InsertSection(
    DocumentPosition pos
)

VB.NET

Function InsertSection(
    pos As DocumentPosition
) As Section

Parameters

Name	Type	Description
pos	DocumentPosition	A DocumentPosition object that specifies a position to insert a new section.

Returns

Type	Description
Section	A Section object that is the section in the document located before the newly inserted section.

Remarks

The code sample below shows how to insert continuous section break after the specific paragraph:

C#

Document document = server.Document;
document.LoadDocument("Documents\\Grimm.docx");
document.InsertSection(document.Paragraphs[4].Range.End);
Section insertedSection = document.GetSection(targetPosition);
insertedSection.StartType = SectionStartType.Continuous;

VB.NET

Dim document As Document = server.Document
document.LoadDocument("Documents\Grimm.docx")
document.InsertSection(document.Paragraphs(4).Range.[End])
Dim insertedSection As Section = document.GetSection(targetPosition)
insertedSection.StartType = SectionStartType.Continuous

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the InsertSection(DocumentPosition) method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

generating-table-of-contents-toc-practical-guide-e4138/CS/Form1.cs#L98

Document.EndUpdateCharacters(cp);
Document.InsertSection(field.Range.End);
field.Update();

how-to-generate-table-of-content-automatically-based-on-some-datasource-records-e5011/CS/WindowsFormsApplication1/Form1.cs#L56

richEditControl1.Document.EndUpdateCharacters(cp);
richEditControl1.Document.InsertSection(field.Range.End);
field.Update();

how-to-dynamically-generate-table-of-contents-by-adding-toc-field-with-different-nesting-l-t424524/CS/WindowsFormsApplication1/TOCHelpers.cs#L94

Field field = doc.Fields.Create(documentHeader.End, "TOC " + switches);
doc.InsertSection(field.Range.End);
field.Update();

page-layout-simple-example-t553072/CS/PageLayout/Form1.cs#L26

DocumentPosition position = document.Paragraphs[12].Range.End;
Section section = document.InsertSection(position);

wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/SearchAndReplaceActions.cs#L13

document.LoadDocument("Documents//Grimm.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml);
document.InsertSection(document.Range.Start);
// Specify a regular expression that will find all six letter words.

VB.NET

generating-table-of-contents-toc-practical-guide-e4138/VB/Form1.vb#L121

Document.EndUpdateCharacters(cp)
Document.InsertSection(field.Range.End)
field.Update()

how-to-generate-table-of-content-automatically-based-on-some-datasource-records-e5011/VB/WindowsFormsApplication1/Form1.vb#L56

richEditControl1.Document.EndUpdateCharacters(cp)
richEditControl1.Document.InsertSection(field.Range.End)
field.Update()

how-to-dynamically-generate-table-of-contents-by-adding-toc-field-with-different-nesting-l-t424524/VB/WindowsFormsApplication1/TOCHelpers.vb#L98

Dim field As Field = doc.Fields.Create(documentHeader.End, "TOC " & switches)
doc.InsertSection(field.Range.End)
field.Update()

page-layout-simple-example-t553072/VB/PageLayout/Form1.vb#L24

Dim position As DocumentPosition = document.Paragraphs(12).Range.End
Dim section As Section = document.InsertSection(position)

wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/SearchAndReplaceActions.vb#L10

document.LoadDocument("Documents//Grimm.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml)
document.InsertSection(document.Range.Start)
' Specify a regular expression that will find all six letter words.