1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159/* * Guillaume Cottenceau (gc@mandrakesoft.com) * * Copyright 2000 Mandrakesoft * * This software may be freely redistributed under the terms of the GNU * public license. * * 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., 675 Mass Ave, Cambridge, MA 02139, USA. * */ /* * Using high-level UI. * * These functions are frontend-independant: your program won't know each * `frontend' (e.g. each way to grab user input) will be used. * * Then you may link your binary against any `frontend' that implement all * these functions (and possibly necessary libraries). */ #ifndef _FRONTEND_H_ #define _FRONTEND_H_ /* this must be called before anything else */ void init_frontend(void); /* this must be called before exit of program */ void finish_frontend(void); void info_message(char *msg, ...) __attribute__ ((format (printf, 1, 2))); /* (blocks program) */ void error_message(char *msg, ...) __attribute__ ((format (printf, 1, 2))); /* (blocks program) */ /* (doesn't block program) * (this is not necessarily stackable, e.g. only one wait_message at a time) */ void wait_message(char *msg, ...) __attribute__ ((format (printf, 1, 2))); /* call this to finish the wait on wait_message */ void remove_wait_message(void); /* monitor progression of something (downloading a file, etc) * if size of progression is unknown, use `0' */ void init_progression(char *msg, int size); void update_progression(int current_size); void end_progression(void); enum frontend_return { RETURN_OK, RETURN_BACK, RETURN_ERROR }; /* Yes == RETURN_OK No == RETURN_ERROR Back == RETURN_BACK */ enum frontend_return ask_yes_no(char *msg); /* [elems] NULL terminated array of char* * [choice] address of a (unitialized) char* */ enum frontend_return ask_from_list(char *msg, char ** elems, char ** choice); enum frontend_return ask_from_list_comments(char *msg, char ** elems, char ** elems_comments, char ** choice); /* [questions] NULL terminated array of char* * [answers] address of a (unitialized) char**, will contain a non-NULL terminated array of char* * [callback_func] function called at most when the answers change; it can examine the array of char* and assign some new char* */ enum frontend_return ask_from_entries(char *msg, char ** questions, char *** answers, int entry_size, void (*callback_func)(char ** strings)); #endif |
