1715 posts
ACDC Town
Posted 19 September 2016 - 01:53 AM
Way back when I first coded Whisk (or heck, even back when I had to use other people's file transfer programs), I kinda found it cumbersome to remember the names of files and type them into a prompt to send it or whatever. I know, a nitpick…but no longer!
(by the way I am listening to some epic music; forgive my glamour)
The idea is that it can be easily snuck into your program code so you can have the user select a file/folder with a file manager instead of through a read() prompt. Makes it way better.
One cool thing this does it that the whole interface can be fit into a rectangle (x1,y1,x2,y2), so you can slip the thing into an existing GUI!
I made this primarily for Whisk, but this can be used anywhere.
HOW TO USE: (recommended)
Let me explain.
If anything goes wrong, or if you click 'close', then it will return false instead of a string.
CONTROLS:
Use the mouse to select items on the menu.
Use LEFT/RIGHT CLICK to select files or navigate in folders.
Use MIDDLECLICK to return folders instead of going in them.
Use MOUSEWHEEL or UPARROW and DOWNARROW to scroll up and down.
Use PAGEUP or PAGEDOWN to go up and down exactly one page's worth.
Use HOME and END to go to the top and bottom, respectively.
Use ENTER to return the current directory.
makeMenu(insert arguments here) will return the path of the file/folder selected.
SCREENSHOTS:
This is when you don't enter any arguments into makeMenu(). White text is files, yellow is folders, and the scrollbar is on the right. The path is up on the top, by the way.
This is the same thing…but rendered between (4,3) and (28,16)! I made sure no text leaks out of it, so don't worry.
In another update, I might add a text prompt in addition to the file select GUI.
When putting this in a program, feel free to strip any blank newlines or comments. I added them for clarity, mostly.
(by the way I am listening to some epic music; forgive my glamour)
LDDFM
The idea is that it can be easily snuck into your program code so you can have the user select a file/folder with a file manager instead of through a read() prompt. Makes it way better.
One cool thing this does it that the whole interface can be fit into a rectangle (x1,y1,x2,y2), so you can slip the thing into an existing GUI!
I made this primarily for Whisk, but this can be used anywhere.
pastebin get wfdb986Z lddfm
std PB wfdb986Z lddfm
HOW TO USE: (recommended)
Spoiler
There is only one function, so it's not too involved. Which is the point.
makeMenu(x1,y1,x2,y2, _path,_noFiles,_noFolders,_noCD,_noSelectFolders)
Let me explain.
- x1 and y1: Numbers. These are the TOP LEFT coordinates of the file manager interface. Defaults to the top-left corner of the screen.
- x2 and y2: Numbers. The same thing, but for the BOTTOM RIGHT coordinates. Defaults to the bottom-right corner of the screen.
- _path: String. The directory that the file manager starts out in. Defaults to root. ("/")
- _noFiles: Boolean. If true, will filter out all files from the list. I just added this feature just in case. Defaults to false, of course.
- _noFolders: Boolean. Same thing, but filters out all folders instead. Again, if you need it. Also prevents you from selecting the current directory. Defaults to false.
- _noCD: Boolean. If true, then you won't be able to change directories, as well as selecting the current directory. Defaults to false.
- _noSelectFolders: Boolean. Pretty self-explanatory; if true, will prevent you from selecting any folders. You can still navigate them. Defaults to false.
- _doHidden: Boolean. If true, will display hidden files and folders (starts with '.'). Defaults to false.
- _p: Table. This is where you could add a custom table of colors. Look inside the code to see which table entries you have to change.
- _canClose: Boolean. If true, a button labeled 'close' will be at the top-right part of the screen to click. Defaults to false.
If anything goes wrong, or if you click 'close', then it will return false instead of a string.
CONTROLS:
Use the mouse to select items on the menu.
Use LEFT/RIGHT CLICK to select files or navigate in folders.
Use MIDDLECLICK to return folders instead of going in them.
Use MOUSEWHEEL or UPARROW and DOWNARROW to scroll up and down.
Use PAGEUP or PAGEDOWN to go up and down exactly one page's worth.
Use HOME and END to go to the top and bottom, respectively.
Use ENTER to return the current directory.
makeMenu(insert arguments here) will return the path of the file/folder selected.
SCREENSHOTS:
Spoiler
This is when you don't enter any arguments into makeMenu(). White text is files, yellow is folders, and the scrollbar is on the right. The path is up on the top, by the way.
This is the same thing…but rendered between (4,3) and (28,16)! I made sure no text leaks out of it, so don't worry.
In another update, I might add a text prompt in addition to the file select GUI.
When putting this in a program, feel free to strip any blank newlines or comments. I added them for clarity, mostly.
Edited on 20 September 2016 - 05:01 PM
