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   8.0    Statistic  

Shell.AddArgument

Adds an argument.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Shell 7.5 Yes Yes Yes Yes No

MBS( "Shell.AddArgument"; ShellRef; Argument )

Parameters

Parameter Description Example value
ShellRef The reference number from the shell. $shell
Argument The new argument. "-l"

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.

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) ]

See also


SetSystemUIMode   -   Shell.AddEnvironment

Feedback: Report problem or ask question.




Links
MBS FileMaker tutorial videos