diff options
Diffstat (limited to 'textscreen/txt_fileselect.h')
-rw-r--r-- | textscreen/txt_fileselect.h | 75 |
1 files changed, 75 insertions, 0 deletions
diff --git a/textscreen/txt_fileselect.h b/textscreen/txt_fileselect.h new file mode 100644 index 00000000..d591528e --- /dev/null +++ b/textscreen/txt_fileselect.h @@ -0,0 +1,75 @@ +// Emacs style mode select -*- C++ -*- +//----------------------------------------------------------------------------- +// +// Copyright(C) 2013 Simon Howard +// +// This program is free software; you can redistribute it and/or +// modify it under the terms of the GNU General Public License +// as published by the Free Software Foundation; either version 2 +// of the License, or (at your option) any later version. +// +// This program is distributed in the hope that it will be useful, +// but WITHOUT ANY WARRANTY; without even the implied warranty of +// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +// GNU General Public License for more details. +// +// You should have received a copy of the GNU General Public License +// along with this program; if not, write to the Free Software +// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA +// 02111-1307, USA. +// +//----------------------------------------------------------------------------- +// +// Routines for selecting files, and the txt_fileselect_t widget. +// +//----------------------------------------------------------------------------- + +#ifndef TXT_FILESELECT_H +#define TXT_FILESELECT_H + +typedef struct txt_fileselect_s txt_fileselect_t; + +/** + * Returns non-zero if a native file selector is available on this + * platform. + */ + +int TXT_CanSelectFiles(void); + +/** + * Open a native file selector to select a file. + * + * @param title Pointer to a string containing a prompt to display + * in the window. + * @param extensions NULL-terminated list of filename extensions for + * files that can be selected, or @ref TXT_DIRECTORY + * to select directories. + */ + +char *TXT_SelectFile(char *window_title, char **extensions); + +/** + * Create a new txt_fileselect_t widget. + * + * @param variable Pointer to a char * variable in which the selected + * file should be stored. + * @param size Width of the file selector widget in characters. + * @param title Pointer to a string containing a prompt to display + * in the file selection window. + * @param extensions NULL-terminated list of filename extensions that + * can be used for this widget, or @ref TXT_DIRECTORY + * to select directories. + */ + +txt_fileselect_t *TXT_NewFileSelector(char **variable, int size, + char *prompt, char **extensions); + +/** + * Special value to use for 'extensions' that selects a directory + * instead of a file. + */ + +extern char *TXT_DIRECTORY[]; + +#endif /* #ifndef TXT_FILESELECT_H */ + |