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.v19.1.Core.dll

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

To get a newly inserted section, use the following code:

C#

richEditControl.Document.InsertSection(pos);
DevExpress.XtraRichEdit.API.Native.Section sIns = richEditControl.Document.GetSection(pos);

VB.NET

richEditControl.Document.InsertSection(pos)
Dim sIns As DevExpress.XtraRichEdit.API.Native.Section = richEditControl.Document.GetSection(pos)

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#L97

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-t213968/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#L116

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-t213968/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.