ITextProvider.RangeFromPoint(Point) Method
Definition
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
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.