DESIGN (xvobjects) functions
LIBRARY ROUTINE
xvw_create_error - create an error object
LIBRARY CALL
xvobject xvw_create_error(
xvobject parent,
char *name)
INPUT
- parent - parent of the error widget; 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 error object on success, NULL on failure
DESCRIPTION
The error object is
a pop-up window that displays an error message.
A stop sign icon on the upper left hand side of
the error object draws the attention of the user;
a single button on the upper right hand side of
the error object allows the user to acknowledge
the error message.
After the user clicks on the acknowledgment button,
the error object is destroyed.
A callback can be installed on the error 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/Error.c
SEE ALSO
xvobjects(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.