1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
"""
This module defines basic input events. For more details, see
http://asciimatics.readthedocs.io/en/latest/.html
"""
class Event():
"""
A class to hold information about an input event.
The exact contents varies from event to event. See specific classes for more information.
"""
class KeyboardEvent(Event):
"""
An event that represents a key press.
Its key field is the `key_code`. This is the ordinal representation of the key (taking into
account keyboard state - e.g. caps lock) if possible, or an extended key code (the `KEY_xxx`
constants in the :py:obj:`.Screen` class) where not.
"""
def __init__(self, key_code):
"""
:param key_code: the ordinal value of the key that was pressed.
"""
self.key_code = key_code
def __repr__(self):
"""
:returns: a string representation of the keyboard event.
"""
return f"KeyboardEvent: {self.key_code}"
class MouseEvent(Event):
"""
An event that represents a mouse move or click.
Allowed values for the buttons are any bitwise combination of
`LEFT_CLICK`, `RIGHT_CLICK` and `DOUBLE_CLICK`.
"""
# Mouse button states - bitwise flags
LEFT_CLICK = 1
RIGHT_CLICK = 2
DOUBLE_CLICK = 4
def __init__(self, x, y, buttons):
"""
:param x: The X coordinate of the mouse event.
:param y: The Y coordinate of the mouse event.
:param buttons: A bitwise flag for any mouse buttons that were pressed (if any).
"""
self.x = x
self.y = y
self.buttons = buttons
def __repr__(self):
"""
:returns: a string representation of the mouse event.
"""
return f"MouseEvent ({self.x}, {self.y}) {self.buttons}"
|
