Function SDL_ShowFileDialogWithProperties
pub unsafe extern "C" fn SDL_ShowFileDialogWithProperties(
type: SDL_FileDialogType,
callback: Option<unsafe extern "C" fn(_: *mut c_void, _: *const *const i8, _: i32)>,
userdata: *mut c_void,
props: u32,
)Available on crate feature
dep_sdl3 only.Expand description
Create and launch a file dialog with the specified properties.
These are the supported properties:
SDL_PROP_FILE_DIALOG_FILTERS_POINTER: a pointer to a list ofSDL_DialogFileFilterstructs, which will be used as filters for file-based selections. Ignored if the dialog is an “Open Folder” dialog. If non-NULL, the array of filters must remain valid at least until the callback is invoked.SDL_PROP_FILE_DIALOG_NFILTERS_NUMBER: the number of filters in the array of filters, if it exists.SDL_PROP_FILE_DIALOG_WINDOW_POINTER: the window that the dialog should be modal for.SDL_PROP_FILE_DIALOG_LOCATION_STRING: the default folder or file to start the dialog at.SDL_PROP_FILE_DIALOG_MANY_BOOLEAN: true to allow the user to select more than one entry.SDL_PROP_FILE_DIALOG_TITLE_STRING: the title for the dialog.SDL_PROP_FILE_DIALOG_ACCEPT_STRING: the label that the accept button should have.SDL_PROP_FILE_DIALOG_CANCEL_STRING: the label that the cancel button should have.
Note that each platform may or may not support any of the properties.
§Parameters
type: the type of file dialog.callback: a function pointer to be invoked when the user selects a file and accepts, or cancels the dialog, or an error occurs.userdata: an optional pointer to pass extra data to the callback when it will be invoked.props: the properties to use.
§Thread safety
This function should be called only from the main thread. The callback may be invoked from the same thread or from a different one, depending on the OS’s constraints.
§Availability
This function is available since SDL 3.2.0.