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 occurred. 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 array of pointers to UTF-8 encoded 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.

       In Android, the filelist are content://  URIs.  They  should  be  opened  using  SDL_IOFromFile  ()  with
       appropriate modes. This applies both to open and save file dialog.

FUNCTION PARAMETERS

       userdata
              an app-provided pointer, for the callback's use.

       filelist
              the file(s) chosen by the user.

       filter index of the selected filter.

AVAILABILITY

       This datatype is available since SDL 3.2.0.

SEE ALSO

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

Simple Directmedia Layer                            SDL 3.2.8                      SDL_DialogFileCallback(3type)