- 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 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.
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.
Callback used by file dialog functions.
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 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.
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.