 |
Reveal File |
Reveals a file in the Finder or Windows Explorer.
Syntax
Reveal File [ Select ; Result (error) ; FilePath ]
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 |
| FilePath | the path to the file 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 file 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 18 to FileMaker Pro 22 (2025)
Considerations
You can use FileMaker styled paths, like “filewin:/C:/MyFiles/test.txt”.
Example
Reveal File [ Select ; $ErrorCode ; "C:\readme.doc" ]This will make the file 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
gFilePath Global, textgFilePath should contain the path to the file, for example “D:\Logs\L01.TXT” (Windows) or “Mac HD:Logs:Log 1” (Mac). In a script add the following script step:
Reveal File [ Select ; gErrorCode ; gFilePath ]This will show the file specified by gFilePath in the Finder or Explorer. It will open the enclosing folder and show the file selected.
Related script steps
| Launch Application |
| Launch File |
| Open Folder |
| Reveal Folder |
Related function
| TrFile_Reveal |
Related topics
Troi File Plug-in online help (overview)