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

Developer

API Reference

IWIDGET_GETWIDGETATCOORDINATE()

Brew Release
Brew MP 1.0.2
See Also
- IWidget_FindElement() - IWidget_GetWidgetByID()
Description
This inline function performs the hit-test at the specified coordinate and retrieves the "highest" direct child of the container. On return, this function fills the "highest" direct child and the localized coordinates parameters for the supplied widget. The 'ppiwTop' output parameter is ADDRef-ed.
Params
piParent
[]:
[in] A pointer to the Parent IWidget interface (of container)
px
[]:
[in/out] Input - x coordinate (hit point) Output - x coordinate relative to supplied widget
py
[]:
[in/out] Input - y coordinate (hit point) Output - y coordinate relative to supplied widget
ppiwTop
[]:
[out] Pointer to an IWidget Interface pointer, into which the "Highest" Widget at the provided coordinate is returned
Interface
Prototype
  •    int IWidget_GetWidgetAtCoordinate( IWidget *piParent, int *px, int *py, IWidget** ppiwTop);
    
Return
  •    AEE_SUCCESS - If the requested operation was performed successfully.
       AEE_EFAILED - Error in retrieving widget at coordinate.
    
Side Effect
  • None
Comments
None