ReadOnlyParagraphCollection.Get(DocumentPosition) Method

Gets a paragraph which contains the specified position.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v19.1.Core.dll

Declaration

C#

Paragraph Get(
    DocumentPosition pos
)

VB.NET

Function Get(
    pos As DocumentPosition
) As Paragraph

Parameters

Name	Type	Description
pos	DocumentPosition	A DocumentPosition for which an encompassed paragraph is obtained.

Returns

Type	Description
Paragraph	A Paragraph object.

Remarks

The Get method returns a Paragraph object which encompasses the specified position.

The method can be accessed using the RichEditControl.Document.Paragraphs.Get notation.

Note

If you operate with a selection range, the Get method should be enclosed within a DocumentRange.BeginUpdateDocument - DocumentRange.EndUpdateDocument method pair. Otherwise, an incorrect document model might be selected, resulting in an exception “Error: specified document position or range belongs to other document or subdocument” being thrown.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Get(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#

table-api-how-to-create-a-multiplication-table-in-code-e3231/CS/Table_API_Example/Form1.cs#L96

tr.FirstCell.BackgroundColor = Color.Empty;
doc.Paragraphs.Get(tr.FirstCell.ContentRange.Start).Style =
    doc.ParagraphStyles["MyTableCaptionStyle"];

subdocument-essentials-simple-examples-e2265/CS/SubDocumentExample/Form1.cs#L67

SubDocument doc = pos.BeginUpdateDocument();
Paragraph par = doc.Paragraphs.Get(pos);
DocumentPosition newPos = doc.CreatePosition(par.Range.End.ToInt() - 1);

document-layout-api-practical-usage-t266080/CS/WindowsFormsApplication1/DocumentLayoutHelper/DocumentElementLayoutHelper.cs#L24

int currentParagraphIndex = currentDocument.Paragraphs.ToList().IndexOf(currentDocument.Paragraphs.Get(currentDocument.CreatePosition(currentTextBlock.Range.Start)));
returnedInformation += String.Format("Paragrpah index: {0}\r\n", currentParagraphIndex + 1);

wpf-richedit-document-api-t213968/CS/DXRichEditControlAPISample/CodeExamples/RangeActions.cs#L79

SubDocument doc = pos.BeginUpdateDocument();
Paragraph par = doc.Paragraphs.Get(pos);
DocumentPosition newPos = doc.CreatePosition(par.Range.End.ToInt() - 1);

winforms-richedit-document-api-e5219/CS/RichEditAPISample/CodeExamples/Range.cs#L79

SubDocument doc = pos.BeginUpdateDocument();
Paragraph par = doc.Paragraphs.Get(pos);
DocumentPosition newPos = doc.CreatePosition(par.Range.End.ToInt() - 1);

VB.NET

table-api-how-to-create-a-multiplication-table-in-code-e3231/VB/Table_API_Example/Form1.vb#L90

    tr.FirstCell.BackgroundColor = Color.Empty
    doc.Paragraphs.Get(tr.FirstCell.ContentRange.Start).Style = doc.ParagraphStyles("MyTableCaptionStyle")
End If

subdocument-essentials-simple-examples-e2265/VB/SubDocumentExample/Form1.vb#L62

Dim doc As SubDocument = pos.BeginUpdateDocument()
Dim par As Paragraph = doc.Paragraphs.Get(pos)
Dim newPos As DocumentPosition = doc.CreatePosition(par.Range.End.ToInt() - 1)

document-layout-api-practical-usage-t266080/VB/WindowsFormsApplication1/DocumentLayoutHelper/DocumentElementLayoutHelper.vb#L27

Dim currentParagraphIndex As Integer = currentDocument.Paragraphs.ToList().IndexOf(currentDocument.Paragraphs.Get(currentDocument.CreatePosition(currentTextBlock.Range.Start)))
returnedInformation &= String.Format("Paragrpah index: {0}" & Constants.vbCrLf, currentParagraphIndex + 1)

wpf-richedit-document-api-t213968/VB/DXRichEditControlAPISample/CodeExamples/RangeActions.vb#L75

Dim doc As SubDocument = pos.BeginUpdateDocument()
Dim par As Paragraph = doc.Paragraphs.Get(pos)
Dim newPos As DocumentPosition = doc.CreatePosition(par.Range.End.ToInt() - 1)

winforms-richedit-document-api-e5219/VB/RichEditAPISample/CodeExamples/Range.vb#L75

Dim doc As SubDocument = pos.BeginUpdateDocument()
Dim par As Paragraph = doc.Paragraphs.Get(pos)
Dim newPos As DocumentPosition = doc.CreatePosition(par.Range.End.ToInt() - 1)