NAME¶

SDL_DialogFileCallback - Callback used by file dialog functions.

HEADER FILE¶

Defined in SDL3/SDL_dialog.h

SYNOPSIS¶

#include "SDL3/SDL.h"

typedef void(SDLCALL *SDL_DialogFileCallback)(void *userdata, const char * const *filelist, int filter);

DESCRIPTION¶

The specific usage is described in each function.

If filelist is... - NULL , an error occured. Details can be obtained with

SDL_GetError (). - A pointer to NULL , the user either didn't choose any file or canceled the dialog. - A pointer to non- 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 does not need to be freed; it will automatically be freed when the callback returns.

The filter argument is the index of the filter that was selected, or one more than the size of the list (therefore the index of the terminating NULL entry) if no filter was selected, or -1 if the platform or method doesn't support fetching the selected filter or if an error occured.

AVAILABILITY¶

This datatype is available since SDL 3.0.0.

SEE ALSO¶

SDL_DialogFileFilter(3type), SDL_ShowOpenFileDialog(3), SDL_ShowSaveFileDialog(3), SDL_ShowOpenFolderDialog(3)