Python code coverage: Lib/idlelib/keybindingDialog.py

#	count	content
1	n/a	"""
2	n/a	Dialog for building Tkinter accelerator key bindings
3	n/a	"""
4	n/a	from tkinter import *
5	n/a	import tkinter.messagebox as tkMessageBox
6	n/a	import string
7	n/a	from idlelib import macosxSupport
8	n/a
9	n/a	class GetKeysDialog(Toplevel):
10	n/a	def __init__(self,parent,title,action,currentKeySequences):
11	n/a	"""
12	n/a	action - string, the name of the virtual event these keys will be
13	n/a	mapped to
14	n/a	currentKeys - list, a list of all key sequence lists currently mapped
15	n/a	to virtual events, for overlap checking
16	n/a	"""
17	n/a	Toplevel.__init__(self, parent)
18	n/a	self.configure(borderwidth=5)
19	n/a	self.resizable(height=FALSE,width=FALSE)
20	n/a	self.title(title)
21	n/a	self.transient(parent)
22	n/a	self.grab_set()
23	n/a	self.protocol("WM_DELETE_WINDOW", self.Cancel)
24	n/a	self.parent = parent
25	n/a	self.action=action
26	n/a	self.currentKeySequences=currentKeySequences
27	n/a	self.result=''
28	n/a	self.keyString=StringVar(self)
29	n/a	self.keyString.set('')
30	n/a	self.SetModifiersForPlatform() # set self.modifiers, self.modifier_label
31	n/a	self.modifier_vars = []
32	n/a	for modifier in self.modifiers:
33	n/a	variable = StringVar(self)
34	n/a	variable.set('')
35	n/a	self.modifier_vars.append(variable)
36	n/a	self.advanced = False
37	n/a	self.CreateWidgets()
38	n/a	self.LoadFinalKeyList()
39	n/a	self.withdraw() #hide while setting geometry
40	n/a	self.update_idletasks()
41	n/a	self.geometry("+%d+%d" %
42	n/a	((parent.winfo_rootx()+((parent.winfo_width()/2)
43	n/a	-(self.winfo_reqwidth()/2)),
44	n/a	parent.winfo_rooty()+((parent.winfo_height()/2)
45	n/a	-(self.winfo_reqheight()/2)) )) ) #centre dialog over parent
46	n/a	self.deiconify() #geometry set, unhide
47	n/a	self.wait_window()
48	n/a
49	n/a	def CreateWidgets(self):
50	n/a	frameMain = Frame(self,borderwidth=2,relief=SUNKEN)
51	n/a	frameMain.pack(side=TOP,expand=TRUE,fill=BOTH)
52	n/a	frameButtons=Frame(self)
53	n/a	frameButtons.pack(side=BOTTOM,fill=X)
54	n/a	self.buttonOK = Button(frameButtons,text='OK',
55	n/a	width=8,command=self.OK)
56	n/a	self.buttonOK.grid(row=0,column=0,padx=5,pady=5)
57	n/a	self.buttonCancel = Button(frameButtons,text='Cancel',
58	n/a	width=8,command=self.Cancel)
59	n/a	self.buttonCancel.grid(row=0,column=1,padx=5,pady=5)
60	n/a	self.frameKeySeqBasic = Frame(frameMain)
61	n/a	self.frameKeySeqAdvanced = Frame(frameMain)
62	n/a	self.frameControlsBasic = Frame(frameMain)
63	n/a	self.frameHelpAdvanced = Frame(frameMain)
64	n/a	self.frameKeySeqAdvanced.grid(row=0,column=0,sticky=NSEW,padx=5,pady=5)
65	n/a	self.frameKeySeqBasic.grid(row=0,column=0,sticky=NSEW,padx=5,pady=5)
66	n/a	self.frameKeySeqBasic.lift()
67	n/a	self.frameHelpAdvanced.grid(row=1,column=0,sticky=NSEW,padx=5)
68	n/a	self.frameControlsBasic.grid(row=1,column=0,sticky=NSEW,padx=5)
69	n/a	self.frameControlsBasic.lift()
70	n/a	self.buttonLevel = Button(frameMain,command=self.ToggleLevel,
71	n/a	text='Advanced Key Binding Entry >>')
72	n/a	self.buttonLevel.grid(row=2,column=0,stick=EW,padx=5,pady=5)
73	n/a	labelTitleBasic = Label(self.frameKeySeqBasic,
74	n/a	text="New keys for '"+self.action+"' :")
75	n/a	labelTitleBasic.pack(anchor=W)
76	n/a	labelKeysBasic = Label(self.frameKeySeqBasic,justify=LEFT,
77	n/a	textvariable=self.keyString,relief=GROOVE,borderwidth=2)
78	n/a	labelKeysBasic.pack(ipadx=5,ipady=5,fill=X)
79	n/a	self.modifier_checkbuttons = {}
80	n/a	column = 0
81	n/a	for modifier, variable in zip(self.modifiers, self.modifier_vars):
82	n/a	label = self.modifier_label.get(modifier, modifier)
83	n/a	check=Checkbutton(self.frameControlsBasic,
84	n/a	command=self.BuildKeyString,
85	n/a	text=label,variable=variable,onvalue=modifier,offvalue='')
86	n/a	check.grid(row=0,column=column,padx=2,sticky=W)
87	n/a	self.modifier_checkbuttons[modifier] = check
88	n/a	column += 1
89	n/a	labelFnAdvice=Label(self.frameControlsBasic,justify=LEFT,
90	n/a	text=\
91	n/a	"Select the desired modifier keys\n"+
92	n/a	"above, and the final key from the\n"+
93	n/a	"list on the right.\n\n" +
94	n/a	"Use upper case Symbols when using\n" +
95	n/a	"the Shift modifier. (Letters will be\n" +
96	n/a	"converted automatically.)")
97	n/a	labelFnAdvice.grid(row=1,column=0,columnspan=4,padx=2,sticky=W)
98	n/a	self.listKeysFinal=Listbox(self.frameControlsBasic,width=15,height=10,
99	n/a	selectmode=SINGLE)
100	n/a	self.listKeysFinal.bind('<ButtonRelease-1>',self.FinalKeySelected)
101	n/a	self.listKeysFinal.grid(row=0,column=4,rowspan=4,sticky=NS)
102	n/a	scrollKeysFinal=Scrollbar(self.frameControlsBasic,orient=VERTICAL,
103	n/a	command=self.listKeysFinal.yview)
104	n/a	self.listKeysFinal.config(yscrollcommand=scrollKeysFinal.set)
105	n/a	scrollKeysFinal.grid(row=0,column=5,rowspan=4,sticky=NS)
106	n/a	self.buttonClear=Button(self.frameControlsBasic,
107	n/a	text='Clear Keys',command=self.ClearKeySeq)
108	n/a	self.buttonClear.grid(row=2,column=0,columnspan=4)
109	n/a	labelTitleAdvanced = Label(self.frameKeySeqAdvanced,justify=LEFT,
110	n/a	text="Enter new binding(s) for '"+self.action+"' :\n"+
111	n/a	"(These bindings will not be checked for validity!)")
112	n/a	labelTitleAdvanced.pack(anchor=W)
113	n/a	self.entryKeysAdvanced=Entry(self.frameKeySeqAdvanced,
114	n/a	textvariable=self.keyString)
115	n/a	self.entryKeysAdvanced.pack(fill=X)
116	n/a	labelHelpAdvanced=Label(self.frameHelpAdvanced,justify=LEFT,
117	n/a	text="Key bindings are specified using Tkinter keysyms as\n"+
118	n/a	"in these samples: <Control-f>, <Shift-F2>, <F12>,\n"
119	n/a	"<Control-space>, <Meta-less>, <Control-Alt-Shift-X>.\n"
120	n/a	"Upper case is used when the Shift modifier is present!\n\n" +
121	n/a	"'Emacs style' multi-keystroke bindings are specified as\n" +
122	n/a	"follows: <Control-x><Control-y>, where the first key\n" +
123	n/a	"is the 'do-nothing' keybinding.\n\n" +
124	n/a	"Multiple separate bindings for one action should be\n"+
125	n/a	"separated by a space, eg., <Alt-v> <Meta-v>." )
126	n/a	labelHelpAdvanced.grid(row=0,column=0,sticky=NSEW)
127	n/a
128	n/a	def SetModifiersForPlatform(self):
129	n/a	"""Determine list of names of key modifiers for this platform.
130	n/a
131	n/a	The names are used to build Tk bindings -- it doesn't matter if the
132	n/a	keyboard has these keys, it matters if Tk understands them. The
133	n/a	order is also important: key binding equality depends on it, so
134	n/a	config-keys.def must use the same ordering.
135	n/a	"""
136	n/a	import sys
137	n/a	if macosxSupport.runningAsOSXApp():
138	n/a	self.modifiers = ['Shift', 'Control', 'Option', 'Command']
139	n/a	else:
140	n/a	self.modifiers = ['Control', 'Alt', 'Shift']
141	n/a	self.modifier_label = {'Control': 'Ctrl'} # short name
142	n/a
143	n/a	def ToggleLevel(self):
144	n/a	if self.buttonLevel.cget('text')[:8]=='Advanced':
145	n/a	self.ClearKeySeq()
146	n/a	self.buttonLevel.config(text='<< Basic Key Binding Entry')
147	n/a	self.frameKeySeqAdvanced.lift()
148	n/a	self.frameHelpAdvanced.lift()
149	n/a	self.entryKeysAdvanced.focus_set()
150	n/a	self.advanced = True
151	n/a	else:
152	n/a	self.ClearKeySeq()
153	n/a	self.buttonLevel.config(text='Advanced Key Binding Entry >>')
154	n/a	self.frameKeySeqBasic.lift()
155	n/a	self.frameControlsBasic.lift()
156	n/a	self.advanced = False
157	n/a
158	n/a	def FinalKeySelected(self,event):
159	n/a	self.BuildKeyString()
160	n/a
161	n/a	def BuildKeyString(self):
162	n/a	keyList = modifiers = self.GetModifiers()
163	n/a	finalKey = self.listKeysFinal.get(ANCHOR)
164	n/a	if finalKey:
165	n/a	finalKey = self.TranslateKey(finalKey, modifiers)
166	n/a	keyList.append(finalKey)
167	n/a	self.keyString.set('<' + '-'.join(keyList) + '>')
168	n/a
169	n/a	def GetModifiers(self):
170	n/a	modList = [variable.get() for variable in self.modifier_vars]
171	n/a	return [mod for mod in modList if mod]
172	n/a
173	n/a	def ClearKeySeq(self):
174	n/a	self.listKeysFinal.select_clear(0,END)
175	n/a	self.listKeysFinal.yview(MOVETO, '0.0')
176	n/a	for variable in self.modifier_vars:
177	n/a	variable.set('')
178	n/a	self.keyString.set('')
179	n/a
180	n/a	def LoadFinalKeyList(self):
181	n/a	#these tuples are also available for use in validity checks
182	n/a	self.functionKeys=('F1','F2','F2','F4','F5','F6','F7','F8','F9',
183	n/a	'F10','F11','F12')
184	n/a	self.alphanumKeys=tuple(string.ascii_lowercase+string.digits)
185	n/a	self.punctuationKeys=tuple('~!@#%^&*()_-+={}[]\|;:,.<>/?')
186	n/a	self.whitespaceKeys=('Tab','Space','Return')
187	n/a	self.editKeys=('BackSpace','Delete','Insert')
188	n/a	self.moveKeys=('Home','End','Page Up','Page Down','Left Arrow',
189	n/a	'Right Arrow','Up Arrow','Down Arrow')
190	n/a	#make a tuple of most of the useful common 'final' keys
191	n/a	keys=(self.alphanumKeys+self.punctuationKeys+self.functionKeys+
192	n/a	self.whitespaceKeys+self.editKeys+self.moveKeys)
193	n/a	self.listKeysFinal.insert(END, *keys)
194	n/a
195	n/a	def TranslateKey(self, key, modifiers):
196	n/a	"Translate from keycap symbol to the Tkinter keysym"
197	n/a	translateDict = {'Space':'space',
198	n/a	'~':'asciitilde','!':'exclam','@':'at','#':'numbersign',
199	n/a	'%':'percent','^':'asciicircum','&':'ampersand','*':'asterisk',
200	n/a	'(':'parenleft',')':'parenright','_':'underscore','-':'minus',
201	n/a	'+':'plus','=':'equal','{':'braceleft','}':'braceright',
202	n/a	'[':'bracketleft',']':'bracketright','\|':'bar',';':'semicolon',
203	n/a	':':'colon',',':'comma','.':'period','<':'less','>':'greater',
204	n/a	'/':'slash','?':'question','Page Up':'Prior','Page Down':'Next',
205	n/a	'Left Arrow':'Left','Right Arrow':'Right','Up Arrow':'Up',
206	n/a	'Down Arrow': 'Down', 'Tab':'Tab'}
207	n/a	if key in translateDict:
208	n/a	key = translateDict[key]
209	n/a	if 'Shift' in modifiers and key in string.ascii_lowercase:
210	n/a	key = key.upper()
211	n/a	key = 'Key-' + key
212	n/a	return key
213	n/a
214	n/a	def OK(self, event=None):
215	n/a	if self.advanced or self.KeysOK(): # doesn't check advanced string yet
216	n/a	self.result=self.keyString.get()
217	n/a	self.destroy()
218	n/a
219	n/a	def Cancel(self, event=None):
220	n/a	self.result=''
221	n/a	self.destroy()
222	n/a
223	n/a	def KeysOK(self):
224	n/a	'''Validity check on user's 'basic' keybinding selection.
225	n/a
226	n/a	Doesn't check the string produced by the advanced dialog because
227	n/a	'modifiers' isn't set.
228	n/a
229	n/a	'''
230	n/a	keys = self.keyString.get()
231	n/a	keys.strip()
232	n/a	finalKey = self.listKeysFinal.get(ANCHOR)
233	n/a	modifiers = self.GetModifiers()
234	n/a	# create a key sequence list for overlap check:
235	n/a	keySequence = keys.split()
236	n/a	keysOK = False
237	n/a	title = 'Key Sequence Error'
238	n/a	if not keys:
239	n/a	tkMessageBox.showerror(title=title, parent=self,
240	n/a	message='No keys specified.')
241	n/a	elif not keys.endswith('>'):
242	n/a	tkMessageBox.showerror(title=title, parent=self,
243	n/a	message='Missing the final Key')
244	n/a	elif (not modifiers
245	n/a	and finalKey not in self.functionKeys + self.moveKeys):
246	n/a	tkMessageBox.showerror(title=title, parent=self,
247	n/a	message='No modifier key(s) specified.')
248	n/a	elif (modifiers == ['Shift']) \
249	n/a	and (finalKey not in
250	n/a	self.functionKeys + self.moveKeys + ('Tab', 'Space')):
251	n/a	msg = 'The shift modifier by itself may not be used with'\
252	n/a	' this key symbol.'
253	n/a	tkMessageBox.showerror(title=title, parent=self, message=msg)
254	n/a	elif keySequence in self.currentKeySequences:
255	n/a	msg = 'This key combination is already in use.'
256	n/a	tkMessageBox.showerror(title=title, parent=self, message=msg)
257	n/a	else:
258	n/a	keysOK = True
259	n/a	return keysOK
260	n/a
261	n/a	if __name__ == '__main__':
262	n/a	#test the dialog
263	n/a	root=Tk()
264	n/a	def run():
265	n/a	keySeq=''
266	n/a	dlg=GetKeysDialog(root,'Get Keys','find-again',[])
267	n/a	print(dlg.result)
268	n/a	Button(root,text='Dialog',command=run).pack()
269	n/a	root.mainloop()

