Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:41:52Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Interface}}
Creates a top-level window from the window definition of the same name.

<pre>
CreateWindow(windowName, show)
</pre>

== Arguments ==
;windowName : <code>string</code> – Name of a window defined in a loaded XML file. The new window gets the same name.
;show : <code>boolean</code> – <code>true</code> to show the window at once, <code>false</code> to create it hidden.

== Returns ==
Nothing.

== Details ==
* The window is created as a child of the root window. To create a window with a different name or under another parent, use [[API:CreateWindowFromTemplate|CreateWindowFromTemplate]].
* If a window with this name already exists, it is not created again and an error is logged. The exception is a window that is waiting for a deferred [[API:DestroyWindow|DestroyWindow]]: it is taken off the destroy list and kept, and its showing flag is set to <code>show</code>.
* If no definition with this name exists, the error <code>ERROR: Unable to create window: %s</code> is logged.
* <code>show</code> must be a real boolean. Passing <code>nil</code> or a number raises an ''Invalid Parameters'' error.
* The function needs at least two arguments and only reads the last two.
* Use [[API:DoesWindowExist|DoesWindowExist]] to check first if the window may already exist.

== Errors ==
These are written to the UI log; the call returns normally.
* <code>ERROR: Unable to create window: %s</code>
* <code>ERROR: Window with this name already exists: %s</code>

== Example ==
From <code>easystem_dialogmanager/source/dialogmanager.lua</code>:
<pre>
CreateWindow( "OneButtonDlg"..dlg, false )
</pre>

== See also ==
* [[API:CreateWindowFromTemplate|CreateWindowFromTemplate]]
* [[API:DestroyWindow|DestroyWindow]]
* [[API:DoesWindowExist|DoesWindowExist]]

API:CreateWindow - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)