Shape.Range Property

Gets the anchoring range for the specified shape.

Namespace: DevExpress.XtraRichEdit.API.Native

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

Declaration

C#

DocumentRange Range { get; }

VB.NET

ReadOnly Property Range As DocumentRange

Property Value

Type	Description
DocumentRange	A DocumentRange object that is the anchoring range for the specified shape.

Remarks

The Shape is anchored to a document range, but can be positioned anywhere on the page that contains the anchor. If you specify the document position when you create a shape via the ShapeCollection.InsertPicture or a ShapeCollection.InsertTextBox methods, the anchor is located at the beginning of the first paragraph that contains the specified position.

The shape will always remain on the same page as its anchor.

Tip

To select a shape, assign the corresponding Range to the Document.Selection property.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Range 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/Shapes.cs#L114

document.LoadDocument("Documents//Grimm.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml);
document.Selection = document.Shapes[0].Range;
#endregion #SelectShape

word-document-api-examples/CS/CodeExamples/ShapesActions.cs#L123

document.LoadDocument("Documents\\Grimm.docx", DocumentFormat.OpenXml);
document.Selection = document.Shapes[0].Range;
#endregion #SelectShape

VB.NET

winforms-richedit-document-api-e5219/VB/RichEditAPISample/CodeExamples/Shapes.vb#L100

            document.LoadDocument("Documents//Grimm.docx", DevExpress.XtraRichEdit.DocumentFormat.OpenXml)
            document.Selection = document.Shapes(0).Range
'            #End Region ' #SelectShape

word-document-api-examples/VB/CodeExamples/ShapesActions.vb#L109

            document.LoadDocument("Documents\Grimm.docx", DocumentFormat.OpenXml)
            document.Selection = document.Shapes(0).Range
'            #End Region ' #SelectShape