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

Files.Launch

Launches the file.

Component: Files
Version: 2.7
Mac OS X: Yes
Windows: Yes
Server: Yes
FileMaker Cloud: No

MBS( "Files.Launch"; AppPath { ; DocPath; NewInstance } )

Parameters

Parameter Description Example value
AppPath Native path to the application to launch. "/Applications/TextEdit.app"
DocPath Optional
Optional, Native path to the document to pass as argument.
Must be text to distingush from flag, which are numbers.
"/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.
You can use this function to open a database file with FileMaker or your runtime solution. Query with Files.AppPath the path to your application. Than call Launch with that application path and your database file path.

See also Files.LaunchFile if you need to open a document.

Version 5.3 supports passing several DocPath parameters.
With version 7.2 the last parameter can be a number with 0 or 1 to define whether to run a new app instance.

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

Launch two text files in Textedit:

MBS( "Files.Launch"; "/Applications/TextEdit.app"; "/Users/cs/Desktop/filme.rtf"; "/Users/cs/Desktop/test.rtf" )

Run notepad on Windows with a text file:

MBS("Files.Launch"; "notepad"; "C:\Users\Christian\Desktop\test2.txt")

Launch iMessages app:

MBS( "Files.Launch"; "/Applications/Messages.app")

Launch Mail application:

MBS( "Files.Launch"; "/Applications/Mail.app")

Restart FileMaker with same database:

Set Variable [$dbpath; Value:Get ( FilePath )]
Set Variable [$dbpath; Value:MBS( "Path.FileMakerPathToNativePath"; $dbpath )]
Set Variable [$apppath; Value:MBS( "App.GetProcessPath" )]
Set Variable [$r; Value:MBS( "Files.Launch"; $apppath; $dbpath; 1 )]
Exit Application

See also


Files.ItemExists   -   Files.LaunchFile

Feedback: Report problem or ask question.




Links
MBS REAL studio tutorial videos - Nachhilfe in Wassenach