https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AWindowSetShowingAPI:WindowSetShowing - Revision history2026-10-17T18:28:06ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:WindowSetShowing&diff=30909&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:52:04Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Window}}<br />
Shows or hides a window.<br />
<br />
<pre><br />
WindowSetShowing(windowName, show)<br />
</pre><br />
<br />
== Arguments ==<br />
;windowName : <code>string</code> – Name of the window.<br />
;show : <code>boolean</code> – <code>true</code> to show the window, <code>false</code> to hide it.<br />
<br />
== Returns ==<br />
Nothing.<br />
<br />
== Details ==<br />
* If the window is already in the requested state, its showing flag and <code>STATE</code> are left alone.<br />
* With <code>show = true</code>, a popable window that is not on the background layer is brought to the front of its siblings on the same layer. This happens on every call, even if the window was already showing, so calling <code>WindowSetShowing(name, true)</code> again is a way to raise a window.<br />
* For windows with state tracking enabled, the client writes the new value to <code>''windowName''.STATE.SHOWING</code> (see [[API:WindowGetShowing|WindowGetShowing]]).<br />
* <code>show</code> must be a real boolean. Passing <code>nil</code> or a number raises an ''Invalid Parameters'' error.<br />
* The function needs at least two arguments and only reads the last two. Any extra arguments placed in front of them are ignored.<br />
<br />
== Errors ==<br />
* <code>Error in function call 'WindowSetShowing': Window %s does not exist</code><br />
* <code>Error in function call 'WindowSetShowing': Window %s is currently locked and may not be modified from lua. This window, or one of its relatives has a registered GameAction.</code><br/>This check exists in the client but never triggers: the lock flag it tests is never set.<br />
<br />
== Example ==<br />
Toggling a window, as done by <code>WindowUtils.ToggleShowing</code> in <code>easystem_windowutils/source/windowutils.lua</code>:<br />
<pre><br />
local showing = WindowGetShowing( windowName )<br />
WindowSetShowing( windowName, not showing )<br />
</pre><br />
<br />
Showing a dialog button only when it has text, from <code>easystem_dialogmanager/source/dialogmanager.lua</code>:<br />
<pre><br />
WindowSetShowing( "TwoButtonDlg"..dlgIndex.."BoxButton1", button1Text ~= L"" )<br />
</pre><br />
<br />
== See also ==<br />
* [[API:WindowGetShowing|WindowGetShowing]]<br />
* [[API:WindowSetParent|WindowSetParent]]</div>Maintenance script