| 1 | "Dialog to specify or edit the parameters for a user configured help source."
|
|---|
| 2 |
|
|---|
| 3 | import os
|
|---|
| 4 | import sys
|
|---|
| 5 |
|
|---|
| 6 | from Tkinter import *
|
|---|
| 7 | import tkMessageBox
|
|---|
| 8 | import tkFileDialog
|
|---|
| 9 |
|
|---|
| 10 | class GetHelpSourceDialog(Toplevel):
|
|---|
| 11 | def __init__(self, parent, title, menuItem='', filePath=''):
|
|---|
| 12 | """Get menu entry and url/ local file location for Additional Help
|
|---|
| 13 |
|
|---|
| 14 | User selects a name for the Help resource and provides a web url
|
|---|
| 15 | or a local file as its source. The user can enter a url or browse
|
|---|
| 16 | for the file.
|
|---|
| 17 |
|
|---|
| 18 | """
|
|---|
| 19 | Toplevel.__init__(self, parent)
|
|---|
| 20 | self.configure(borderwidth=5)
|
|---|
| 21 | self.resizable(height=FALSE, width=FALSE)
|
|---|
| 22 | self.title(title)
|
|---|
| 23 | self.transient(parent)
|
|---|
| 24 | self.grab_set()
|
|---|
| 25 | self.protocol("WM_DELETE_WINDOW", self.Cancel)
|
|---|
| 26 | self.parent = parent
|
|---|
| 27 | self.result = None
|
|---|
| 28 | self.CreateWidgets()
|
|---|
| 29 | self.menu.set(menuItem)
|
|---|
| 30 | self.path.set(filePath)
|
|---|
| 31 | self.withdraw() #hide while setting geometry
|
|---|
| 32 | #needs to be done here so that the winfo_reqwidth is valid
|
|---|
| 33 | self.update_idletasks()
|
|---|
| 34 | #centre dialog over parent:
|
|---|
| 35 | self.geometry("+%d+%d" %
|
|---|
| 36 | ((parent.winfo_rootx() + ((parent.winfo_width()/2)
|
|---|
| 37 | -(self.winfo_reqwidth()/2)),
|
|---|
| 38 | parent.winfo_rooty() + ((parent.winfo_height()/2)
|
|---|
| 39 | -(self.winfo_reqheight()/2)))))
|
|---|
| 40 | self.deiconify() #geometry set, unhide
|
|---|
| 41 | self.bind('<Return>', self.Ok)
|
|---|
| 42 | self.wait_window()
|
|---|
| 43 |
|
|---|
| 44 | def CreateWidgets(self):
|
|---|
| 45 | self.menu = StringVar(self)
|
|---|
| 46 | self.path = StringVar(self)
|
|---|
| 47 | self.fontSize = StringVar(self)
|
|---|
| 48 | self.frameMain = Frame(self, borderwidth=2, relief=GROOVE)
|
|---|
| 49 | self.frameMain.pack(side=TOP, expand=TRUE, fill=BOTH)
|
|---|
| 50 | labelMenu = Label(self.frameMain, anchor=W, justify=LEFT,
|
|---|
| 51 | text='Menu Item:')
|
|---|
| 52 | self.entryMenu = Entry(self.frameMain, textvariable=self.menu,
|
|---|
| 53 | width=30)
|
|---|
| 54 | self.entryMenu.focus_set()
|
|---|
| 55 | labelPath = Label(self.frameMain, anchor=W, justify=LEFT,
|
|---|
| 56 | text='Help File Path: Enter URL or browse for file')
|
|---|
| 57 | self.entryPath = Entry(self.frameMain, textvariable=self.path,
|
|---|
| 58 | width=40)
|
|---|
| 59 | self.entryMenu.focus_set()
|
|---|
| 60 | labelMenu.pack(anchor=W, padx=5, pady=3)
|
|---|
| 61 | self.entryMenu.pack(anchor=W, padx=5, pady=3)
|
|---|
| 62 | labelPath.pack(anchor=W, padx=5, pady=3)
|
|---|
| 63 | self.entryPath.pack(anchor=W, padx=5, pady=3)
|
|---|
| 64 | browseButton = Button(self.frameMain, text='Browse', width=8,
|
|---|
| 65 | command=self.browseFile)
|
|---|
| 66 | browseButton.pack(pady=3)
|
|---|
| 67 | frameButtons = Frame(self)
|
|---|
| 68 | frameButtons.pack(side=BOTTOM, fill=X)
|
|---|
| 69 | self.buttonOk = Button(frameButtons, text='OK',
|
|---|
| 70 | width=8, default=ACTIVE, command=self.Ok)
|
|---|
| 71 | self.buttonOk.grid(row=0, column=0, padx=5,pady=5)
|
|---|
| 72 | self.buttonCancel = Button(frameButtons, text='Cancel',
|
|---|
| 73 | width=8, command=self.Cancel)
|
|---|
| 74 | self.buttonCancel.grid(row=0, column=1, padx=5, pady=5)
|
|---|
| 75 |
|
|---|
| 76 | def browseFile(self):
|
|---|
| 77 | filetypes = [
|
|---|
| 78 | ("HTML Files", "*.htm *.html", "TEXT"),
|
|---|
| 79 | ("PDF Files", "*.pdf", "TEXT"),
|
|---|
| 80 | ("Windows Help Files", "*.chm"),
|
|---|
| 81 | ("Text Files", "*.txt", "TEXT"),
|
|---|
| 82 | ("All Files", "*")]
|
|---|
| 83 | path = self.path.get()
|
|---|
| 84 | if path:
|
|---|
| 85 | dir, base = os.path.split(path)
|
|---|
| 86 | else:
|
|---|
| 87 | base = None
|
|---|
| 88 | if sys.platform[:3] == 'win':
|
|---|
| 89 | dir = os.path.join(os.path.dirname(sys.executable), 'Doc')
|
|---|
| 90 | if not os.path.isdir(dir):
|
|---|
| 91 | dir = os.getcwd()
|
|---|
| 92 | else:
|
|---|
| 93 | dir = os.getcwd()
|
|---|
| 94 | opendialog = tkFileDialog.Open(parent=self, filetypes=filetypes)
|
|---|
| 95 | file = opendialog.show(initialdir=dir, initialfile=base)
|
|---|
| 96 | if file:
|
|---|
| 97 | self.path.set(file)
|
|---|
| 98 |
|
|---|
| 99 | def MenuOk(self):
|
|---|
| 100 | "Simple validity check for a sensible menu item name"
|
|---|
| 101 | menuOk = True
|
|---|
| 102 | menu = self.menu.get()
|
|---|
| 103 | menu.strip()
|
|---|
| 104 | if not menu:
|
|---|
| 105 | tkMessageBox.showerror(title='Menu Item Error',
|
|---|
| 106 | message='No menu item specified',
|
|---|
| 107 | parent=self)
|
|---|
| 108 | self.entryMenu.focus_set()
|
|---|
| 109 | menuOk = False
|
|---|
| 110 | elif len(menu) > 30:
|
|---|
| 111 | tkMessageBox.showerror(title='Menu Item Error',
|
|---|
| 112 | message='Menu item too long:'
|
|---|
| 113 | '\nLimit 30 characters.',
|
|---|
| 114 | parent=self)
|
|---|
| 115 | self.entryMenu.focus_set()
|
|---|
| 116 | menuOk = False
|
|---|
| 117 | return menuOk
|
|---|
| 118 |
|
|---|
| 119 | def PathOk(self):
|
|---|
| 120 | "Simple validity check for menu file path"
|
|---|
| 121 | pathOk = True
|
|---|
| 122 | path = self.path.get()
|
|---|
| 123 | path.strip()
|
|---|
| 124 | if not path: #no path specified
|
|---|
| 125 | tkMessageBox.showerror(title='File Path Error',
|
|---|
| 126 | message='No help file path specified.',
|
|---|
| 127 | parent=self)
|
|---|
| 128 | self.entryPath.focus_set()
|
|---|
| 129 | pathOk = False
|
|---|
| 130 | elif path.startswith(('www.', 'http')):
|
|---|
| 131 | pass
|
|---|
| 132 | else:
|
|---|
| 133 | if path[:5] == 'file:':
|
|---|
| 134 | path = path[5:]
|
|---|
| 135 | if not os.path.exists(path):
|
|---|
| 136 | tkMessageBox.showerror(title='File Path Error',
|
|---|
| 137 | message='Help file path does not exist.',
|
|---|
| 138 | parent=self)
|
|---|
| 139 | self.entryPath.focus_set()
|
|---|
| 140 | pathOk = False
|
|---|
| 141 | return pathOk
|
|---|
| 142 |
|
|---|
| 143 | def Ok(self, event=None):
|
|---|
| 144 | if self.MenuOk() and self.PathOk():
|
|---|
| 145 | self.result = (self.menu.get().strip(),
|
|---|
| 146 | self.path.get().strip())
|
|---|
| 147 | if sys.platform == 'darwin':
|
|---|
| 148 | path = self.result[1]
|
|---|
| 149 | if path.startswith(('www', 'file:', 'http:')):
|
|---|
| 150 | pass
|
|---|
| 151 | else:
|
|---|
| 152 | # Mac Safari insists on using the URI form for local files
|
|---|
| 153 | self.result = list(self.result)
|
|---|
| 154 | self.result[1] = "file://" + path
|
|---|
| 155 | self.destroy()
|
|---|
| 156 |
|
|---|
| 157 | def Cancel(self, event=None):
|
|---|
| 158 | self.result = None
|
|---|
| 159 | self.destroy()
|
|---|
| 160 |
|
|---|
| 161 | if __name__ == '__main__':
|
|---|
| 162 | #test the dialog
|
|---|
| 163 | root = Tk()
|
|---|
| 164 | def run():
|
|---|
| 165 | keySeq = ''
|
|---|
| 166 | dlg = GetHelpSourceDialog(root, 'Get Help Source')
|
|---|
| 167 | print dlg.result
|
|---|
| 168 | Button(root,text='Dialog', command=run).pack()
|
|---|
| 169 | root.mainloop()
|
|---|
