Back to Devexpress

ReadOnlyBookmarkCollection.Get(DocumentRange) Method

officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-readonlybookmarkcollection-dot-get-x28-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-documentrange-x29.md

latest3.6 KB
Original Source

ReadOnlyBookmarkCollection.Get(DocumentRange) Method

Gets all bookmarks located in the specified document range.

Namespace : DevExpress.XtraRichEdit.API.Native

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

NuGet Package : DevExpress.RichEdit.Core

Declaration

csharp
ReadOnlyBookmarkCollection Get(
    DocumentRange range
)
vb
Function Get(
    range As DocumentRange
) As ReadOnlyBookmarkCollection

Parameters

NameTypeDescription
rangeDocumentRange

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

|

Returns

TypeDescription
ReadOnlyBookmarkCollection

A ReadOnlyBookmarkCollection object specifying the read-only collection of bookmarks.

|

Remarks

The Get method returns a collection of Bookmark 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 shows how to locate and remove bookmarks in the 6th paragraph:

csharp
using DevExpress.XtraRichEdit.API.Native;

using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
{
    Document document = wordProcessor.Document;
    ReadOnlyBookmarkCollection bookmarks =
       document.Bookmarks.Get(document.Paragraphs[5].Range);
    if (bookmarks != null)
    {
        foreach (Bookmark bookmark in bookmarks)
        {
            document.Bookmarks.Remove(bookmark);
        }
    }
}
vb
Imports DevExpress.XtraRichEdit.API.Native

Using wordProcessor As New RichEditDocumentServer()
  Dim document As Document = wordProcessor.Document
  Dim bookmarks As ReadOnlyBookmarkCollection =
     document.Bookmarks.Get(document.Paragraphs(5).Range)
  If bookmarks IsNot Nothing Then
    For Each bookmark As Bookmark In bookmarks
      document.Bookmarks.Remove(bookmark)
    Next bookmark
  End If
End Using

See Also

ReadOnlyBookmarkCollection Interface

ReadOnlyBookmarkCollection Members

DevExpress.XtraRichEdit.API.Native Namespace