document unexpected mouse event reporting; Closes PR 12278

(cherry picked from commit 8cdbd3285b)
This commit is contained in:
Matthias Felleisen 2011-10-12 09:36:39 -04:00 committed by Eli Barzilay
parent a24c809202
commit fa0809eb4d

View File

@ -442,10 +442,16 @@ All @tech{MouseEvent}s are represented via strings:
coordinates may be negative or larger than the (implicitly) specified coordinates may be negative or larger than the (implicitly) specified
width and height. width and height.
Note: the computer's software doesn't really notice every single movement @bold{Note 1}: the operating system doesn't really notice every single movement
of the mouse (across the mouse pad). Instead it samples the movements and of the mouse (across the mouse pad). Instead it samples the movements and
signals most of them.} signals most of them.}
}
@bold{Note 2}: while mouse events are usually reported in the expected
manner, the operating system doesn't necessarily report them in the
expected order. For example, the Windows operating system insists on
signaling a @racket["move"] event immediately after a @racket["button-up"]
event is discovered. Programmers must design the @racket[on-mouse]
handler to handle any possible mouse event at any moment. }
@item{ @item{