ITextProvider.RangeFromPoint(Point) Method

Reference

Definition

Namespace:: System.Windows.Automation.Provider

Assembly:: UIAutomationProvider.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

ITextRangeProvider

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

Exceptions

ArgumentException

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