Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:51:54Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Window}}
Sets whether a window receives mouse input.

<pre>
WindowSetHandleInput(windowName, handleInput)
</pre>

== Arguments ==
;windowName : <code>string</code> – Name of the window.
;handleInput : <code>boolean</code> – <code>true</code> to let the window receive mouse input, <code>false</code> to let the mouse pass through it.

== Returns ==
Nothing.

== Details ==
* When the client looks for the window under the mouse, it skips windows with this flag cleared. It does not look inside them either, so their child windows are skipped too, whatever their own flag says.
* <code>handleInput</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.

== Errors ==
* <code>Error in function call 'WindowSetHandleInput': Window %s does not exist</code>
* <code>Error in function call 'WindowSetHandleInput': Window %s is currently locked and may not be modified from lua. ...</code><br/>This check never triggers in the current client. See [[API:WindowSetShowing|WindowSetShowing]].

== Example ==
From <code>easystem_glyphdisplay/source/glyphdisplay.lua</code>:
<pre>
WindowSetHandleInput("EA_Window_GlyphTracker", false)
</pre>

== See also ==
* [[API:WindowGetHandleInput|WindowGetHandleInput]]
* [[API:WindowSetShowing|WindowSetShowing]]

API:WindowSetHandleInput - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)