file_select_ex(3)               Allegro manual               file_select_ex(3)



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(3)



Allegro                          version 4.2.3               file_select_ex(3)
