Developer

API Reference

IWidget_FindElement()

Brew Release
Brew MP 1.0.2
See Also
IWidget WidgetElemInfo IWidget_GetPropertyEx
Description
This inline method performs a hit test using widget-relative x,y coordinates, and finds the widget element that corresponds with that point. On return, the method fills a data structure containing information about the element.
Parameters
  • pif
    []:
    [in] A pointer to the IWidget interface.
  • x
    []:
    [in] Widget relative x coordinate for hit test
  • y
    []:
    [in] Widget relative y coordinate for hit test
  • pWei
    []:
    [out] Pointer to WidgetElemInfo structure to be filled with element data on return.
Interface
Prototype
   int   IWidget_FindElement( IWidget * pif, 
                              int x, 
                              int y, 
                              WidgetElemInfo * pWei );
Return
   AEE_SUCCESS -   Element was found at x,y location and WidgetElemInfo struct 
                   was filled.
   AEE_EFAILED -   Widget failed to find the element at x,y location.
Side Effect
None
Comment
It is recommended that for decorators, applications should unset PROPEX_PASS_WIDGETELEMINFO property of the widget(using IWidget_SetPassWidgetElemInfo) so that widget retrieves the element with respect to itself rather than passing it to its children.
  • Follow