View source for API:SetCursor

{{LuaApi|group=Interface}}
Replaces the mouse cursor with an image built from a UI texture.

<pre>
SetCursor(textureName)
</pre>

== Arguments ==
;textureName : <code>string</code> – Name of a texture known to the UI, such as the texture name returned by <code>GetIconData</code>.

== Returns ==
Nothing.

== Details ==
* The client looks the name up among the UI's registered textures, loads the image and builds a hardware cursor from it. The image <code>data/gamedata/cursor_corner.tga</code> is loaded as well and passed along with it when the cursor is built.
* If no texture with that name is registered, the cursor is left unchanged.
* The stock UI calls it when an icon is picked up and restores the normal cursor with <code>ClearCursor</code>.

== Errors ==
None besides the ''Invalid Parameters'' argument check.

== Example ==
From <code>ea_cursor/source/cursor.lua</code>:
<pre>
local texture, x, y = GetIconData( Cursor.Data.IconId )
SetCursor( texture )

SetItemDragging(true)
</pre>

== See also ==
* [[API:SetItemDragging|SetItemDragging]]
* [[API:GetIconData|GetIconData]]