OpenWindow

OpenWindow

OpenWindow(windowID, n), OpenWindow(windowID)

parameters: Identifier of a Windows, number n (default is n = 0)

The identified window is opened, i.e. it appears on the screen. With parameter n you can limit the number of simultaneously existing windows. With 0 no limitation is set.

The result on the stack shows whether a window was opened or whether this was not the case because the limit n was exceeded.
_{Up to DLL version 198981} this was communicated via TRUE/FALSE.

_{As of DLL version 199107}, the CX_WIDGET object of the newly opened window is returned or INVALID if:

• no further window can be opened due to the limit (the last opened window with the name is focused).
• for OpenWindow(STACK) the passed CX_WIDGET is an already open window.
• with OpenWindow(STACK) a CX_WIDGET was passed that is not a toplevel window.

If OpenWindow(STACK) is called with a CX_WIDGET, then the window by-name is opened in the current module. It is therefore not possible to send a widget to another module and then open it in that module (across the module boundary).

Depending on whether a control window is active - see ControlWindow - the window is assigned to it as a child window or not.

Code example:

OpenWindow(win1) -> window
"Dies befindet sich in einem neu geöffneten Fenster" window PutValue(STACK, subWidget)