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 `.PCX' or `.BMP' extensions. If you wish to control files by  their  attributes,
       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), `h' (hidden), `s' (system), `d' (directory)  and
       `a'  (archive).  For  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(3alleg4)

Allegro                                           version 4.4.3                          file_select_ex(3alleg4)