|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtWaitUntilMapped(3) | FreeBSD Library Functions Manual | XmtWaitUntilMapped(3) |
NAME
XmtWaitUntilMapped() - process events until a dialog becomes mapped.SYNOPSIS
void XmtWaitUntilMapped(Widget w)
ARGUMENTS
INPUTS- w
- Any descendant of the dialog which is being mapped.
DESCRIPTION
XmtWaitUntilMapped() finds the immediate shell ancestor of w, and processes events in an internal event loop until that shell widget becomes visible on the screen, or until the shell's TopLevelShell parent becomes non-visible (because if the main window is iconified, the dialog will be iconified too, and will never become visible). It then processes all pending Expose events and returns.Because window managers must decorate and manage dialog boxes, there is an unpredictable delay between the time that a dialog box is popped up (with XtManageChild() or XtPopup()) and the time that the dialog actually appears on the screen and has its first Expose event generated. XmtWaitUntilMapped() guarantees that the specified dialog box has appeared on the screen and has been drawn (i.e. has had its Expose events handled) before it returns.
This function is most useful when you plan to do some lengthy processing without servicing events, and want to display a ``please wait'' dialog to the user. If you do not call XmtWaitUntilMapped(), the dialog box will appear, but will appear blank (i.e. will not have its Expose events processed) until the lengthy processing is done. Note that the function XmtDisplayWorkingDialog() already calls XmtWaitUntilMapped(), so you should rarely need to call this function explicitly.
SEE ALSO
Chapter 31, Busy States and Background Work, XmtWorkingBox, XmtDisplayWorkingDialog().| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.