ref: 02fc812eff2d8e83887e3b149533e2ed3f95879f
dir: /textscreen/txt_fileselect.h/
// // Copyright(C) 2005-2014 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. // // // Routines for selecting files, and the txt_fileselect_t widget. // #ifndef TXT_FILESELECT_H #define TXT_FILESELECT_H /** * @file txt_fileselect.h * * File selection widget. */ /** * File selection widget. * * A file selection widget resembles an input box (@ref txt_inputbox_t) * but opens a file selector dialog box when clicked. */ 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 prompt 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(const char *prompt, const char **extensions); /** * Create a new txt_fileselect_t widget. * * @param variable Pointer to a char * variable in which the selected * file should be stored (UTF-8 format). * @param size Width of the file selector widget in characters. * @param prompt 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, const char *prompt, const char **extensions); /** * Special value to use for 'extensions' that selects a directory * instead of a file. */ extern const char *TXT_DIRECTORY[]; #endif /* #ifndef TXT_FILESELECT_H */