File dialog box

This is a file requestor dialog box that uses the cygwin file system. Download filebox.tar.gz and read the README for linking and using.

The filebox code provides the following functions:

int filebox_dialog(char *dialog_title, char *file_ext, int ext_strip, int save_flag, char *default_name, int default_size, char *full_name, int full_size);

• dialog_title character string to use as dialog title bar
• file_ext character string of file extensions to use, separated by semicolons (include the dot, e.g. ".c" or ".c;.cxx"). The file extensions are not case-sensitive. The first extension (if there is one) is appended to any filename returned that doesn't match any of the file extensions.
• ext_strip FILEBOX_STRIP to strip file_ext from filenames shown, or FILEBOX_NO_STRIP to leave them. It is not advisable to use this flag where multiple extensions have been given.
• save_flag FILEBOX_SAVE to indicate a save dialog (query if filename exists), or FILEBOX_LOAD for a load dialog (query if filename doesn't exist)
• default_name character string containing default filename for dialog. This string is overwritten with the current filename if one is selected
• default_size the size of the buffer pointed to by default_name
• full_name character string that is overwritten with the full path and filename if one is selected
• full_size the size of the buffer pointed to by full_name
• return value FILEBOX_OK if a valid filename has been chosen, or FILEBOX_CANCELLED if not. If the name buffers are not large enough to set the chosen path and filename then the function fails and returns FILEBOX_OVERFLOW

void filebox_set_path(char *path_name);

• path_name character string containing a valid path

int filebox_get_path(char *path_name, int buffer_size);

• path_name character buffer for receiving the current path
• buffer_size the size of the buffer pointed to by path_name
• return value 0 if path_name has been successfully set, otherwise the return value is the required size of the buffer