1

n/a

"""

2

n/a

Dialog for building Tkinter accelerator key bindings

3

n/a

"""

4

n/a

from tkinter import *

5

n/a

import tkinter.messagebox as tkMessageBox

6

n/a

import string

7

n/a

from idlelib import macosxSupport

8

n/a

9

n/a

class GetKeysDialog(Toplevel):

10

n/a

def __init__(self,parent,title,action,currentKeySequences):

11

n/a

"""

12

n/a

action - string, the name of the virtual event these keys will be

13

n/a

mapped to

14

n/a

currentKeys - list, a list of all key sequence lists currently mapped

15

n/a

to virtual events, for overlap checking

16

n/a

"""

17

n/a

Toplevel.__init__(self, parent)

18

n/a

self.configure(borderwidth=5)

19

n/a

self.resizable(height=FALSE,width=FALSE)

20

n/a

self.title(title)

21

n/a

self.transient(parent)

22

n/a

self.grab_set()

23

n/a

self.protocol("WM_DELETE_WINDOW", self.Cancel)

24

n/a

self.parent = parent

25

n/a

self.action=action

26

n/a

self.currentKeySequences=currentKeySequences

27

n/a

self.result=''

28

n/a

self.keyString=StringVar(self)

29

n/a

self.keyString.set('')

