Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 0a4b07e

Browse files
committed
DOC: Change event handling table into a tab set
The existing table is too wide, and overflow is clipped, so that not all toolkits are visible. Also, wrap all the entered keys in `:kbd:`. Fixes (partially?) #24741
1 parent a9ba9d5 commit 0a4b07e

File tree

1 file changed

+111
-19
lines changed

1 file changed

+111
-19
lines changed

doc/users/explain/event_handling.rst

Lines changed: 111 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -85,25 +85,117 @@ Event name Class Description
8585
what you may expect to receive as key(s) (using a QWERTY keyboard layout)
8686
from the different user interface toolkits, where a comma separates different keys:
8787

88-
================ ============================= ============================== ============================== ============================== ============================== ===================================
89-
Key(s) Pressed WxPython Qt WebAgg Gtk Tkinter macosx
90-
================ ============================= ============================== ============================== ============================== ============================== ===================================
91-
Shift+2 shift, shift+2 shift, @ shift, @ shift, @ shift, @ shift, @
92-
Shift+F1 shift, shift+f1 shift, shift+f1 shift, shift+f1 shift, shift+f1 shift, shift+f1 shift, shift+f1
93-
Shift shift shift shift shift shift shift
94-
Control control control control control control control
95-
Alt alt alt alt alt alt alt
96-
AltGr Nothing Nothing alt iso_level3_shift iso_level3_shift
97-
CapsLock caps_lock caps_lock caps_lock caps_lock caps_lock caps_lock
98-
CapsLock+a caps_lock, a caps_lock, a caps_lock, A caps_lock, A caps_lock, A caps_lock, a
99-
a a a a a a a
100-
Shift+a shift, A shift, A shift, A shift, A shift, A shift, A
101-
CapsLock+Shift+a caps_lock, shift, A caps_lock, shift, A caps_lock, shift, a caps_lock, shift, a caps_lock, shift, a caps_lock, shift, A
102-
Ctrl+Shift+Alt control, ctrl+shift, ctrl+alt control, ctrl+shift, ctrl+meta control, ctrl+shift, ctrl+meta control, ctrl+shift, ctrl+meta control, ctrl+shift, ctrl+meta control, ctrl+shift, ctrl+alt+shift
103-
Ctrl+Shift+a control, ctrl+shift, ctrl+A control, ctrl+shift, ctrl+A control, ctrl+shift, ctrl+A control, ctrl+shift, ctrl+A control, ctrl+shift, ctrl+a control, ctrl+shift, ctrl+A
104-
F1 f1 f1 f1 f1 f1 f1
105-
Ctrl+F1 control, ctrl+f1 control, ctrl+f1 control, ctrl+f1 control, ctrl+f1 control, ctrl+f1 control, Nothing
106-
================ ============================= ============================== ============================== ============================== ============================== ===================================
88+
.. tab-set::
89+
90+
.. tab-item:: Tkinter
91+
92+
======================== ===================================
93+
Key(s) pressed Received key event(s)
94+
======================== ===================================
95+
:kbd:`Shift+2` shift, @
96+
:kbd:`Shift+F1` shift, shift+f1
97+
:kbd:`Shift` shift
98+
:kbd:`Control` control
99+
:kbd:`Alt` alt
100+
:kbd:`AltGr` iso_level3_shift
101+
:kbd:`CapsLock` caps_lock
102+
:kbd:`CapsLock+a` caps_lock, A
103+
:kbd:`a` a
104+
:kbd:`Shift+a` shift, A
105+
:kbd:`CapsLock+Shift+a` caps_lock, shift, a
106+
:kbd:`Control+Shift+Alt` control, ctrl+shift, ctrl+meta
107+
:kbd:`Control+Shift+a` control, ctrl+shift, ctrl+a
108+
:kbd:`F1` f1
109+
:kbd:`Control+F1` control, ctrl+f1
110+
======================== ===================================
111+
112+
.. tab-item:: Qt
113+
114+
======================== ===================================
115+
Key(s) pressed Received key event(s)
116+
======================== ===================================
117+
:kbd:`Shift+2` shift, @
118+
:kbd:`Shift+F1` shift, shift+f1
119+
:kbd:`Shift` shift
120+
:kbd:`Control` control
121+
:kbd:`Alt` alt
122+
:kbd:`AltGr` *nothing*
123+
:kbd:`CapsLock` caps_lock
124+
:kbd:`CapsLock+a` caps_lock, a
125+
:kbd:`a` a
126+
:kbd:`Shift+a` shift, A
127+
:kbd:`CapsLock+Shift+a` caps_lock, shift, A
128+
:kbd:`Control+Shift+Alt` control, ctrl+shift, ctrl+meta
129+
:kbd:`Control+Shift+a` control, ctrl+shift, ctrl+A
130+
:kbd:`F1` f1
131+
:kbd:`Control+F1` control, ctrl+f1
132+
======================== ===================================
133+
134+
.. tab-item:: macosx
135+
136+
======================== ===================================
137+
Key(s) pressed Received key event(s)
138+
======================== ===================================
139+
:kbd:`Shift+2` shift, @
140+
:kbd:`Shift+F1` shift, shift+f1
141+
:kbd:`Shift` shift
142+
:kbd:`Control` control
143+
:kbd:`Alt` alt
144+
:kbd:`AltGr` *nothing*
145+
:kbd:`CapsLock` caps_lock
146+
:kbd:`CapsLock+a` caps_lock, a
147+
:kbd:`a` a
148+
:kbd:`Shift+a` shift, A
149+
:kbd:`CapsLock+Shift+a` caps_lock, shift, A
150+
:kbd:`Control+Shift+Alt` control, ctrl+shift, ctrl+alt+shift
151+
:kbd:`Control+Shift+a` control, ctrl+shift, ctrl+A
152+
:kbd:`F1` f1
153+
:kbd:`Control+F1` control, *nothing*
154+
======================== ===================================
155+
156+
.. tab-item:: WebAgg
157+
158+
======================== ===================================
159+
Key(s) pressed Received key event(s)
160+
======================== ===================================
161+
:kbd:`Shift+2` shift, @
162+
:kbd:`Shift+F1` shift, shift+f1
163+
:kbd:`Shift` shift
164+
:kbd:`Control` control
165+
:kbd:`Alt` alt
166+
:kbd:`AltGr` alt
167+
:kbd:`CapsLock` caps_lock
168+
:kbd:`CapsLock+a` caps_lock, A
169+
:kbd:`a` a
170+
:kbd:`Shift+a` shift, A
171+
:kbd:`CapsLock+Shift+a` caps_lock, shift, a
172+
:kbd:`Control+Shift+Alt` control, ctrl+shift, ctrl+meta
173+
:kbd:`Control+Shift+a` control, ctrl+shift, ctrl+A
174+
:kbd:`F1` f1
175+
:kbd:`Control+F1` control, ctrl+f1
176+
======================== ===================================
177+
178+
.. tab-item:: wxPython
179+
180+
======================== ===================================
181+
Key(s) pressed Received key event(s)
182+
======================== ===================================
183+
:kbd:`Shift+2` shift, shift+2
184+
:kbd:`Shift+F1` shift, shift+f1
185+
:kbd:`Shift` shift
186+
:kbd:`Control` control
187+
:kbd:`Alt` alt
188+
:kbd:`AltGr` *nothing*
189+
:kbd:`CapsLock` caps_lock
190+
:kbd:`CapsLock+a` caps_lock, a
191+
:kbd:`a` a
192+
:kbd:`Shift+a` shift, A
193+
:kbd:`CapsLock+Shift+a` caps_lock, shift, A
194+
:kbd:`Control+Shift+Alt` control, ctrl+shift, ctrl+alt
195+
:kbd:`Control+Shift+a` control, ctrl+shift, ctrl+A
196+
:kbd:`F1` f1
197+
:kbd:`Control+F1` control, ctrl+f1
198+
======================== ===================================
107199

108200
Matplotlib attaches some keypress callbacks by default for interactivity; they
109201
are documented in the :ref:`key-event-handling` section.

0 commit comments

Comments
 (0)