ITextProvider.RangeFromPoint(Point) Method

Definition

Returns the degenerate (empty) text range nearest to the specified screen coordinates.

public:
 System::Windows::Automation::Provider::ITextRangeProvider ^ RangeFromPoint(System::Windows::Point screenLocation);
public System.Windows.Automation.Provider.ITextRangeProvider RangeFromPoint (System.Windows.Point screenLocation);
abstract member RangeFromPoint : System.Windows.Point -> System.Windows.Automation.Provider.ITextRangeProvider
Public Function RangeFromPoint (screenLocation As Point) As ITextRangeProvider

Parameters

screenLocation
Point

The location in screen coordinates.

Returns

A degenerate range nearest the specified location. A null reference (Nothing in Visual Basic) is never returned.

Exceptions

If a given point is outside the UI Automation element associated with the text pattern.

Remarks

A text range that encloses a child object is returned if the screen coordinates are within the coordinates of an image, hyperlink, or other embedded object.

Because hidden text is not ignored by RangeFromPoint a degenerate range from the visible text closest to the given point is returned.

Applies to

See also