Provided by: allegro5-doc_5.0.10-2_all
al_create_native_file_dialog - Allegro 5 API
#include <allegro5/allegro_native_dialog.h> ALLEGRO_FILECHOOSER *al_create_native_file_dialog( char const *initial_path, char const *title, char const *patterns, int mode)
Creates a new native file dialog. You should only have one such dialog opened at a time. Parameters: · initial_path: The initial search path and filename. Can be NULL. To start with a blank file name the string should end with a directory separator (this should be the common case). · title: Title of the dialog. · patterns: A list of semi-colon separated patterns to match. You should always include the pattern "*.*" as usually the MIME type and not the file pattern is relevant. If no file patterns are supported by the native dialog, this parameter is ignored. · mode: 0, or a combination of the flags below. Possible flags for the 'flags' parameter are: ALLEGRO_FILECHOOSER_FILE_MUST_EXIST If supported by the native dialog, it will not allow entering new names, but just allow existing files to be selected. Else it is ignored. ALLEGRO_FILECHOOSER_SAVE If the native dialog system has a different dialog for saving (for example one which allows creating new directories), it is used. Else ignored. ALLEGRO_FILECHOOSER_FOLDER If there is support for a separate dialog to select a folder instead of a file, it will be used. ALLEGRO_FILECHOOSER_PICTURES If a different dialog is available for selecting pictures, it is used. Else ignored. ALLEGRO_FILECHOOSER_SHOW_HIDDEN If the platform supports it, also hidden files will be shown. ALLEGRO_FILECHOOSER_MULTIPLE If supported, allow selecting multiple files. Returns: A handle to the dialog which you can pass to al_show_native_file_dialog(3alleg5) to display it, and from which you then can query the results. When you are done, call al_destroy_native_file_dialog(3alleg5) on it. If a dialog window could not be created then this function returns NULL.