put-file in Dialogs
(put-file-> path ormessageparentdirectoryfilenameextensionstylefilters)#f
message=#f: string or#f
parent=#f:frame%ordialog%object or#f
directory=#f: path or#f
filename=#f: path or#f
extension=#f: string or#f
style=null: list of symbols in'(packages enter-packages)
filters=: list of 2-string lists'(("Any" "*.*"))Obtains a file pathname from the user via the platform-specific standard (modal) dialog, using
parentas the parent window if it is specified, and usingmessageas a message at the top of the dialog if it is not#f.The result is
#fif the user cancels the dialog, the selected pathname otherwise. The returned pathname may or may not exist, although the style of the dialog is directed towards creating a new file.If
directoryis not#f, it is used as the starting directory for the file selector (otherwise the starting directory is chosen automatically in a platform-specific manner, usually based on the current directory and the user's interactions in previous calls toget-file,put-file, etc.). Iffilenameis not#f, it is used as the default filename when appropriate, and it should not contain a directory path prefix.Under Windows, if
extensionis not#f, the returned path will gets a default extension if the user does not supply one. Ifextensionis the empty string, then the extension is derived from the user'sfilterschoice if the corresponding pattern is of the form"*.; if the pattern isextension""*.*", then no default extension is added. Finally, ifextensionis any string other than the empty string,extensionis used as the default extension when the user'sfilterschoice has the pattern"*.*". Meanwhile, thefiltersargument has the same format and auxiliary role as forget-file. In particular, if the only pattern infiltersis"*., then the result pathname is guaranteed to have an extenson mappingextension"extension.Under Mac OS X, if
extensionis not#fandfilterscontains the single pattern"*., then the result pathname is guaranteed to have an extenson mappingextension"extension. Otherwise,extensionandfiltersare ignored.The
extensionandfiltersarguments are always ignored under Unix.If
stylelist matters only under Mac OS X, and it is treated as forget-file.