Skip to main content

ReadOnlyHyperlinkCollection.Get(DocumentRange) Method

Gets all hyperlinks located in the specified document range.

Namespace: DevExpress.XtraRichEdit.API.Native

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

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

Declaration

ReadOnlyHyperlinkCollection Get(
    DocumentRange range
)

Parameters

Name Type Description
range DocumentRange

A DocumentRange specifying the range in which to search for hyperlinks.

Returns

Type Description
ReadOnlyHyperlinkCollection

A ReadOnlyHyperlinkCollection object specifying the read-only collection of hyperlinks.

Remarks

The Get method returns a collection of Hyperlink objects contained in the specified range.

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.

The code sample below locates and removes all hyperlinks in the first section:

using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
{
    Document document = wordProcessor.Document;
    ReadOnlyHyperlinkCollection hyperlinks = document.Hyperlinks.Get(document.Sections[0].Range);
    if (hyperlinks != null)
    {
        foreach (Hyperlink hyperlink in hyperlinks)
        {
            document.Hyperlinks.Remove(hyperlink);
        }
    }
}
See Also