30

n/a

self.SetModifiersForPlatform() # set self.modifiers, self.modifier_label

31

n/a

self.modifier_vars = []

32

n/a

for modifier in self.modifiers:

33

n/a

variable = StringVar(self)

34

n/a

variable.set('')

35

n/a

self.modifier_vars.append(variable)

36

n/a

self.advanced = False

37

n/a

self.CreateWidgets()

38

n/a

self.LoadFinalKeyList()

39

n/a

self.withdraw() #hide while setting geometry

40

n/a

self.update_idletasks()

41

n/a

self.geometry("+%d+%d" %

42

n/a

((parent.winfo_rootx()+((parent.winfo_width()/2)

43

n/a

-(self.winfo_reqwidth()/2)),

44

n/a

parent.winfo_rooty()+((parent.winfo_height()/2)

45

n/a

-(self.winfo_reqheight()/2)) )) ) #centre dialog over parent

46

n/a

self.deiconify() #geometry set, unhide

47

n/a

self.wait_window()

48

n/a

49

n/a

def CreateWidgets(self):

50

n/a

frameMain = Frame(self,borderwidth=2,relief=SUNKEN)

51

n/a

frameMain.pack(side=TOP,expand=TRUE,fill=BOTH)

52

n/a

frameButtons=Frame(self)

