SDL_ClipboardDataCallback - Callback function that will be called when data for the specified mime-type
Contents
Availability
This function is available since SDL 3.2.0.
Description
The callback function is called with NULL as the mime_type when the clipboard is cleared or new data is
set. The clipboard is automatically cleared in SDL_Quit ().
Function Parameters
userdata
a pointer to provided user data.
mime_type
the requested mime-type.
size a pointer filled in with the length of the returned data.
Header File
Defined in SDL3/SDL_clipboard.h
Name
SDL_ClipboardDataCallback - Callback function that will be called when data for the specified mime-type
is requested by the OS.
Return Value
Returns a pointer to the data for the provided mime-type. Returning NULL or setting length to 0 will
cause no data to be sent to the "receiver". It is up to the receiver to handle this. Essentially
returning no data is more or less undefined behavior and may cause breakage in receiving applications.
The returned data will not be freed so it needs to be retained and dealt with internally.
See Also
•(3), SDL_SetClipboardData(3) Simple Directmedia Layer SDL 3.2.10 SDL_ClipboardDataCallback(3type)
Synopsis
#include"SDL3/SDL.h"typedefconstvoid*(SDLCALL*SDL_ClipboardDataCallback)(void*userdata,constchar*mime_type,size_t*size);
