|
@@ -104,16 +104,16 @@ typedef void(SDLCALL *SDL_DialogFileCallback)(void *userdata, const char * const
|
|
|
* \param callback An SDL_DialogFileCallback to be invoked when the user
|
|
|
* selects a file and accepts, or cancels the dialog, or an
|
|
|
* error occurs. The first argument is a null-terminated list
|
|
|
- * of C strings, representing the paths chosen by the user. The
|
|
|
- * list will be empty if the user canceled the dialog, and it
|
|
|
- * will be NULL if an error occured. If an error occured, it
|
|
|
- * can be fetched with SDL_GetError(). The second argument is
|
|
|
- * the userdata pointer passed to the function. The third
|
|
|
- * argument is the index of the filter selected by the user, or
|
|
|
- * one past the index of the last filter (therefore the index
|
|
|
- * of the terminating NULL filter) if no filter was chosen, or
|
|
|
- * -1 if the platform does not support detecting the selected
|
|
|
- * filter.
|
|
|
+ * of C strings, representing the paths chosen by the user.
|
|
|
+ * The list will be empty if the user canceled the dialog, and
|
|
|
+ * it will be NULL if an error occured. If an error occured,
|
|
|
+ * it can be fetched with SDL_GetError(). The second argument
|
|
|
+ * is the userdata pointer passed to the function. The third
|
|
|
+ * argument is the index of the filter selected by the user,
|
|
|
+ * or one past the index of the last filter (therefore the
|
|
|
+ * index of the terminating NULL filter) if no filter was
|
|
|
+ * chosen, or -1 if the platform does not support detecting
|
|
|
+ * the selected filter.
|
|
|
* \param userdata An optional pointer to pass extra data to the callback when
|
|
|
* it will be invoked.
|
|
|
* \param window The window that the dialog should be modal for. May be NULL.
|
|
@@ -156,16 +156,16 @@ extern DECLSPEC void SDLCALL SDL_ShowOpenFileDialog(SDL_DialogFileCallback callb
|
|
|
* \param callback An SDL_DialogFileCallback to be invoked when the user
|
|
|
* selects a file and accepts, or cancels the dialog, or an
|
|
|
* error occurs. The first argument is a null-terminated list
|
|
|
- * of C strings, representing the paths chosen by the user. The
|
|
|
- * list will be empty if the user canceled the dialog, and it
|
|
|
- * will be NULL if an error occured. If an error occured, it
|
|
|
- * can be fetched with SDL_GetError(). The second argument is
|
|
|
- * the userdata pointer passed to the function. The third
|
|
|
- * argument is the index of the filter selected by the user, or
|
|
|
- * one past the index of the last filter (therefore the index
|
|
|
- * of the terminating NULL filter) if no filter was chosen, or
|
|
|
- * -1 if the platform does not support detecting the selected
|
|
|
- * filter.
|
|
|
+ * of C strings, representing the paths chosen by the user.
|
|
|
+ * The list will be empty if the user canceled the dialog, and
|
|
|
+ * it will be NULL if an error occured. If an error occured,
|
|
|
+ * it can be fetched with SDL_GetError(). The second argument
|
|
|
+ * is the userdata pointer passed to the function. The third
|
|
|
+ * argument is the index of the filter selected by the user,
|
|
|
+ * or one past the index of the last filter (therefore the
|
|
|
+ * index of the terminating NULL filter) if no filter was
|
|
|
+ * chosen, or -1 if the platform does not support detecting
|
|
|
+ * the selected filter.
|
|
|
* \param userdata An optional pointer to pass extra data to the callback when
|
|
|
* it will be invoked.
|
|
|
* \param window The window that the dialog should be modal for. May be NULL.
|
|
@@ -206,11 +206,11 @@ extern DECLSPEC void SDLCALL SDL_ShowSaveFileDialog(SDL_DialogFileCallback callb
|
|
|
* \param callback An SDL_DialogFileCallback to be invoked when the user
|
|
|
* selects a file and accepts, or cancels the dialog, or an
|
|
|
* error occurs. The first argument is a null-terminated list
|
|
|
- * of C strings, representing the paths chosen by the user. The
|
|
|
- * list will be empty if the user canceled the dialog, and it
|
|
|
- * will be NULL if an error occured. If an error occured, it
|
|
|
- * can be fetched with SDL_GetError(). The second argument is
|
|
|
- * the userdata pointer passed to the function. The third
|
|
|
+ * of C strings, representing the paths chosen by the user.
|
|
|
+ * The list will be empty if the user canceled the dialog, and
|
|
|
+ * it will be NULL if an error occured. If an error occured,
|
|
|
+ * it can be fetched with SDL_GetError(). The second argument
|
|
|
+ * is the userdata pointer passed to the function. The third
|
|
|
* argument is always -1 for SDL_ShowOpenFolderDialog.
|
|
|
* \param userdata An optional pointer to pass extra data to the callback when
|
|
|
* it will be invoked.
|