home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / evbl0627.zip / everblue_20010627.zip / x11 / Xlib_GetMotionEvents.c < prev    next >
C/C++ Source or Header  |  2000-04-24  |  2KB  |  52 lines
  1. /****************************************************************************************
  2. *Arguments
  3. *
  4. * display     Specifies the connection to the X server. 
  5. * w           Specifies the window. 
  6. * start
  7. * stop 
  8. *             Specify the time interval in which the events are returned from the motion history buffer. You can pass a
  9. *             timestamp or CurrentTime. 
  10. * nevents_return 
  11. *             Returns the number of events from the motion history buffer. 
  12. *
  13. *
  14. *Description
  15. *
  16. *The XGetMotionEvents() function returns all events in the motion history buffer that fall between the specified start and stop
  17. *times, inclusive, and that have coordinates that lie within the specified window (including its borders) at its present placement. If the
  18. *server does not support motion history, if the start time is later than the stop time, or if the start time is in the future, no events are
  19. *returned; XGetMotionEvents() returns NULL. If the stop time is in the future, it is equivalent to specifying CurrentTime . The
  20. *return type for this function is a structure defined as follows: 
  21. *
  22. *
  23. *typedef struct {
  24. *        Time time;
  25. *        short x, y;
  26. *} XTimeCoord;
  27. *
  28. *The time member is set to the time, in milliseconds. The x and y members are set to the coordinates of the pointer and are reported
  29. *relative to the origin of the specified window. To free the data returned from this call, use XFree(). 
  30. *
  31. *XGetMotionEvents() can generate a BadWindow error. 
  32. *
  33. *Diagnostics
  34. *
  35. * BadWindow     A value for a Window argument does not name a defined Window.
  36. ****************************************************************************************/
  37.  
  38. #include "Xlib.h"
  39. #include "Xlib_private.h" 
  40.  
  41. XTimeCoord *XGetMotionEvents(Display *display, Window w, Time start, Time stop, int *nevents_return)
  42. {
  43.     /* This one will return always NULL since the "Everblue"-server does
  44.      * not support motion history (yet) . */
  45.  
  46.         DBUG_ENTER("XGetMotionEvents");
  47.         #ifdef DEBUG
  48.            fprintf(stderr, "XGetMotionEvents: motion history not supported/implemented\n");
  49.         #endif
  50.     DBUG_RETURN(NULL);
  51. }
  52.