DtLockCursor(3Dt)                                  DtLockCursor(3Dt)


       NAME
             DtLockCursor - lock the cursor for an interval

       SYNOPSIS
             #include <Dt/DtLock.h>
             DtCallbackInfo *DtLockCursor(
                   Widget w,
                   unsigned long interval,
                   void (*f)(),
                   XtPointer client_data,
                   Cursor cursor
             );

       DESCRIPTION
             The DtLockCursor function is used to lock a display pointer
             for a specified amount of time.  This function can be used,
             for example, to indicate that an operation is in progress,
             where:

                   w           is the widget on the display

                   interval    is the amount of time in milliseconds to
                               lock the pointer

                   f           is the function to invoke when the pointer
                               is unlocked

                   client_data is the input to f

                   cursor      is the locked cursor

             During the lock, cursor replaces the current mouse pointer
             cursor on the display associated with w.  When the lock is
             cleared, the function f is called with the single argument
             client_data.

             The DtCallbackInfo structure includes the following members:
                   void         (*f)();
                   Display *    display;
                   XtPointer    client_data;
                   XtIntervalId timer_id;

       RETURN VALUES
             On success, DtLockCursor returns a pointer to the
             DtCallbackInfo structure.



                           Copyright 1994 Novell, Inc.               Page 1

      DtLockCursor(3Dt)                                  DtLockCursor(3Dt)


            On failure, DtLockCursor returns NULL.

      REFERENCES
            DtUnlockCursor(3Dt)












































                          Copyright 1994 Novell, Inc.               Page 2