Document.CaretPosition Property

Gets or sets the position of the caret within the document.

Namespace: DevExpress.XtraRichEdit.API.Native

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

Declaration

C#

DocumentPosition CaretPosition { get; set; }

VB.NET

Property CaretPosition As DocumentPosition

Property Value

Type	Description
DocumentPosition	A DocumentPosition object, representing the current caret position.

Remarks

Use this property to insert text at the current cursor position or to access the paragraph where the cursor is located (the ReadOnlyParagraphCollection.Get method).

Note

When working with headers/footers, use the DocumentPosition.BeginUpdateDocument - DocumentPosition.EndUpdateDocument pair to get the correct position. Otherwise an InvalidOperationException is thrown.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CaretPosition property.

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#

winforms-richedit-document-api-e5219/CS/RichEditAPISample/CodeExamples/Field.cs#L15

#region #InsertField
DocumentPosition caretPosition = document.CaretPosition;

wpf-richedit-document-api-t213968/CS/DXRichEditControlAPISample/CodeExamples/FormFieldsActions.cs#L15

#region #CreateCheckbox
DocumentPosition currentPosition = document.CaretPosition;
DevExpress.XtraRichEdit.API.Native.CheckBox checkBox = document.FormFields.InsertCheckBox(currentPosition);

inline-pictures-in-richeditcontrol-e1525/CS/InlinePictures/Form1.cs#L27

DocumentPosition pos = richEditControl1.Document.CaretPosition;
Image imageToInsert = imageCollection1.Images[3];

winforms-the-richeditcontrols-common-api-t210437/CS/RichEditAPISample/CodeExamples/RichEditControlActions.cs#L99

richEdit.LoadDocument("Documents\\MultiPageDocument.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml);
richEdit.Document.CaretPosition = richEdit.Document.Range.End;
richEdit.ScrollToCaret();

how-to-create-an-editor-similar-to-outlook-attachment-editor-e4911/CS/WindowsFormsApplication1/WindowsFormsApplication1/AttachmentsEditor.cs#L61

DocumentPosition pos = richEditControl1.Document.CaretPosition;
foreach (KeyValuePair<string, FileFieldInfo> item in filesCollection)

VB.NET

winforms-richedit-document-api-e5219/VB/RichEditAPISample/CodeExamples/Field.vb#L12

'            #Region "#InsertField"
Dim caretPosition As DocumentPosition = document.CaretPosition

wpf-richedit-document-api-t213968/VB/DXRichEditControlAPISample/CodeExamples/FormFieldsActions.vb#L12

'            #Region "#CreateCheckbox"
            Dim currentPosition As DocumentPosition = document.CaretPosition
            Dim checkBox As DevExpress.XtraRichEdit.API.Native.CheckBox = document.FormFields.InsertCheckBox(currentPosition)

inline-pictures-in-richeditcontrol-e1525/VB/InlinePictures/Form1.vb#L29

Dim pos As DocumentPosition = richEditControl1.Document.CaretPosition
Dim imageToInsert As Image = imageCollection1.Images(3)

winforms-the-richeditcontrols-common-api-t210437/VB/RichEditAPISample/CodeExamples/RichEditControlActions.vb#L104

richEdit.LoadDocument("Documents\MultiPageDocument.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml)
richEdit.Document.CaretPosition = richEdit.Document.Range.End
richEdit.ScrollToCaret()

how-to-create-an-editor-similar-to-outlook-attachment-editor-e4911/VB/WindowsFormsApplication1/AttachmentsEditor.vb#L66

Dim pos As DocumentPosition = richEditControl1.Document.CaretPosition
For Each item As KeyValuePair(Of String, FileFieldInfo) In filesCollection