DESIGN (xvobjects) functions


LIBRARY ROUTINE

xvw_create_notifywindow - create a notifywindow object

LIBRARY CALL

xvobject xvw_create_notifywindow(
   xvobject parent,
   char     *name)

INPUT

OUTPUT

none

RETURN VALUE

The notifywindow object on success, NULL on failure

DESCRIPTION

The notifywindow object provides a convenient mechanism for the application to notify the user when it is performing an operation that will take some time, and that the user is expected to wait patiently until it is done.

The notifywindow object pops up without placement; it contains an icon (by default, an hourglass), a label, and a message so that the application may inform the user exactly why they are waiting.

With applications that will use the notifywindow periodically, it is recommended that a single notifywindow be created for the application on startup, with XVW_NOTIFYWINDOW_VISIBLE set to FALSE. Then, whenever necessary, the message displayed by the notifywindow can be updated using the XVW_NOTIFYWINDOW_MESSAGE attribute, and the notifywindow object popped up using the XVW_NOTIFYWINDOW_VISIBLE attribute. When the application is done, XVW_NOTIFYWINDOW_VISIBLE can be set to FALSE again, until the next time the notifywindow object is to be popped up.

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

none

MODIFICATION

none

FILES

$DESIGN/objects/library/xvobjects/src/NotifyWindow.c

SEE ALSO

xvobjects(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.