/* Displaying messages and getting input for WWW Library ** ===================================================== ** ** May 92 Created By C.T. Barker ** Feb 93 Portablized etc TBL */ #ifndef HTALERT_H #define HTALERT_H 1 #include #define ALERT_PREFIX_LEN 5 /* Display a message and get the input ** ** On entry, ** Msg is the message. ** ** On exit, ** Return value is malloc'd string which must be freed. */ extern char * HTPrompt PARAMS((CONST char * Msg, CONST char * deflt)); /* Display a message, don't wait for input ** ** On entry, ** The input is a list of parameters for printf. */ extern void HTAlert PARAMS((CONST char * Msg)); extern void HTAlwaysAlert PARAMS((CONST char * extra_prefix, CONST char * Msg)); extern void HTInfoMsg PARAMS((CONST char * Msg)); extern void HTUserMsg PARAMS((CONST char * Msg)); extern void HTUserMsg2 PARAMS((CONST char * Msg, CONST char * Arg)); /* Display a progress message for information (and diagnostics) only ** ** On entry, ** The input is a list of parameters for printf. */ extern CONST char *HTProgressUnits PARAMS((int kilobytes)); extern void HTProgress PARAMS((CONST char * Msg)); extern void HTReadProgress PARAMS((long bytes, long total)); #define _HTProgress(msg) mustshow = TRUE, HTProgress(msg) /* * Indicates whether last HTConfirm was cancelled (^G or ^C) and * resets flag. (so only call once!) - kw */ extern BOOL HTLastConfirmCancelled NOPARAMS; /* ** Supports logic for forced yes/no prompt results. */ extern int HTForcedPrompt PARAMS((int Opt, CONST char * Msg, int Dft)); /* Display a message, then wait for 'yes' or 'no', allowing default ** response if a return or left-arrow is used. ** ** On entry, ** Takes a list of parameters for printf. ** ** On exit, ** If the user enters 'YES', returns TRUE, returns FALSE ** otherwise. */ extern int HTConfirmDefault PARAMS ((CONST char * Msg, int Dft)); /* Display a message, then wait for 'yes' or 'no'. ** ** On entry, ** Takes a list of parameters for printf. ** ** On exit, ** If the user enters 'YES', returns TRUE, returns FALSE ** otherwise. */ extern BOOL HTConfirm PARAMS ((CONST char * Msg)); extern BOOL confirm_post_resub PARAMS(( CONST char* address, CONST char* title, int if_imgmap, int if_file)); /* Prompt for password without echoing the reply */ extern char * HTPromptPassword PARAMS((CONST char * Msg)); /* Prompt both username and password HTPromptUsernameAndPassword() ** --------------------------------- ** On entry, ** Msg is the prompting message. ** *username and ** *password are char pointers; they are changed ** to point to result strings. ** IsProxy should be TRUE if this is for ** proxy authentication. ** ** If *username is not NULL, it is taken ** to point to a default value. ** Initial value of *password is ** completely discarded. ** ** On exit, ** *username and *password point to newly allocated ** strings -- original strings pointed to by them ** are NOT freed. ** */ extern void HTPromptUsernameAndPassword PARAMS(( CONST char * Msg, char ** username, char ** password, BOOL IsProxy)); /* Confirm a cookie operation. HTConfirmCookie() ** --------------------------- ** ** On entry, ** server is the server sending the Set-Cookie. ** domain is the domain of the cookie. ** path is the path of the cookie. ** name is the name of the cookie. ** value is the value of the cookie. ** ** On exit, ** Returns FALSE on cancel, ** TRUE if the cookie should be set. */ extern BOOL HTConfirmCookie PARAMS(( domain_entry * dp, CONST char * server, CONST char * name, CONST char * value)); /* Confirm redirection of POST. HTConfirmPostRedirect() ** ---------------------------- ** On entry, ** Redirecting_url is the Location. ** server_status is the server status code. ** ** On exit, ** Returns 0 on cancel, ** 1 for redirect of POST with content, ** 303 for redirect as GET without content */ extern int HTConfirmPostRedirect PARAMS(( CONST char * Redirecting_url, int server_status)); extern void LYSleepAlert NOPARAMS; extern void LYSleepDebug NOPARAMS; extern void LYSleepInfo NOPARAMS; extern void LYSleepMsg NOPARAMS; extern void LYSleepReplay NOPARAMS; #ifdef HAVE_STRERROR #define LYStrerror strerror #else extern char *LYStrerror PARAMS(( int code)); #endif /* HAVE_STRERROR */ #endif /* HTALERT_H */