FreeBSD Manual Pages
XmtWaitUntilMapped(3) Library Functions Manual XmtWaitUntilMapped(3) NAME XmtWaitUntilMapped() - process events until a dialog becomes mapped. SYNOPSIS #include <Xmt/Xmt.h> 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 par- ent 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 actu- ally 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 process- ing 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(). Xmt Motif Tools XmtWaitUntilMapped(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtWaitUntilMapped&sektion=3&manpath=FreeBSD+Ports+15.0>