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


Manual Reference Pages  -  XMTWORKINGBOX (3)

NAME

XmtWorkingBox - a widget for ‘‘please wait’’ dialogs.

CONTENTS

SYNOPSIS

Include File: #include <Xmt/WorkingBox.h>
Constructor: XmtCreateWorkingBox()
XmtCreateWorkingDialog()
Class Name: XmtWorkingBox
Class Pointer: xmtWorkingBoxWidgetClass
Class Hierarchy: Core -> XmManager -> XmBulletinBoard -> XmtWorkingBox

DESCRIPTION

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.

RESOURCES

XmtWorkingBox inherits the resources of the XmBulletinBoard class, and defines the following new resources:

NameTypeClassAccessDefault
XmtNbuttonLabelXtRStringXmtCButtonLabelCSG”Stop“
XmtNbuttonWidgetXtRWidgetXtCReadOnlyGN.A.
XmtNiconXtRPixmapXmtCIconCSGNone
XmtNmessageXtRStringXmtCMessageCSGNULL
XmtNscaleLabelXtRStringXmtCScaleLabelCSG”% Complete:“
XmtNscaleMaxXtRIntXmtCScaleMaxCSG100
XmtNscaleMinXtRIntXmtCScaleMinCSG0
XmtNscaleValueXtRIntXmtCScaleValueCSG0
XmtNscaleWidgetXtRWidgetXtCReadOnlyGN.A.
XmtNshowButtonXtRBooleanXmtCShowButtonCSGTrue
XmtNshowScaleXtRBooleanXmtCShowScaleCSGTrue
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.
CALLBACKS
The WorkingBox widget defines no callback list resources.

TRANSLATIONS
The WorkingBox widget defines no new translations or actions.

SEE ALSO

Chapter 31, Busy States and Background Work,
XmtCreateWorkingBox(), XmtCreateWorkingDialog(), XmtDisplayBusyCursor(), XmtDisplayDefaultCursor(), XmtDisplayWorkingDialog(), XmtHideWorkingDialog(), XmtWaitUntilMapped(), XmtWorkingBoxHandleEvents(), XmtWorkingBoxSetScaleValue().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTWORKINGBOX (3) Motif Tools

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