home | help
XmtDisplayBusyCursor(3)     Library Functions Manual	 XmtDisplayBusyCursor(3)

NAME
     XmtDisplayBusyCursor(),   XmtDisplayDefaultCursor(),  XmtDisplayCursor()  -
     display a cursor over a window.

SYNOPSIS
     #include <Xmt/Xmt.h>

     void XmtDisplayBusyCursor(Widget w)

     void XmtDisplayDefaultCursor(Widget w)

     void XmtDisplayCursor(Widget w, Cursor c)

ARGUMENTS
     INPUTS

	  w	 Any widget descendant of the shell that is to have  its  cursor
		 set.

	  c	 For XmtDisplayCursor(), the cursor that is to be displayed.

DESCRIPTION
     XmtDisplayBusyCursor()  displays a ``please wait'' cursor for the window of
     the immediate shell widget ancestor of the widget w. It calls XFlush()  in-
     ternally  after  setting  the  cursor  to guarantee that the cursor will be
     changed before the function returns. The cursor that is used  is  specified
     by  the  busyCursor  application resource; the default for this resource is
     the standard X ``wristwatch'' cursor.

     XmtDisplayDefaultCursor() is designed for use  with  XmtDisplayBusyCursor()
     and  ``restores''	(or sets for the first time) the cursor specified by the
     cursor application resource. The default value of this resource  is  None-a
     cursor  of None means that the cursor displayed will depend upon the window
     manager.

     XmtDisplayCursor() displays cursor c for the shell specified by w.

     Each of these functions affect the nearest shell ancestor of  the	supplied
     widget.  Setting  the  cursor of a shell widget will also set the cursor of
     any descendant widgets that do not have some other cursor	explicitly  set.
     If  there	are  widgets  in your hierarchy that do have a cursor explicitly
     set, this function will have no effect on them.

SEE ALSO
     Chapter 31, Busy States and Background Work.

Xmt				   Motif Tools		 XmtDisplayBusyCursor(3)

home | help