 |
TrFile_Launch |
Opens a file with the application that has registered it. This is the same application that would open it if you would manually double-click it.
Syntax
TrFile_Launch ( switches ; filePath ; { params } )
Parameters
| switches | not used, reserved for future use. Leave blank or put "-Unused" |
| filePath | the path to the file to be launched |
| params | (optional) extra parameters to be sent to the launching application (Windows only) |
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 opened with its application |
| $$-35 | nsVolErr | No such volume (Wrong disk name or not mounted) |
| $$-43 | fnfErr | File not found |
| $$-50 | paramErr | Parameter error |
| $$-1 | genericErr | The file could not be opened |
Other errors may be returned.
Originated in
Troi File Plug-in 1.2
Compatibility
FileMaker Pro 17 to FileMaker Pro 21 (2024)
Considerations
On the Mac the program that opens the file is determined by the FileType of the file.
On Windows this is determined by the 3 letter extension of the file.
So a text file “ReadMe.txt” will usually be opened by SimpleText (Mac) or WordPad (Windows).
On Windows you can add extra parameters to the launch command, which are then sent to the launching application.
Example
Set Field [ result ; TrFile_Launch ( "-Unused" ; "C:\readme.doc" ) ]This will open the file in the application Microsoft Word.
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:
Set Field [ gErrorCode ; TrFile_Launch ( "-Unused" ; gFilePath ) ]This will launch the file specified by gFilePath with its application.
Used in example file
LaunchAndReveal.fmp12
Related functions
| TrFile_GetCodeSignInfo |
| TrFile_Reveal |
Related script steps
| Launch Application |
| Launch File |
Related topics
Troi File Plug-in online help (overview)
