home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 24 / AACD 24.iso / AACD / System / ReqToolsLib / Source / reqtools / rtsetwaitpointer.c < prev    next >
Encoding:
C/C++ Source or Header  |  2001-07-02  |  1.7 KB  |  76 lines
  1.  
  2. /*
  3.     (C) 1999 AROS - The Amiga Research OS
  4.     $Id: rtsetwaitpointer.c,v 1.6 2001/04/12 09:11:47 iaint Exp $
  5.  
  6.     Desc:
  7.     Lang: English
  8. */
  9.  
  10. #include <proto/intuition.h>
  11. #include <exec/types.h>
  12. #include <exec/libraries.h>
  13. #include <aros/libcall.h>
  14. #include <intuition/intuition.h>
  15. #include "general.h"
  16. #include "reqtools_intern.h"
  17. #include "rtfuncs.h"
  18.  
  19. /*****************************************************************************
  20.  
  21.     NAME */
  22.  
  23.     AROS_LH1(VOID, rtSetWaitPointer,
  24.  
  25. /*  SYNOPSIS */
  26.  
  27.     AROS_LHA(struct Window *, window, A0),
  28.  
  29. /*  LOCATION */
  30.  
  31.     struct ReqToolsBase *, ReqToolsBase, 19, ReqTools)
  32.  
  33. /*  FUNCTION
  34.     Change the pointer image to that of a wait pointer. This function should
  35.     be called when your program is busy for a longer period of time.
  36.  
  37.     It is recommended you call this function before calling any of the
  38.     requester functions.  This way if the user clicks in your window he will
  39.     know he must respond to the requester before doing anything else.  Also
  40.     see the RT_WaitPointer tag for an automatic way of setting the wait
  41.     pointer.  If you are using ReqTools V38+ check out the RT_LockWindow tag!
  42.  
  43.     INPUTS
  44.     window  --  pointer to the window to receive the wait pointer
  45.  
  46.     RESULT
  47.     none
  48.  
  49.     NOTES
  50.     The wait pointer will look exactly like the standard Workbench 2.0
  51.     wait pointer. In combination with PointerX, ClockTick or
  52.     LacePointer the handle will turn.
  53.  
  54.     EXAMPLE
  55.  
  56.     BUGS
  57.     none known
  58.  
  59.     SEE ALSO
  60.     rtEZRequest (RT_WaitPointer and RT_LockWindow tags), rtLockWindow()
  61.  
  62.     INTERNALS
  63.  
  64.     HISTORY
  65.  
  66. ******************************************************************************/
  67.  
  68. {
  69.     AROS_LIBFUNC_INIT
  70.  
  71.     RTFuncs_rtSetWaitPointer(window);
  72.     
  73.     AROS_LIBFUNC_EXIT
  74.     
  75. } /* rtSetWaitPointer */
  76.