53

n/a

frameButtons.pack(side=BOTTOM,fill=X)

54

n/a

self.buttonOK = Button(frameButtons,text='OK',

55

n/a

width=8,command=self.OK)

56

n/a

self.buttonOK.grid(row=0,column=0,padx=5,pady=5)

57

n/a

self.buttonCancel = Button(frameButtons,text='Cancel',

58

n/a

width=8,command=self.Cancel)

59

n/a

self.buttonCancel.grid(row=0,column=1,padx=5,pady=5)

60

n/a

self.frameKeySeqBasic = Frame(frameMain)

61

n/a

self.frameKeySeqAdvanced = Frame(frameMain)

62

n/a

self.frameControlsBasic = Frame(frameMain)

63

n/a

self.frameHelpAdvanced = Frame(frameMain)

64

n/a

self.frameKeySeqAdvanced.grid(row=0,column=0,sticky=NSEW,padx=5,pady=5)

65

n/a

self.frameKeySeqBasic.grid(row=0,column=0,sticky=NSEW,padx=5,pady=5)

66

n/a

self.frameKeySeqBasic.lift()

67

n/a

self.frameHelpAdvanced.grid(row=1,column=0,sticky=NSEW,padx=5)

68

n/a

self.frameControlsBasic.grid(row=1,column=0,sticky=NSEW,padx=5)

