file_select_ex

file_select_ex(3alleg4)          Allegro manual          file_select_ex(3alleg4)



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)