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.
Parameters
  • 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
Comment
Though IXYContainer_GetFirstWidget() function returns a pointer to a widget, the function does not add a reference to the returned IWidget for the caller.
  • Follow