69

n/a

self.frameControlsBasic.lift()

70

n/a

self.buttonLevel = Button(frameMain,command=self.ToggleLevel,

71

n/a

text='Advanced Key Binding Entry >>')

72

n/a

self.buttonLevel.grid(row=2,column=0,stick=EW,padx=5,pady=5)

73

n/a

labelTitleBasic = Label(self.frameKeySeqBasic,

74

n/a

text="New keys for '"+self.action+"' :")

75

n/a

labelTitleBasic.pack(anchor=W)

76

n/a

labelKeysBasic = Label(self.frameKeySeqBasic,justify=LEFT,

77

n/a

textvariable=self.keyString,relief=GROOVE,borderwidth=2)

78

n/a

labelKeysBasic.pack(ipadx=5,ipady=5,fill=X)

79

n/a

self.modifier_checkbuttons = {}

80

n/a

column = 0

81

n/a

for modifier, variable in zip(self.modifiers, self.modifier_vars):

82

n/a

label = self.modifier_label.get(modifier, modifier)

83

n/a

check=Checkbutton(self.frameControlsBasic,

84

n/a

command=self.BuildKeyString,

85

n/a

text=label,variable=variable,onvalue=modifier,offvalue='')

86

n/a

check.grid(row=0,column=column,padx=2,sticky=W)

