WoW API: SetCursor

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < SetCursor

Changes the current cursor graphic.

changed = SetCursor(cursor);

Arguments

cursor

String - one of the following graphic descriptors:

• Path to a cursor graphic.
• "XX_CURSOR", where XX is a capitalized version of a filename in the Interface\CURSORS folder.
• Non-existent path; cursor is hidden.
• nil; cursor is reset to default.

Returns

changed

1 if cursor graphic is changed, nil otherwise.

Details

• The option to pass nil was added in 1.11.
• For custom textures: The graphic must be an UNCOMPRESSED BLP file; compressed BLP files will only work for software cursors.
• If the cursor is hovering over WorldFrame, the SetCursor function will have no effect - cursor is locked to reflect what the player is currently pointing at.