Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  

Shell.AddArgument

Adds an argument.

Component Version macOS Windows Linux Server iOS SDK
Shell 7.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ❌ No
MBS( "Shell.AddArgument"; ShellRef; Argument { ; More Arguments } )   More

Parameters

Parameter Description Example Flags
ShellRef The reference number from the shell. $shell
Argument The new argument. "-l"
More Arguments Available in MBS FileMaker Plugin 8.3 or newer.
Add more parameters to add more arguments.
Optional

Result

Returns OK or error.

Description

Adds an argument.
This argument is added to the list of arguments passed first on each call to Shell.Execute.
With version 8.3, you can add several arguments here.

Examples

Adds an argument:

MBS( "Shell.AddArgument"; $shell; "-v" )

Send email via Outlook.exe with options via command line:

Set Variable [ $app ; Value: "C:\Program Files (x86)\Microsoft Office\Office15\OUTLOOK.EXE" ]
Set Variable [ $attachment ; Value: "C:\Users\Administrator\Desktop\test.jpg" ]
Set Variable [ $to ; Value: "to@test.com" ]
Set Variable [ $subject ; Value: "Test Email" ]
Set Variable [ $cc ; Value: "copy@test.com" ]
Set Variable [ $body ; Value: "Hello World" ]
Set Variable [ $shell ; Value: MBS( "Shell.New" ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/c" ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "ipm.note" ) ]
If [ not IsEmpty ( $attachment ) ]
    Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/a" ) ]
    Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; $attachment ) ]
End If
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/m" ) ]
Set Variable [ $a1 ; Value: MBS( "Text.EncodeURLComponent"; $to; "UTF-8" ) ]
Set Variable [ $a2 ; Value: "?subject=" & MBS( "Text.EncodeURLComponent"; $subject; "UTF-8" ) ]
Set Variable [ $a3 ; Value: If ( Length ( $cc ) > 0 ; "&cc=" & MBS( "Text.EncodeURLComponent"; $cc; "UTF-8" ); "" ) ]
Set Variable [ $a4 ; Value: If ( Length ( $body) > 0 ; "&body=" & MBS( "Text.EncodeURLComponent"; $body ; "UTF-8" ) ; "") ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; $a1 & $a2 & $a3 & $a4) ]
Set Variable [ $s ; Value: MBS( "Shell.Execute"; $shell; $app) ]
Set Variable [ $r ; Value: MBS("Shell.Release"; $shell) ]

Adds three arguments:

MBS( "Shell.AddArgument"; $shell; "-v"; "-r"; "-e" )

See also

Example Databases

Blog Entries

Created 11st November 2017, last changed 16th September 2018


SharingService.ShareItems - Shell.AddEnvironment

Feedback: Report problem or ask question.