Next / Previous / Contents

54.5. Key names

The detail part of an event pattern for a KeyPress or KeyRelease event specifies which key you're binding. (See the Any modifier, above, if you want to get all keypresses or key releases).

The table below shows several different ways to name keys. See Section 54.6, “Writing your handler: The Event class”, below, for more information on Event objects, whose attributes will describe keys in these same ways.

  • The .keysym column shows the “key symbol”, a string name for the key. This corresponds to the .keysym attribute of the Event object.

  • The .keycode column is the “key code.” This identifies which key was pressed, but the code does not reflect the state of various modifiers like the shift and control keys and the NumLock key. So, for example, both a and A have the same key code.

  • The .keysym_num column shows a numeric code equivalent to the key symbol. Unlike .keycode, these codes are different for different modifiers. For example, the digit 2 on the numeric keypad (key symbol KP_2) and the down arrow on the numeric keypad (key symbol KP_Down) have the same key code (88), but different .keysym_num values (65433 and 65458, respectively).

  • The “Key” column shows the text you will usually find on the physical key, such as tab.

There are many more key names for international character sets. This table shows only the “Latin-1” set for the usual USA-type 101-key keyboard. For the currently supported set, see the manual page for Tk keysym values.

Alt_L6465513The left-hand alt key
Alt_R11365514The right-hand alt key
Control_L3765507The left-hand control key
Control_R10965508The right-hand control key
F16765470Function key F1
F26865471Function key F2
Fi66+i65469+iFunction key Fi
F129665481Function key F12
Linefeed54106Linefeed (control-J)
KP_090654380 on the keypad
KP_187654361 on the keypad
KP_288654332 on the keypad
KP_389654353 on the keypad
KP_483654304 on the keypad
KP_584654375 on the keypad
KP_685654326 on the keypad
KP_779654297 on the keypad
KP_880654318 on the keypad
KP_981654349 on the keypad
KP_Add8665451+ on the keypad
KP_Begin8465437The center key (same key as 5) on the keypad
KP_Decimal9165439Decimal (.) on the keypad
KP_Delete9165439delete on the keypad
KP_Divide11265455/ on the keypad
KP_Down8865433↓ on the keypad
KP_End8765436end on the keypad
KP_Enter10865421enter on the keypad
KP_Home7965429home on the keypad
KP_Insert9065438insert on the keypad
KP_Left8365430← on the keypad
KP_Multiply6365450× on the keypad
KP_Next8965435PageDown on the keypad
KP_Prior8165434PageUp on the keypad
KP_Right8565432→ on the keypad
KP_Subtract8265453- on the keypad
KP_Up8065431↑ on the keypad
Return3665293The enter key (control-M). The name Enter refers to a mouse-related event, not a keypress; see Section 54, “Events”
Shift_L5065505The left-hand shift key
Shift_R6265506The right-hand shift key
Tab2365289The tab key