87

n/a

self.modifier_checkbuttons[modifier] = check

88

n/a

column += 1

89

n/a

labelFnAdvice=Label(self.frameControlsBasic,justify=LEFT,

90

n/a

text=\

91

n/a

"Select the desired modifier keys\n"+

92

n/a

"above, and the final key from the\n"+

93

n/a

"list on the right.\n\n" +

94

n/a

"Use upper case Symbols when using\n" +

95

n/a

"the Shift modifier. (Letters will be\n" +

96

n/a

"converted automatically.)")

97

n/a

labelFnAdvice.grid(row=1,column=0,columnspan=4,padx=2,sticky=W)

98

n/a

self.listKeysFinal=Listbox(self.frameControlsBasic,width=15,height=10,

99

n/a

selectmode=SINGLE)

100

n/a

self.listKeysFinal.bind('<ButtonRelease-1>',self.FinalKeySelected)

101

n/a

self.listKeysFinal.grid(row=0,column=4,rowspan=4,sticky=NS)

102

n/a

scrollKeysFinal=Scrollbar(self.frameControlsBasic,orient=VERTICAL,

103

n/a

command=self.listKeysFinal.yview)

104

n/a

self.listKeysFinal.config(yscrollcommand=scrollKeysFinal.set)

105

n/a

scrollKeysFinal.grid(row=0,column=5,rowspan=4,sticky=NS)

106

n/a

self.buttonClear=Button(self.frameControlsBasic,

107

n/a

text='Clear Keys',command=self.ClearKeySeq)

108

n/a

self.buttonClear.grid(row=2,column=0,columnspan=4)

109

n/a

labelTitleAdvanced = Label(self.frameKeySeqAdvanced,justify=LEFT,

110

n/a

text="Enter new binding(s) for '"+self.action+"' :\n"+

111

n/a

"(These bindings will not be checked for validity!)")

112

n/a

labelTitleAdvanced.pack(anchor=W)

113

n/a

self.entryKeysAdvanced=Entry(self.frameKeySeqAdvanced,

114

n/a

textvariable=self.keyString)

115

n/a

self.entryKeysAdvanced.pack(fill=X)

116

n/a

labelHelpAdvanced=Label(self.frameHelpAdvanced,justify=LEFT,

117

n/a

text="Key bindings are specified using Tkinter keysyms as\n"+

118

n/a

"in these samples: <Control-f>, <Shift-F2>, <F12>,\n"

119

n/a

"<Control-space>, <Meta-less>, <Control-Alt-Shift-X>.\n"

120

n/a

"Upper case is used when the Shift modifier is present!\n\n" +

121

n/a

"'Emacs style' multi-keystroke bindings are specified as\n" +

122

n/a

"follows: <Control-x><Control-y>, where the first key\n" +

123

n/a

"is the 'do-nothing' keybinding.\n\n" +

124

n/a

"Multiple separate bindings for one action should be\n"+

125

n/a

"separated by a space, eg., <Alt-v> <Meta-v>." )

