Brew MP 1.0.2
This function allows an application to remove a widget from the prop container's widget
stack. The widget to be removed may be specified explicitly, by its widget pointer, or
implicitly by a constant that identifies the widget's relative position within the
container's widget stack.
A pointer to an IPropContainer object.
Identifies the widget that should be removed from the prop container's widget stack.
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 - Remove the default widget, which BREW interprets to be
the widget at the top of the widget stack.
WIDGET_ZTOPMOST - Remove the widget at the top of the widget stack.
WIDGET_ZBOTTOMMOST - Remove the widget at the bottom of the widget stack.
int IPropContainer_Remove(IPropContainer* pif, IWidget* pw)
AEE_SUCCESS -- The widget was successfully removed from the prop container's widget stack.
AEE_EBADPARM -- The widget pointer passed in 'pw' either does not exist, or refers to a widget
that is not in the prop container's widget stack.
Calling IPropContainer_Remove() will cause the prop container to adjust the object layout
to consume the space surrendered by the removed widget.