Brew MP 1.0.2
This function allows an application to activate a specific widget within the card container's
widget stack, thereby granting focus to that widget if it can take focus. There are two cases to
keep in mind: (1) activating a widget which can take focus and (2) activating a widget which CANNOT
take focus. In the latter case, the widget will still become active (redrawn and visible), however,
the container will not have a focused widget.
A pointer to an ICardContainer object.
Identifies the widget within the card container's widget stack that should be activated.
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
int ICardContainer_Activate(ICardContainer *p, IWidget *pw);
AEE_SUCCESS -- The widget was successfully activated.
AEE_EBADPARM -- The widget pointer passed in 'pw' either does not exist, or refers to a widget
that is not in the card container's widget stack.
Calling ICardContainer_Activate() will cause BREW to send an EVT_WDG_MOVEFOCUS to the card
container, specifying 'pw' as the new focus item.