126

n/a

labelHelpAdvanced.grid(row=0,column=0,sticky=NSEW)

127

n/a

128

n/a

def SetModifiersForPlatform(self):

129

n/a

"""Determine list of names of key modifiers for this platform.

130

n/a

131

n/a

The names are used to build Tk bindings -- it doesn't matter if the

132

n/a

keyboard has these keys, it matters if Tk understands them. The

133

n/a

order is also important: key binding equality depends on it, so

134

n/a

config-keys.def must use the same ordering.

135

n/a

"""

136

n/a

import sys

137

n/a

if macosxSupport.runningAsOSXApp():

138

n/a

self.modifiers = ['Shift', 'Control', 'Option', 'Command']

139

n/a

else:

140

n/a

self.modifiers = ['Control', 'Alt', 'Shift']

141

n/a

self.modifier_label = {'Control': 'Ctrl'} # short name

142

n/a

143

n/a

def ToggleLevel(self):

144

n/a

if self.buttonLevel.cget('text')[:8]=='Advanced':

145

n/a

self.ClearKeySeq()

146

n/a

self.buttonLevel.config(text='<< Basic Key Binding Entry')

147

n/a

self.frameKeySeqAdvanced.lift()

148

n/a

self.frameHelpAdvanced.lift()

149

n/a

self.entryKeysAdvanced.focus_set()

150

n/a

self.advanced = True

151

n/a

else:

152

n/a

self.ClearKeySeq()

153

n/a

self.buttonLevel.config(text='Advanced Key Binding Entry >>')

154

n/a

self.frameKeySeqBasic.lift()

155

n/a

self.frameControlsBasic.lift()

156

n/a

self.advanced = False

157

n/a

158

n/a

def FinalKeySelected(self,event):

159

n/a

self.BuildKeyString()

160

n/a

161

n/a

def BuildKeyString(self):

162

n/a

keyList = modifiers = self.GetModifiers()

163

n/a

finalKey = self.listKeysFinal.get(ANCHOR)

164

n/a

if finalKey:

165

n/a

finalKey = self.TranslateKey(finalKey, modifiers)

166

n/a

keyList.append(finalKey)

167

n/a

self.keyString.set('<' + '-'.join(keyList) + '>')

168

n/a

169

n/a

def GetModifiers(self):

170

n/a

modList = [variable.get() for variable in self.modifier_vars]

171

n/a

return [mod for mod in modList if mod]

172

n/a

173

n/a

def ClearKeySeq(self):

174

n/a

self.listKeysFinal.select_clear(0,END)

175

n/a

self.listKeysFinal.yview(MOVETO, '0.0')

176

n/a

for variable in self.modifier_vars:

177

n/a

variable.set('')

178

n/a

self.keyString.set('')

179

n/a

180

n/a

def LoadFinalKeyList(self):

181

n/a

#these tuples are also available for use in validity checks

182

n/a

self.functionKeys=('F1','F2','F2','F4','F5','F6','F7','F8','F9',

183

n/a

'F10','F11','F12')

184

n/a

self.alphanumKeys=tuple(string.ascii_lowercase+string.digits)

185

n/a

self.punctuationKeys=tuple('~!@#%^&*()_-+={}[]|;:,.<>/?')

186

n/a

self.whitespaceKeys=('Tab','Space','Return')

187

n/a

self.editKeys=('BackSpace','Delete','Insert')

188

n/a

self.moveKeys=('Home','End','Page Up','Page Down','Left Arrow',

189

n/a

'Right Arrow','Up Arrow','Down Arrow')

190

n/a

#make a tuple of most of the useful common 'final' keys

191

n/a

keys=(self.alphanumKeys+self.punctuationKeys+self.functionKeys+

192

n/a

self.whitespaceKeys+self.editKeys+self.moveKeys)

193

n/a

self.listKeysFinal.insert(END, *keys)

