Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

ITextProvider::RangeFromPoint method

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

Syntax


HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

Parameters

point [in]

Type: UiaPoint

The location in screen coordinates.

pRetVal [out, retval]

Type: ITextRangeProvider**

Receives a pointer to the degenerate (empty) text range nearest the specified location. This parameter is passed uninitialized.

Return value

Type: HRESULT

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

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 ITextProvider::RangeFromPoint, a degenerate range from the visible text closest to the given point is returned.

The property never returns NULL.

Requirements

Minimum supported client

Windows XP [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2003 [desktop apps | Windows Store apps]

Header

UIAutomationCore.h (include UIAutomation.h)

IDL

UIAutomationCore.idl

See also

Reference
ITextProvider
ITextRangeProvider
Conceptual
UI Automation Providers Overview

 

 

Show:
© 2017 Microsoft