Removing the topmost visible widget from a card container -- i.e. the widget that has the current focus -- the focus will be shifted to the next focusable widget within the container.
- pif:A pointer to an ICardContainer object.
- pw:Identifies the widget that should be removed from the card 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 ICardContainer_Remove(ICardContainer *pif, IWidget *pw);
AEE_SUCCESS -- The widget was successfully removed from the card container's widget stack. AEE_EBADPARM -- The widget pointer passed in 'w' either does not exist, or refers to a widget that is not in the card container's widget stack.