194

n/a

195

n/a

def TranslateKey(self, key, modifiers):

196

n/a

"Translate from keycap symbol to the Tkinter keysym"

197

n/a

translateDict = {'Space':'space',

198

n/a

'~':'asciitilde','!':'exclam','@':'at','#':'numbersign',

199

n/a

'%':'percent','^':'asciicircum','&':'ampersand','*':'asterisk',

200

n/a

'(':'parenleft',')':'parenright','_':'underscore','-':'minus',

201

n/a

'+':'plus','=':'equal','{':'braceleft','}':'braceright',

202

n/a

'[':'bracketleft',']':'bracketright','|':'bar',';':'semicolon',

203

n/a

':':'colon',',':'comma','.':'period','<':'less','>':'greater',

204

n/a

'/':'slash','?':'question','Page Up':'Prior','Page Down':'Next',

205

n/a

'Left Arrow':'Left','Right Arrow':'Right','Up Arrow':'Up',

206

n/a

'Down Arrow': 'Down', 'Tab':'Tab'}

207

n/a

if key in translateDict:

208

n/a

key = translateDict[key]

209

n/a

if 'Shift' in modifiers and key in string.ascii_lowercase:

210

n/a

key = key.upper()

211

n/a

key = 'Key-' + key

212

n/a

return key

213

n/a

214

n/a

def OK(self, event=None):

215

n/a

if self.advanced or self.KeysOK(): # doesn't check advanced string yet

216

n/a

self.result=self.keyString.get()

217

n/a

self.destroy()

218

n/a

219

n/a

def Cancel(self, event=None):

220

n/a

self.result=''

221

n/a

self.destroy()

222

n/a

223

n/a

def KeysOK(self):

224

n/a

'''Validity check on user's 'basic' keybinding selection.

225

n/a

226

n/a

Doesn't check the string produced by the advanced dialog because

227

n/a

'modifiers' isn't set.

228

n/a

229

n/a

'''

230

n/a

keys = self.keyString.get()

231

n/a

keys.strip()

232

n/a

finalKey = self.listKeysFinal.get(ANCHOR)

233

n/a

modifiers = self.GetModifiers()

234

n/a

# create a key sequence list for overlap check:

235

n/a

keySequence = keys.split()

236

n/a

keysOK = False

237

n/a

title = 'Key Sequence Error'

238

n/a

if not keys:

239

n/a

tkMessageBox.showerror(title=title, parent=self,

240

n/a

message='No keys specified.')

241

n/a

elif not keys.endswith('>'):

242

n/a

tkMessageBox.showerror(title=title, parent=self,

243

n/a

message='Missing the final Key')

244

n/a

elif (not modifiers

245

n/a

and finalKey not in self.functionKeys + self.moveKeys):

246

n/a

tkMessageBox.showerror(title=title, parent=self,

247

n/a

message='No modifier key(s) specified.')

248

n/a

elif (modifiers == ['Shift']) \

249

n/a

and (finalKey not in

250

n/a

self.functionKeys + self.moveKeys + ('Tab', 'Space')):

251

n/a

msg = 'The shift modifier by itself may not be used with'\

252

n/a

' this key symbol.'

253

n/a

tkMessageBox.showerror(title=title, parent=self, message=msg)

254

n/a

elif keySequence in self.currentKeySequences:

255

n/a

msg = 'This key combination is already in use.'

256

n/a

tkMessageBox.showerror(title=title, parent=self, message=msg)

257

n/a

else:

258

n/a

keysOK = True

259

n/a

return keysOK

260

n/a

261

n/a

if __name__ == '__main__':

262

n/a

#test the dialog

263

n/a

root=Tk()

264

n/a

def run():

265

n/a

keySeq=''

266

n/a

dlg=GetKeysDialog(root,'Get Keys','find-again',[])

267

n/a

print(dlg.result)

268

n/a

Button(root,text='Dialog',command=run).pack()

269

n/a

root.mainloop()

Python code coverage for Lib/idlelib/keybindingDialog.py