https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AWindowGetDimensionsAPI:WindowGetDimensions - Revision history2026-10-17T11:51:30ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:WindowGetDimensions&diff=30869&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:51:28Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Window|wrapper=interfacecore/source/windowstate.lua}}<br />
Returns a window's width and height.<br />
<br />
<pre><br />
width, height = WindowGetDimensions(windowName)<br />
</pre><br />
<br />
== Arguments ==<br />
;windowName : <code>string</code> – Name of the window.<br />
<br />
== Returns ==<br />
;width, height : <code>number</code> – The window's size, before its scale is applied.<br />
<br />
== Details ==<br />
* The size is in the window's own units. The size on screen is these values multiplied by the window's scale ([[API:WindowGetScale|WindowGetScale]]).<br />
* The client registers the C function as <code>_WindowGetDimensions</code>. The <code>WindowGetDimensions</code> that addons call is a Lua function defined in <code>interfacecore/source/windowstate.lua</code>:<br />
** If the global table named after the window (<code>_G[windowName]</code>) has a <code>STATE</code> table, it returns <code>STATE.DIMENSION_X</code> and <code>STATE.DIMENSION_Y</code> without calling into the client.<br />
** Otherwise it calls <code>_WindowGetDimensions(windowName)</code>.<br />
* For windows with state tracking enabled, the client writes the new size to <code>''windowName''.STATE.DIMENSION_X</code> and <code>DIMENSION_Y</code> whenever the size changes, for example through [[API:WindowSetDimensions|WindowSetDimensions]].<br />
* If an addon creates a global table with the same name as a window and gives it a <code>STATE</code> field, <code>WindowGetDimensions</code> returns whatever that table holds. Avoid using <code>STATE</code> as a field name on window tables.<br />
<br />
== Errors ==<br />
* <code>Error in function call 'WindowGetDimensions': Window %s does not exist</code> (from <code>_WindowGetDimensions</code>)<br />
<br />
== Example ==<br />
Making a dialog cover the screen, from <code>easystem_dialogmanager/source/dialogmanager.lua</code>. The root window's size is divided by the interface scale because the dialog's size is scaled when it is drawn:<br />
<pre><br />
local x, y = WindowGetDimensions( "Root" )<br />
x = x / InterfaceCore.GetScale()<br />
y = y / InterfaceCore.GetScale()<br />
WindowSetDimensions( "OneButtonDlg"..dlgIndex, x, y ) -- Set to the screen width and height<br />
</pre><br />
<br />
== See also ==<br />
* [[API:WindowSetDimensions|WindowSetDimensions]]<br />
* [[API:WindowGetScale|WindowGetScale]]<br />
* [[API:WindowGetScreenPosition|WindowGetScreenPosition]]</div>Maintenance script