BOOTSTRAP (kutils) functions
LIBRARY ROUTINE
kset_savehandler - set the save handling routine used by ksave()
LIBRARY CALL
knotify kset_savehandler(
knotify new_handler)
INPUT
- new_handler - the save handler to be called. Specify
xvu_save_wait() for the Khoros pop-up quit
message (xvroutines & hybrid routines only),
NULL for the default quit handler which returns
TRUE that the user wants to save changes.
OUTPUT
none
RETURN VALUE
the previously installed save handler, or NULL
if the default save handler was installed.
DESCRIPTION
Sets the save handler routine to be used by the ksave()
reporting facility. When set to NULL (the default) the
default Khoros save handler is used, which does not prompt
the user but simply returns yes, the user wants to save changes
made to the application.
If a different save handler is set, the save handler
must be declared as follows. It should return 2 if the
user wants to save changes, 1 if the user wants to discard
changes, 0 if the user wants to cancel the operation.
int save_handler(
char *message)
char *message - message asking user if they want to save
changes to (some file) that were made during
the run of the program.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$BOOTSTRAP/objects/library/kutils/src/notify.c
SEE ALSO
kutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.