file_select_ex(3)

NAME
file_select_ex

SYNOPSIS
#include <allegro.h>

int file_select_ex(const char *message, char *path, const char *ext, int size, int w, int h);

DESCRIPTION
Displays the Allegro file selector, with the message as caption. The path parameter contains the initial filename to display (this can be used to set the starting directory, or to provide a default filename for a save-as operation). The user selection is returned by altering the path buffer, whose maximum capacity in bytes is specified by the size parameter. Note that it should have room for at least 80 characters (not bytes), so you should reserve 6x that amount, just to be sure. The list of files is filtered according to the file extensions in the ext parameter. Passing NULL includes all files; "PCX;BMP" includes only files with one of the fields in the extension list can begin with a slash, followed by a set of attribute characters. Any attributes written on their own, or with a + before them, indicate to include only files which have that attribute set. Any attributes with a '-' before them indicate to leave out any files with that attribute. The flag characters are 'r' (read-only), 'h' (hidden), 's' (system), 'd' (directory), and 'a' (archive). For example, an extension string of "PCX;BMP;/+r-d" will display only PCX or BMP files that are read-only, and no directories. The file selector is stretched to the width and height specified in the w and h parameters, and to the size of the standard Allegro font. If either the width or height argument is set to zero, it is stretched to the corresponding screen dimension. This function returns zero if it was closed with the Cancel button or non-zero if it was OK'd.

SEE ALSO
gui_fg_color(3)