file_select_ex(3) Allegro manual file_select_ex(3)NAMEfile_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 charac‐
ters (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 writ‐
ten 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 charac‐
ters 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 hid‐
den. 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 parame‐
ters, 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 corre‐
sponding screen dimension. This function returns zero if it was closed
with the Cancel button or non-zero if it was OK'd.
SEE ALSOgui_fg_color(3)Allegro version 4.4.2 file_select_ex(3)
