DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_error - create an error object

LIBRARY CALL

xvobject xvw_create_error(
   xvobject parent,
   char     *name)

INPUT

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.