RichEditControl.GetPositionFromPoint(PointF) Method

Gets the position in the document closest to the specified point.

Namespace: DevExpress.Xpf.RichEdit

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

Declaration

C#

public DocumentPosition GetPositionFromPoint(
    PointF clientPoint
)

VB.NET

Public Function GetPositionFromPoint(
    clientPoint As PointF
) As DocumentPosition

Parameters

Name	Type	Description
clientPoint	PointF	A PointF structure specifying the location for which the position is retrieved. The point coordinates are measured in documents units.

Returns

Type	Description
DocumentPosition	A DocumentPosition object representing a position in the document.

Remarks

The GetPositionFromPoint method returns the closest document position for a specified point or null reference (Nothingin Visual Basic). The coordinate system used is a standard one, where the origin is located at the upper left corner of the RichEditControl. Use the Units.PixelsToDocuments method to translate coordinates.

This code snippet illustrates handling the MouseMove event of the RichEditControl and using the RichEditControl.GetPositionFromPoint method to obtain the corresponding position in the document. If the position under the mouse cursor belongs to a bookmark, this bookmark is selected using the SubDocument.SelectBookmark method, and its name and text fragment are displayed in the text box below.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/dxrichedit-for-wpf-how-to-use-hit-testing-e2765.

MainWindow.xaml.vb

Private Sub richEditControl1_MouseMove(ByVal sender As Object, ByVal e As MouseEventArgs)
    Dim point As Point = e.GetPosition(CType(richEditControl1, UIElement))
    Dim pt As New System.Drawing.PointF(Units.PixelsToDocumentsF(CSng(point.X),richEditControl1.DpiX), Units.PixelsToDocumentsF(CSng(point.Y), richEditControl1.DpiY))
    Dim pos As DocumentPosition = richEditControl1.GetPositionFromPoint(pt)

    Dim bmCollection As BookmarkCollection = richEditControl1.Document.Bookmarks
    textBlock1.Text = String.Empty 'Clear a text block displaying bookmark info

    If pos IsNot Nothing Then
        For Each bm As Bookmark In bmCollection
            If bm.Range.Contains(pos) Then
                Dim bmHovered As Bookmark = bm
                richEditControl1.Document.SelectBookmark(bmHovered)
                ShowBookmarkInTextBlock(bmHovered)
                Exit For
            End If
        Next bm
    End If
End Sub

MainWindow.xaml.cs

void richEditControl1_MouseMove(object sender, MouseEventArgs e)
{
    Point point = e.GetPosition((UIElement)richEditControl1);
    System.Drawing.PointF pt = new System.Drawing.PointF(Units.PixelsToDocumentsF((float)point.X,richEditControl1.DpiX),
        Units.PixelsToDocumentsF((float)point.Y, richEditControl1.DpiY));
    DocumentPosition pos = richEditControl1.GetPositionFromPoint(pt);

    BookmarkCollection bmCollection = richEditControl1.Document.Bookmarks;
    textBlock1.Text = String.Empty; //Clear a text block displaying bookmark info

    if (pos != null)
    {
        foreach (Bookmark bm in bmCollection)
        {
            if (bm.Range.Contains(pos))
            {
                Bookmark bmHovered = bm;
                richEditControl1.Document.SelectBookmark(bmHovered);
                ShowBookmarkInTextBlock(bmHovered);
                break;
            }
        }
    }           
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the GetPositionFromPoint(PointF) method.

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#

how-to-drag-and-drop-data-from-listbox-to-richeditcontrol-e4488/CS/ListBoxDragAndDrop/Helpers.cs#L28

    Units.PixelsToDocumentsF((float)windowsPoint.Y, richEditControl.DpiY));
DocumentPosition pos = richEditControl.GetPositionFromPoint(drawingPoint);

VB.NET

how-to-drag-and-drop-data-from-listbox-to-richeditcontrol-e4488/VB/ListBoxDragAndDrop/Helpers.vb#L32

Dim drawingPoint As New System.Drawing.PointF(Units.PixelsToDocumentsF(CSng(windowsPoint.X), richEditControl.DpiX), Units.PixelsToDocumentsF(CSng(windowsPoint.Y), richEditControl.DpiY))
Dim pos As DocumentPosition = richEditControl.GetPositionFromPoint(drawingPoint)