XltWorking(3X)															    XltWorking(3X)

NAME

       XltWorking - Convenience function to display a Working dialog, and update the bar graph in the dialog.

SYNOPSIS

       #include <Xlt/Xlt.h>

       Boolean XltWorking(widget, question, percent_done)
	    Widget    widget;
	    String    question;
	    int       percentdone;

DESCRIPTION

       XltWorking  Creates  a  dialog  containing  a  message string, a bar showing the percentage of the task complete, and an abort button. When
       called with a percent_done value of zero the dialog is managed, and a timer installed to update the bar every second. If  question  is  not
       NULL,  the message string in the dialog is set to this. When called with a percent_done of 100, the dialog is un-managed.  If called with a
       percent_done of -1, only the message is changed. Any value between 0 and 100 will cause the bar graph to be updated the next time the timer
       fires, and processes any pending timer and X events. If the return value is True, the user has requested that the task should be aborted.

       widget The widget to wait for.

       question
	      The message to display in the working dialog. Or NULL, meaning no change.

       percent_done
	      The  percentage  of  the	task complete. 0 will cause the dialog to be managed.  100 will cause the dialog to be un-managed. -1 will
	      update the question only.  Any value between 0 and 100 will update the bar graph.

RETURN VALUE

       Boolean, if True the abort button was pushed, or the window was closed by the window manager.

RELATED INFORMATION

																    XltWorking(3X)