| OLD | NEW |
| 1 UI Events | 1 UI Events |
| 2 ========= | 2 ========= |
| 3 | 3 |
| 4 Scope | 4 Scope |
| 5 ----- | 5 ----- |
| 6 | 6 |
| 7 The following input devices are supported by sky: | 7 The following input devices are supported by sky: |
| 8 - fingers on multitouch screens | 8 - fingers on multitouch screens |
| 9 - mice, including mouse wheels | 9 - mice, including mouse wheels |
| 10 - styluses on screens | 10 - styluses on screens |
| (...skipping 40 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 51 Each touch or pointer is tracked individually. | 51 Each touch or pointer is tracked individually. |
| 52 | 52 |
| 53 New touches and pointers can appear and disappear over time. | 53 New touches and pointers can appear and disappear over time. |
| 54 | 54 |
| 55 When a new one enters the system, a 'pointer-added' event is fired at | 55 When a new one enters the system, a 'pointer-added' event is fired at |
| 56 the application's document. | 56 the application's document. |
| 57 | 57 |
| 58 When it is removed, a 'pointer-removed' event is fired at the | 58 When it is removed, a 'pointer-removed' event is fired at the |
| 59 application's document. | 59 application's document. |
| 60 | 60 |
| 61 A pointer switches from "up" to "down" when it is a touch or stylus |
| 62 that is in contact with the display surface, or when it is a mouse |
| 63 that is being clicked, and from "down" back to "up" when this ends. |
| 64 (Note that clicking a button on a stylus doesn't change it from up to |
| 65 down. A stylus can have a button pressed while "up".) |
| 66 |
| 61 When one switches from "up" to "down", the position of the tap is hit | 67 When one switches from "up" to "down", the position of the tap is hit |
| 62 tested and a 'pointer-down' event is fired at the target element under | 68 tested and a 'pointer-down' event is fired at the target element under |
| 63 the cursor, if any, or the document otherwise. The return value, if | 69 the cursor, if any, or the document otherwise. The return value, if |
| 64 it's a node, is used as the target of future move and up events until | 70 it's a node, is used as the target of future move and up events until |
| 65 this touch goes up. If there is no return value, the target continues | 71 this touch goes up. If there is no return value, the target continues |
| 66 to be the application's document. | 72 to be the application's document. |
| 67 | 73 |
| 68 A pointer that is "down" is captured -- all events for that pointer | 74 A pointer that is "down" is captured -- all events for that pointer |
| 69 will be routed to the chosen target until the pointer goes up, | 75 will be routed to the chosen target until the pointer goes up, |
| 70 regardless of whether it's in that target's visible area. | 76 regardless of whether it's in that target's visible area. |
| (...skipping 51 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 122 | 128 |
| 123 additional buttons can be represented by numbers | 129 additional buttons can be represented by numbers |
| 124 greater than six: | 130 greater than six: |
| 125 | 131 |
| 126 n: (n-2)th mouse button, ignoring any buttons that | 132 n: (n-2)th mouse button, ignoring any buttons that |
| 127 are explicitly back or forward buttons | 133 are explicitly back or forward buttons |
| 128 | 134 |
| 129 (n-4)th stylus button, again ignoring any | 135 (n-4)th stylus button, again ignoring any |
| 130 explictly back or forward buttons | 136 explictly back or forward buttons |
| 131 | 137 |
| 138 note that stylus buttons can be pressed even when the |
| 139 pointer is not "down" |
| 140 |
| 132 down: true if the pointer is down (in pointer-down event or | 141 down: true if the pointer is down (in pointer-down event or |
| 133 subsequent pointer-move events); false otherwise (in | 142 subsequent pointer-move events); false otherwise (in |
| 134 pointer-added, pointer-up, and pointer-removed | 143 pointer-added, pointer-up, and pointer-removed |
| 135 events, and in pointer-move events that aren't | 144 events, and in pointer-move events that aren't |
| 136 between pointer-down and pointer-up events) | 145 between pointer-down and pointer-up events) |
| 137 | 146 |
| 138 primary: true if this is a primary pointer/touch (see above) | 147 primary: true if this is a primary pointer/touch (see above) |
| 139 | 148 |
| 140 obscured: true if the system was rendering another view on top | 149 obscured: true if the system was rendering another view on top |
| 141 of the sky application at the time of the event (this | 150 of the sky application at the time of the event (this |
| (...skipping 127 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 269 display, in global layout coordinates | 278 display, in global layout coordinates |
| 270 | 279 |
| 271 Note: The only wheels that are supported are mouse wheels and physical | 280 Note: The only wheels that are supported are mouse wheels and physical |
| 272 dials. Track balls are not reported as mouse wheels. | 281 dials. Track balls are not reported as mouse wheels. |
| 273 | 282 |
| 274 | 283 |
| 275 Text input events | 284 Text input events |
| 276 ----------------- | 285 ----------------- |
| 277 | 286 |
| 278 TODO(ianh): keyboard events | 287 TODO(ianh): keyboard events |
| OLD | NEW |