|Include File:||#include <Xmt/WorkingBox.h>|
|Class Hierarchy:||Core -> XmManager -> XmBulletinBoard -> XmtWorkingBox|
The XmtWorkingBox widget is a compound widget intended to be displayed when the application must perform a lengthy computation or other task which prevents normal processing of events. It provides feedback to the user that the application is busy and that she should not try to interact with it normally. The WorkingBox is designed to provide more sophisticated working dialogs than is possible with the Motif XmCreateWorkingDialog() function (which simply creates an XmMessageBox widget with an hourglass icon). The WorkingBox widget displays its own please wait icon, and a message, just like an XmMessageBox, but it also optionally displays a labeled XmScale widget that can be used to provide feedback on the progress of what ever task the application is performing, and optionally displays an XmPushButton widget that the user can use to abort the task.
XmtWorkingBox inherits the resources of the XmBulletinBoard class, and defines the following new resources:
Name Type Class Access Default XmtNbuttonLabel XtRString XmtCButtonLabel CSG Stop XmtNbuttonWidget XtRWidget XtCReadOnly G N.A. XmtNicon XtRPixmap XmtCIcon CSG None XmtNmessage XtRString XmtCMessage CSG NULL XmtNscaleLabel XtRString XmtCScaleLabel CSG % Complete: XmtNscaleMax XtRInt XmtCScaleMax CSG 100 XmtNscaleMin XtRInt XmtCScaleMin CSG 0 XmtNscaleValue XtRInt XmtCScaleValue CSG 0 XmtNscaleWidget XtRWidget XtCReadOnly G N.A. XmtNshowButton XtRBoolean XmtCShowButton CSG True XmtNshowScale XtRBoolean XmtCShowScale CSG True
XmtNbuttonLabel The label to appear in the XmPushButton widget child of the WorkingBox, if XmtNshowButton is True. XmtNbuttonWidget A read-only resource that may be queried to get a handle to the XmPushButton child of the WorkingBox. This widget is created (but left unmanaged) even if XmtNshowButton is False. XmtNicon The pixmap to display in the upper left of the widget. If None is specified, the WorkingBox will use its default icon-a clock face. XmtNmessage The message string to appear in the WorkingBox. Note that this resource is a String, not an XmString. It is converted internally to an XmString with the function XmtCreateXmString(), and so may include the newline character to begin a new line, and may include the @f escape sequence to change fonts. See XmtCreateXmString() for more information. XmtNscaleLabel The label to appear to the left of the XmScale child of the WorkingBox, if XmtNshowScale is True. XmtNscaleMax The maximum value to be displayed by the XmScale child of the WorkingBox. XmtNscaleMin The minimum value to be displayed by the XmScale child of the WorkingBox. XmtNscaleValue The value to be displayed by the XmScale child of the WorkingBox. XmtNscaleWidget A read-only resource that can be queried to get a handle to the XmScale child of the WorkingBox. The XmScale child is created (but left unmanaged) even if XmtNshowScale is False. XmtNshowButton Specifies whether the XmPushButton child should be visible in the dialog. XmtNshowScale Specifies whether the XmScale child should be visible in the dialog.
The WorkingBox widget defines no callback list resources.
The WorkingBox widget defines no new translations or actions.
Chapter 31, Busy States and Background Work,
XmtCreateWorkingBox(), XmtCreateWorkingDialog(), XmtDisplayBusyCursor(), XmtDisplayDefaultCursor(), XmtDisplayWorkingDialog(), XmtHideWorkingDialog(), XmtWaitUntilMapped(), XmtWorkingBoxHandleEvents(), XmtWorkingBoxSetScaleValue().
|Xmt||XMTWORKINGBOX (3)||Motif Tools|