This is the Progress widget, for displaying the proportion of a task that is
complete. It has optional percentage and time-elapsed and time-to-complete
indicators.

Progess is subclassed from XmPrimitive and Core. Its class pointer is
xrhpProgressWidgetClass. Its class name is XrhpProgress.

The Progress widget defines the following new resources:

	Name		Class		Type		Default		Access

	XmNmaxValue	XmCMaxValue	int		100		CSG
	XmNshowPercent	XMCShowPercent	Boolean		False		CSG
	XmNshowTime	XmCShowTime	Boolean		True		CSG
	XmNvalue	XmCValue	int		0		CSG
	XmNfont		XmCFont		XFontStruct *	XtDefaultFont	CSG

	XmNmaxValue
		The maximum value allowed for the XmNvalue resource. When
		XmNvalue == XmNmaxValue, the widget is shows 100% complete,
		and the progress bar will fill the widget.

	XmNshowPercent
		If set to True, the percentage complete will be shown as text
		centred in the widget.

	XmNshowTime
		If set to True, the time taken so far is displayed on the left
		of the widget, and the estimated time remaining is shown on
		the right.

	XmNvalue
		The current value from 0 to XmNmaxValue, defining how much
		progress has taken place. When this value is set to 0, the
		elapsed time is set to zero.

	XmNfont
		The font used to display the times and the percentage text.

Example usage:

#include "Progress.h"

progress=XtVaCreateManagedWidget("progress",
		xrhpProgressWidgetClass, parent,
		XmNwidth, 200,
		XmNheight, 20,
		XmNmaxValue, 200,
		XmNshowPercent, True,
		XtVaTypedArg, XmNfont, XmRString, "-*-helvetica-bold-r-*--*-100-*-*-*-*-iso8859-1", 47,
		NULL);

The value of the widget can be set using XtVaSetValues(), or by the convenience
function

	XrhpProgressSetValue(widget, new_value);

(The convenience function causes less flicker than happens by using the set
values function).


Mail any bug reports to Dick Porter <dick@cymru.net>