IUIAutomationTextRange::GetBoundingRectangles Method

Retrieves a collection of bounding rectangles for each fully or partially visible line of text in a text range.

Syntax

HRESULT GetBoundingRectangles(      
    SAFEARRAY *boundingRects[double]
);

Parameters

  • boundingRects
    [out, retval] The address of a SAFEARRAY that receives a pointer to an array of bounding rectangles for each fully or partially visible line of text in a text range. An empty array is returned for a degenerate (empty) text range or for a text range that is completely off-screen, scrolled out of view, or obscured by an overlapping window.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

For information about how the bounding rectangles are stored in the SAFEARRAY, see Working with Safe Arrays.

See Also

IUIAutomation::SafeArrayToRectNativeArray, UI Automation Text Pattern Overview