DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_warn - create a warning object

LIBRARY CALL

xvobject xvw_create_warn(
   xvobject parent,
   char     *name)

INPUT

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.