Callback used by file dialog functions.
Defined in <SDL3/SDL_dialog.h>
typedef void (SDLCALL *SDL_DialogFileCallback)(void *userdata, const char * const *filelist, int filter);| userdata | an app-provided pointer, for the callback's use. |
| filelist | the file(s) chosen by the user. |
| filter | index of the selected filter. |
The specific usage is described in each function.
If filelist is:
NULL, the user chose one or more files. The argument is a null-terminated list of pointers to C strings, each containing a path.The filelist argument should not be freed; it will automatically be freed when the callback returns.
The filter argument is the index of the filter that was selected, or -1 if no filter was selected or if the platform or method doesn't support fetching the selected filter.
This datatype is available since SDL 3.1.3.
#include <SDL3/SDL.h>
static const SDL_DialogFileFilter filters[] = {
{ "PNG images", "png" },
{ "JPEG images", "jpg;jpeg" },
{ "All images", "png;jpg;jpeg" },
{ "All files", "*" }
};
static void SDLCALL callback(void* userdata, const char* const* filelist, int filter)
{
if (!filelist) {
SDL_Log("An error occured: %s", SDL_GetError());
return;
} else if (!*filelist) {
SDL_Log("The user did not select any file.");
SDL_Log("Most likely, the dialog was canceled.");
return;
}
while (*filelist) {
SDL_Log("Full path to selected file: '%s'", *filelist);
filelist++;
}
if (filter < 0) {
SDL_Log("The current platform does not support fetching "
"the selected filter, or the user did not select"
" any filter.");
} else if (filter < SDL_arraysize(filters)) {
SDL_Log("The filter selected by the user is '%s' (%s).",
filters[filter].pattern, filters[filter].name);
}
}