API Reference | developer.brewmp.com API Reference | developer.brewmp.com

Developer

API Reference

IWINDOWMGR0_CREATEWINDOW()

Brew Release
Brew MP 1.0.2
See Also
Description
Creates a window from an application-owned widget and insert it into the window manager.
This is an asynchronous operation, and thus this function may return AEE_SUCCESS, yet fail later in the process. Such asynchronous errors are reported to the widget via IWIDGET_HandleEvent() and EVT_WDG_WINDOWSTATUS. This event will only be delivered if this function returns AEE_SUCCESS and the window has not been closed via IWindowMgr0_CloseWindow().
Params
po
[]:
IWindowMgr0 interface pointer.
pWidget
[]:
widget to be used as a window.
dwFlags
[]:
window creation flags, as follows...
   Window creation flags      Description
   ---------------------      ----------------------------------
   WMCWF_STYLE_MAIN           Window is a main window.
   WMCWF_STYLE_POPUP          Window is a popup window.
   WMCWF_STYLE_SOFTKEY        Window is a softkey window.
   WMCWF_NOACTIVATE           Do not activate window on creation.
   WMCWF_FULLSCREEN           Display window full screen.
Interface
Prototype
  •   int IWindowMgr0_CreateWindow(IWindowMgr0 *po, IQI *pWidget, uint32 dwFlags);
    
Return
  • Error code.
Side Effect
  • None.
Comments
The WMCWF_STYLE_xxx values specify different window types or "styles" that may behave differently within the window manager. For example, a window created with the WMCWF_STYLE_SOFTKEY style would be sized, positioned and treated differently than a WMCWF_STYLE_MAIN window. WMCWF_STYLE_xxx are 4-bit values, and hence are mutually exclusive. Do not combine two or more of these values together by ORing them; unexpected results may occur.