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

Developer

API Reference

IXYCONTAINER_GETFIRSTWIDGET()

Brew Release
Brew MP 1.0.2
See Also
- IXYContainer - IWidget - IXYContainer_GetWidget - IXYContainer_GetLastWidget
Description
This function retrieves a pointer to the first widget in the XY container's widget stack. This is, effectively, the widget at the top of the widget stack. The widget on the top of the stack is the first one drawn onscreen and is the bottommost with regard to front-to-back ordering within the container.
Params
pif
[]:
A pointer to an IXYContainer object.

Interface
Prototype
  •    IWidget *IXYContainer_GetFirstWidget(IXYContainer *pif);
    
Return
  • A pointer to the widget at the top of the XY container's widget stack, or NULL when the widget stack is empty.
Side Effect
  • None
Comments
Though IXYContainer_GetFirstWidget() function returns a pointer to a widget, the function does not add a reference to the returned IWidget for the caller.