[in] A pointer to an IXYContainer object.
[in] Identifies the widget within the XY container's widget stack that will serve as a
reference point for the widget to be retrieved. This widget may be expressed explicitly
as a widget pointer, or implicitly as a constant that identifies a relative position
within the widget stack, as follows
WIDGET_ZNORMAL - Use the widget at the XY container's default location as the
retrieval reference point. BREW interprets this to be the
widget at the top of the widget stack.
WIDGET_ZTOPMOST - Use the widget at the top of the widget stack as the retrieval
WIDGET_ZBOTTOMMOST - Use the widget at the bottom of the widget stack as the retrieval
When 'pwRef' is NULL, the function will return either the top or bottom widget on the stack,
depending on the value of 'bNext'. When 'pwRef' is NULL and 'bNext' is TRUE, IXYContainer_GetWidget()
will return the bottommost widget. When 'pwRef' is NULL and 'bNext' is FALSE, the function will
return the topmost widget.
[in] Specifies whether the function should retrieve the next widget in the widget stack, or the
previous widget on the stack -- always relative to the reference widget determined by the
value passed in the 'pwRef' parameter. When 'bNext' is TRUE the function will retrieve the next
widget on the stack (i.e. the widget closer to the top of the stack). When 'bNext' is FALSE
the function will retrieve the previous widget on the stack (i.e. the widget closer to the
bottom of the stack). Note, however, that when 'pwRef' is passed as NULL, the 'bNext' parameter
explicitly indicates either the topmost or bottommost widget, as described above.
[in] Specifies whether or not the function should wrap when attempting to retrieve the next or
previous widget from the top or bottom of the XY container's widget stack. When 'bWrap' is
TRUE, the function will wrap at either end of the stack, otherwise the function will return
NULL indicating that there are no more widgets to be retrieved.