DocumentPosition Class

A position within a document.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

[ComVisible(true)]
public abstract class DocumentPosition :
    IComparable<DocumentPosition>

VB.NET

<ComVisible(True)>
Public MustInherit Class DocumentPosition
    Implements IComparable(Of DocumentPosition)

Related API Members

The following members return DocumentPosition objects:

Library	Related API Members
WinForms Controls	RichEditControl.GetPositionFromPoint(PointF)
WPF Controls	RichEditControl.GetPositionFromPoint(PointF)
Office File API	Capture.Position
	CustomMark.Position
	Document.CaretPosition
	DocumentRange.End
	DocumentRange.Start
	SubDocument.CreatePosition(Int32)

Remarks

Use the Document.CaretPosition property to get the current cursor (caret) position. The RichEditControl.GetPositionFromPoint method allows you to convert mouse coordinates to a document position.

The DocumentRange.Start and DocumentRange.End positions define a DocumentRange object.

Use the SubDocument.CreatePosition method to obtain an arbitrary position in a document. Call the DocumentPosition.ToInt method to convert a DocumentPosition object to an integer position.

The code sample below obtains a range that starts from the retrieved position:

C#

Document document = server.Document;
document.LoadDocument("Documents\\Grimm.docx", DocumentFormat.OpenXml);
DocumentPosition myStart = document.CreatePosition(69);
DocumentRange myRange = document.CreateRange(myStart, 216);

VB.NET

Dim document As Document = server.Document
document.LoadDocument("Documents\Grimm.docx", DocumentFormat.OpenXml)
Dim myStart As DocumentPosition = document.CreatePosition(69)
Dim myRange As DocumentRange = document.CreateRange(myStart, 216)

Inheritance

Object

DocumentPosition