Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:51Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Button}}
Sets the texture a Button draws in one of its states.

<pre>
ButtonSetTexture(buttonName, state, textureName, x, y)
</pre>

== Arguments ==
;buttonName : <code>string</code> – Name of a Button window.
;state : <code>number</code> – The button state, a <code>Button.ButtonState</code> value (see [[API:ButtonSetTextColor|ButtonSetTextColor]]).
;textureName : <code>string</code> – Name of the texture. <code>""</code> removes the texture for that state.
;x, y : <code>number</code> – Pixel position in the texture of the top-left corner of the area to show.

== Returns ==
Nothing.

== Details ==
* The previous texture for that state is always removed first. If no texture is found under <code>textureName</code>, the state is left without a texture and no error is raised.
* <code>state</code> is not range-checked. Use only the <code>Button.ButtonState</code> values.

== Errors ==
* <code>Error in function call 'ButtonSetTexture': Window %s does not exist</code>
* <code>Error in function call 'ButtonSetTexture': Window %s is not a Button</code>

== Example ==
Changing an ability button's highlight frame to match its shape, and clearing it, from <code>ea_abilitieswindow/source/abilitieswindow.lua</code>:
<pre>
ButtonSetTexture (SystemData.ActiveWindow.name, Button.ButtonState.HIGHLIGHTED, "EA_SquareFrame_Highlight", 0, 0)
...
ButtonSetTexture (SystemData.ActiveWindow.name, Button.ButtonState.HIGHLIGHTED, "", 0, 0)
</pre>

== See also ==
* [[API:ButtonSetTextColor|ButtonSetTextColor]]
* [[API:DynamicImageSetTexture|DynamicImageSetTexture]]

API:ButtonSetTexture - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)