NAME
file_select_ex - Displays the Allegro file selector with a caption.
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
attribute written on its own, or with a '+' before it, indicates to
include only files which have that attribute set. Any attribute with a
'-' before it indicates to leave out any files with that attribute. The
flag characters are 'r' (read-only), example, an extension string of
"PCX;BMP;/+r-h" will display only PCX or BMP files that are read-only
and not hidden. The directories are not affected in the same way as the
other files by the extension string: the extensions are never taken
into account for them and the other attributes are taken into account
only when 'd' is mentioned in the string; in other words, all
directories are included when 'd' is not mentioned in the string. 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(3alleg)