GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
XmtWaitUntilMapped(3) FreeBSD Library Functions Manual XmtWaitUntilMapped(3)

XmtWaitUntilMapped() - process events until a dialog becomes mapped.

#include <Xmt/Xmt.h>

void XmtWaitUntilMapped(Widget w)

INPUTS
w
Any descendant of the dialog which is being mapped.

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.

Chapter 31, Busy States and Background Work, XmtWorkingBox, XmtDisplayWorkingDialog().
Motif Tools Xmt

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.