DESIGN (xvobjects) functions
LIBRARY ROUTINE
xvw_create_warn - create a warning object
LIBRARY CALL
xvobject xvw_create_warn(
xvobject parent,
char *name)
INPUT
- parent - parent of the warn object; NULL will cause
a default toplevel to be created automatically
- name - a name for this particular instance of the object
(for use in app-defaults files, etc)
OUTPUT
none
RETURN VALUE
The warn widget on success, NULL on failure
DESCRIPTION
Creates a warning object. The warning object is
a pop-up window that displays a warning message.
A warn icon on the upper left hand side of
the warning object draws the attention of the user;
a single button on the upper right hand side of
the warning object allows the user to acknowledge
the warning.
After the user clicks on the acknowledgment button,
the warning object is destroyed.
A callback can be installed on the warning object, which
will be fired when the user clicks on the acknowledgment
button.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
none
MODIFICATION
none
FILES
$DESIGN/objects/library/xvobjects/src/Warn.c
SEE ALSO
xvobjects(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.