int IWidget_SetDisplay(IWidget *pif, IDisplay *piDisplay);
AEE_SUCCESS: If the widget is able to wrap the piDisplay. ENOMEMORY: If there is not enough memory to create offscreen bitmap. AEE_EFAILED: If the property could not be set.
Required Model: IViewModel
Model Data: The DisplayWidget relies on a view model that it simply uses as a conduit for sending focus changed events to listening objects.
- Call to this function manipulates the destination bitmap of the IDisplay. So, care should be taken by the applications not to modify the destination bitmap further e.g. by calling IDisplay_SetDestination(). Also, if the application had previously stored a pointer to the destination bitmap, it will have to get it again by calling IDisplay_GetDestination().