74 lines
1.9 KiB
Text
74 lines
1.9 KiB
Text
|
TITLE:: FileDialog
|
||
|
|
summary:: Operating system interface for Open file, save file, select directory dialogs
|
||
|
|
categories:: GUI>Accessories
|
||
|
|
related:: Classes/Dialog, Classes/File
|
||
|
|
|
||
|
|
DESCRIPTION::
|
||
|
|
This is the interface for your standard operating system modal file dialogs to open files, save files and select directories.
|
||
|
|
|
||
|
|
See also Dialog which makes it a bit simpler without the need to set fileMode and acceptMode manually.
|
||
|
|
|
||
|
|
At the moment selecting a directory is only possible with FileDialog.
|
||
|
|
|
||
|
|
CLASSMETHODS::
|
||
|
|
|
||
|
|
METHOD:: new
|
||
|
|
Open a modal dialog
|
||
|
|
|
||
|
|
ARGUMENT:: okFunc
|
||
|
|
handler function for: user selected a file and clicked ok.
|
||
|
|
Argument to the function is either a single path, an array of paths, or multiple paths passed in as separate arguments.
|
||
|
|
This depends on what fileMode and stripResult were specified.
|
||
|
|
|
||
|
|
ARGUMENT:: cancelFunc
|
||
|
|
handler function for: user cancelled
|
||
|
|
|
||
|
|
ARGUMENT:: fileMode
|
||
|
|
Integer
|
||
|
|
|
||
|
|
Determines the type of dialog.
|
||
|
|
|
||
|
|
list::
|
||
|
|
## 0 QFileDialog AnyFile The name of a file, whether it exists or not.
|
||
|
|
## 1 QFileDialog ExistingFile The name of a single existing file.
|
||
|
|
## 2 QFileDialog Directory The name of a directory. Both files and directories are displayed.
|
||
|
|
## 3 QFileDialog ExistingFiles The names of zero or more existing files.
|
||
|
|
::
|
||
|
|
|
||
|
|
0 or 3 implies that the user can type in a new file name.
|
||
|
|
|
||
|
|
ARGUMENT:: acceptMode
|
||
|
|
Integer
|
||
|
|
This determines what the accept button says: "Open" or "Save"
|
||
|
|
|
||
|
|
list::
|
||
|
|
## 0 QFileDialog AcceptOpen
|
||
|
|
## 1 QFileDialog AcceptSave
|
||
|
|
::
|
||
|
|
|
||
|
|
ARGUMENT:: stripResult
|
||
|
|
If selecting multiple files (using fileMode 3) then you have the choice of having your okFunc called with a list or with each of the paths as separate items.
|
||
|
|
|
||
|
|
If you want to select only one item then use stripResult = true so that your okFunc will be passed the item instead of a list.
|
||
|
|
|
||
|
|
list::
|
||
|
|
## true: okFunc(path1, path2, path3)
|
||
|
|
## false: okFunc(paths)
|
||
|
|
::
|
||
|
|
|
||
|
|
returns:: a FileDialog
|
||
|
|
|
||
|
|
METHOD:: qtClass
|
||
|
|
private
|
||
|
|
|
||
|
|
|
||
|
|
EXAMPLES::
|
||
|
|
|
||
|
|
code::
|
||
|
|
FileDialog({ |path|
|
||
|
|
|
||
|
|
}, {
|
||
|
|
|
||
|
|
});
|
||
|
|
::
|