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.
Parameters
  • 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
Comment
None
  • Follow