(This is the legacy documentation for stable SDL2, the current stable version; SDL3 is the current development version.)

SDL_SetCursor

Set the active cursor.

Header File

Defined in SDL_mouse.h, but apps should only #include "SDL.h"!

Syntax

void SDL_SetCursor(SDL_Cursor * cursor);

Function Parameters

cursor

a cursor to make active

Remarks

This function sets the currently active cursor to the specified one. If the cursor is currently visible, the change will be immediately represented on the display. SDL_SetCursor(NULL) can be used to force cursor redraw, if this is desired for any reason.

Version

This function is available since SDL 2.0.0.