Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

App.SetProcessName

Sets the name of the current application.

Component Version macOS Windows Linux Server iOS SDK
App 3.2 ✅ Yes ❌ No ❌ No ✅ Yes, on macOS ❌ No
MBS( "App.SetProcessName"; name )   More

Parameters

Parameter Description Example
name The new name to display. "MyApp"

Result

Returns OK or error.

Description

Sets the name of the current application.
So for a runtime or FileMaker itself, this changes the name in the menubar.
Redraw may need a menu update.

See also App.SetDockIcon for changing dock icon and Menubar.SetMenuCommandTitle for changing some more menu entries.

Examples

Change app name:

Set Variable [ $r; Value:MBS("App.SetProcessName"; "My Great App") ]

Rename whole application menu:

Set Variable [ $r ; Value: MBS("App.SetProcessName"; "My Great App") ]
Set Variable [ $r ; Value: MBS("Menubar.SetMenuCommandTitle"; "FileMaker Pro¶Hide FileMaker Pro"; "Hide My Great App") ]
Set Variable [ $r ; Value: MBS("Menubar.SetMenuCommandTitle"; "FileMaker Pro¶Quit FileMaker Pro"; "Quit My Great App") ]
Set Variable [ $r ; Value: MBS("Menubar.SetMenuCommandTitle"; "FileMaker Pro¶About FileMaker Pro..."; "About My Great App...") ]

Fix app name for runtimes on macOS:

If [ Get(SystemPlatform) = 1 and MBS( "App.GetProcessName" ) = "Runtime" ] 
 Set Variable [ $r ; Value: MBS( "App.SetProcessName"; "MyGreatApp" ) ] 
End If

See also

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 8th October 2023


App.SetDockIcon - App.UserID