API Reference | developer.brewmp.com API Reference | developer.brewmp.com

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.
Params
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
Comments
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.