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 char *input_dialog_help (const char *header, const char *text, const char *help,
  36                          const char *history_name, const char *def_text, gboolean strip_password);
  37 char *input_expand_dialog (const char *header, const char *text,
  38                            const char *history_name, const char *def_text);
  39
  40 int query_dialog (const char *header, const char *text, int flags, int count, ...);
  41 void query_set_sel (int new_sel);
  42
  43 /* Create message box but don't dismiss it yet, not background safe */
  44 struct WDialog *create_message (int flags, const char *title,
  45                                 const char *text, ...) __attribute__ ((format (__printf__, 3, 4)));
  46
  47 /* Show message box, background safe */
  48 void message (int flags, const char *title, const char *text, ...)
  49     __attribute__ ((format (__printf__, 3, 4)));
  50
  51 /*** inline functions ****************************************************************************/
  52
  53 #endif /* MC__WTOOLS_H */