 |
Reveal Folder |
Reveals a folder in the Finder (on macOS) or in Windows Explorer.
Syntax
Reveal Folder [ Select ; Result (error) ; folderPath ]
Options
| Select entire contents | replaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field |
| Result (error) | an error code |
| FolderPath | the path to the folder to be revealed |
Returned Result
Data type returned
Error code
Result
The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:
| 0 | no error | The folder was revealed in the Finder or Explorer |
| $$-35 | nsVolErr | No such volume (Wrong disk name or not mounted) |
| $$-43 | fnfErr | File not found |
| $$-50 | paramErr | Parameter error |
Other errors may be returned.
Originated in
Troi File Plug-in 9.0
Compatibility
FileMaker Pro 17 to FileMaker Pro 21 (2024)
Considerations
You can use FileMaker styled paths, like “filewin:/C:/MyFiles/TheFolder”.
Example
Reveal Folder [ Select ; $ErrorCode ; "C:\MyFiles" ]This will make the folder visible in a Windows Explorer window and select it.
Example 2
We assume that in your FileMaker file the following fields are defined:
gErrorCode Global, number
gFolderPath Global, textgFolderPath should contain the path to the folder, for example “D:\Data\My Folder” (Windows) or “Mac HD:Data:My Folder” (Mac). In a script add the following script step:
Reveal Folder [ Select ; gErrorCode ; gFolderPath ]This will show the folder specified by gFolderPath in the Finder or Explorer. It will open the enclosing folder and show the folder selected.
Related script steps
| Launch File |
| Open Folder |
| Reveal File |
Related function
| TrFile_Reveal |
Related topics
Troi File Plug-in online help (overview)
