Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:40:52Z

UI Lua API import (WAR 1.4.8)

New page

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

<pre>
ButtonSetTextureSlice(buttonName, state, textureName, sliceName)
</pre>

== Arguments ==
;buttonName : <code>string</code> – Name of a Button window.
;state : <code>number</code> – The button state, a <code>Button.ButtonState</code> value. Fractions are dropped.
;textureName : <code>string</code> – Name of the texture.
;sliceName : <code>string</code> – Name of a slice defined for that texture.

== Returns ==
Nothing.

== Details ==
* This is the slice-based counterpart of [[API:ButtonSetTexture|ButtonSetTexture]]: the client looks up the position of the slice in the texture and then sets the texture for that state at that position, as <code>ButtonSetTexture</code> does.
* If the texture or the slice is not found, the button is left unchanged and no error is logged.
* The stock target frames set the same texture with different slices for the normal and highlighted states (see the example).
* The function needs at least four arguments and only reads the last four.

== Errors ==
These are written to the UI log; the call returns normally.
* <code>Error in function call 'ButtonSetTextureSlice': Window %s does not exist</code>
* <code>Error in function call 'ButtonSetTextureSlice': Window %s is not a Button</code>

== Example ==
From <code>eatemplate_unitframes/source/targetunitframe.lua</code>:
<pre>
ButtonSetTextureSlice(buttonName, Button.ButtonState.NORMAL, "EA_HUD_01", normalSlice);
ButtonSetTextureSlice(buttonName, Button.ButtonState.HIGHLIGHTED, "EA_HUD_01", rolloverSlice);
ButtonSetTextureSlice(buttonName, Button.ButtonState.PRESSED, "EA_HUD_01", normalSlice);
ButtonSetTextureSlice(buttonName, Button.ButtonState.PRESSED_HIGHLIGHTED, "EA_HUD_01", rolloverSlice);
</pre>

== See also ==
* [[API:ButtonSetTexture|ButtonSetTexture]]
* [[API:DynamicImageSetTextureSlice|DynamicImageSetTextureSlice]]

API:ButtonSetTextureSlice - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)