aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorjwansek <eddie.atten.ea29@gmail.com>2018-10-24 17:04:04 +0100
committerjwansek <eddie.atten.ea29@gmail.com>2018-10-24 17:04:04 +0100
commit614d9b37507f1f0085cf4d51eabb3d22feca612a (patch)
tree1b1d3cd462420853c2d8f15d84a78405e76090d4
parent0a7df95dcfb399571be33a4dd465dce35d5773a5 (diff)
downloadtkFileBrowser-614d9b37507f1f0085cf4d51eabb3d22feca612a.tar.gz
tkFileBrowser-614d9b37507f1f0085cf4d51eabb3d22feca612a.zip
updated readme
-rw-r--r--README.md43
-rw-r--r--demoimage.pngbin0 -> 24162 bytes
-rw-r--r--tkFileBrowser.py2
3 files changed, 44 insertions, 1 deletions
diff --git a/README.md b/README.md
index 4fac058..aebb705 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,45 @@
# tkFileBrowser
A file browser designed for use with Python tkinter applications
+
+![Demo image]((https://i.imgur.com/IXld2Ty.png))
+
+* Uses the Windows API to get the exact icon for any folder or application.
+* Refreshes when drives are added or removed
+* Final version will refresh the tree too
+
+## Example Usage
+
+ def on_click(path):
+ print("click: ", path)
+
+ if __name__ == "__main__":
+ root = tk.Tk()
+ browser = TkFileBrowser(root, on_click)
+ browser.pack(side = tk.LEFT)
+
+ ttk.Button(root, text = "Goto", command = lambda: browser.see(r"C:\Any\file\or\folder")).pack(side = tk.LEFT)
+
+ root.mainloop()
+
+## Documentation
+TkFileBrowser(parent, command, [refresh = 20], [types = []], [showhidden = False])
+
+> parent
+
+Frame in which the widget will be placed
+
+>command
+
+Function to be run when the user clicks on a file. The path is an argument
+
+>refresh
+
+How often to check for updates in the file system. Default 20ms
+
+>types
+
+List of file types that will show up. Empty means all files. Default []
+
+>showhidden
+
+Show hidden files "." or not. Default False
diff --git a/demoimage.png b/demoimage.png
new file mode 100644
index 0000000..78bd13e
--- /dev/null
+++ b/demoimage.png
Binary files differ
diff --git a/tkFileBrowser.py b/tkFileBrowser.py
index a98c2fe..8b88606 100644
--- a/tkFileBrowser.py
+++ b/tkFileBrowser.py
@@ -335,6 +335,6 @@ if __name__ == "__main__":
browser = TkFileBrowser(root, on_click)
browser.pack(side = tk.LEFT)
- ttk.Button(root, text = "Goto", command = lambda: browser.see(r"C:\Users\Edward\Documents\random_pyapps")).pack(side = tk.LEFT)
+ ttk.Button(root, text = "Goto", command = lambda: browser.see(r"C:\Any\file\or\folder")).pack(side = tk.LEFT)
root.mainloop() \ No newline at end of file