lib/widget/wtools.h

   1 /** \file wtools.h
   2  *  \brief Header: widget based utility functions
   3  */
   4
   5 #ifndef MC__WTOOLS_H
   6 #define MC__WTOOLS_H
   7
   8 /*** typedefs(not structures) and defined constants **********************************************/
   9
  10 /* Pass this as def_text to request a password */
  11 #define INPUT_PASSWORD ((char *) -1)
  12
  13 /* Use this as header for message() - it expands to "Error" */
  14 #define MSG_ERROR ((char *) -1)
  15
  16 /*** enums ***************************************************************************************/
  17
  18 /* flags for message() and query_dialog() */
  19 enum
  20 {
  21     D_NORMAL = 0,
  22     D_ERROR = (1 << 0),
  23     D_CENTER = (1 << 1)
  24 } /* dialog options */ ;
  25
  26 /*** structures declarations (and typedefs of structures)*****************************************/
  27
  28 /*** global variables defined in .c file *********************************************************/
  29
  30 /*** declarations of public functions ************************************************************/
  31
  32 /* The input dialogs */
  33 char *input_dialog (const char *header, const char *text,
  34                     const char *history_name, const char *def_text,
  35                     input_complete_t completion_flags);
  36 char *input_dialog_help (const char *header, const char *text, const char *help,
  37                          const char *history_name, const char *def_text, gboolean strip_password,
  38                          input_complete_t completion_flags);
  39 char *input_expand_dialog (const char *header, const char *text, const char *history_name,
  40                            const char *def_text, input_complete_t completion_flags);
  41
  42 int query_dialog (const char *header, const char *text, int flags, int count, ...);
  43 void query_set_sel (int new_sel);
  44
  45 /* Create message box but don't dismiss it yet, not background safe */
  46 struct WDialog *create_message (int flags, const char *title,
  47                                 const char *text, ...) __attribute__ ((format (__printf__, 3, 4)));
  48
  49 /* Show message box, background safe */
  50 void message (int flags, const char *title, const char *text, ...)
  51     __attribute__ ((format (__printf__, 3, 4)));
  52
  53 /*** inline functions ****************************************************************************/
  54
  55 #endif /* MC__WTOOLS_H */