DESIGN (xvutils) functions
LIBRARY ROUTINE
xvu_quit_wait - pop up a quit dialog box; wait for response
LIBRARY CALL
int xvu_quit_wait(
char *string,
char *quit_label,
char *cancel_label)
INPUT
- string - Optional string for first line of
label; if non-NULL, will replace
"Please Confirm Exit\nExit program?"
- quit_label - Optional label for button which returns
value of 1; if non-NULL, will replace label
of "Exit" on first button
- cancel_label - Optional label for button which returns
value of 0; if non-NULL, will replace label
of "Cancel" on first button
OUTPUT
none
RETURN VALUE
1 if user selected "Exit" (first) button
0 if user selected "Cancel" (second) button
DESCRIPTION
Creates and maps a pop-up quit dialog box which looks like:
-------------------------------
| |
| Please Confirm Exit |
| Exit program? |
| |
- - - - - - - - - - - - - - - -
| -------- ---------- |
| | Exit | | Cancel | |
| -------- ---------- |
-------------------------------
The quit dialog box will block input to the application until
it is acknowledged by the user. The user must click on
"Exit" or "Cancel" before control will be returned to
the application program.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvutils/src/quit.c
SEE ALSO
xvutils(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.