moveToPoint method

Moves the start and end positions of the text range to the given point.

Syntax

var retval = TextRange.moveToPoint(x, y);

Parameters

x [in]

Type: Integer

Integer that specifies the horizontal offset relative to the upper-left corner of the window, in pixels.

y [in]

Type: Integer

Integer that specifies the vertical offset relative to the upper-left corner of the window, in pixels.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Standards information

There are no standards that apply here.

Remarks

The coordinates of the point must be in pixels and be relative to the upper-left corner of the window. The resulting text range is empty, but you can expand and move the range using methods such as expand and moveEnd.

This feature might not be available on non-Microsoft Win32 platforms.

Examples

This example uses the moveToPoint method to move the text range to the point where the user clicked the mouse, expands the range, and selects the text within the new range.

JavaScript


<!DOCTYPE html>

<head>
  <title>moveToPoint</title>
</head>
<body>
  <div contenteditable="true" onmousemove="followMouse()">
    Move the mouse over this text, the caret will follow it.
  </div>
  <script>
    function followMouse() {
      if (document.body.createTextRange) {
        var range = document.body.createTextRange();

        range.moveToPoint(event.clientX, event.clientY);
        range.select();
      }
    }
  </script>
</body>