Provided by: liballegro-doc_4.2.2-3_all bug

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)