Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5   7.6    Statistic  

Files.LaunchFile

Launches the file.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Files 2.7 Yes Yes Yes No Yes

MBS( "Files.LaunchFile"; Path { ; NewInstance } )

Parameters

Parameter Description Example value
Path Native path to the item to reveal. "/Users/cs/Desktop/Notes.rtf"
NewInstance Optional
Available in MBS FileMaker Plugin 7.2 or newer.
Whether to launch new app instance on Mac.
Default is 0.
1

Result

Returns "OK" or error.

Description

Launches the file.
The OS will lookup what application is associated with the file type and launch the application asking it to open the document.

See also Files.Launch if you need to pass application and document.
If you launch a folder path, the folder will open in Finder/Explorer.

Please use Files.LaunchFile to open a file and Files.Launch to open a file in a specific application.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Shows a folder in Finder on Mac:

MBS( "Files.LaunchFile"; "/Users" )

Write container to temp file and launch:

# get temp folder
Set Variable [$TempFolder; Value:MBS( "Folders.SystemTemporary" )]
# and file name from container
Set Variable [$name; Value:MBS( "Path.LastPathComponent"; test::myContainer )]
# add name to folder path
Set Variable [$TempPath; Value:MBS( "Path.AddPathComponent"; $TempFolder; $name )]
# now write temp file
Set Variable [$r; Value:MBS( "Files.WriteFile"; test::myContainer; $TempPath)]
# and launch file
Set Variable [$r; Value:MBS( "Files.LaunchFile"; $TempPath)]

Launch new copy of same app:

MBS("Files.LaunchFile"; "/Applications/FileMaker Pro 15 Advanced/FileMaker Pro Advanced.app"; 1)

See also

Example Databases


Files.Launch   -   Files.List

Feedback: Report problem or ask question.




Links
MBS Xojo tutorial videos