Platforms to show: All Mac Windows Linux Cross-Platform
Back to NSWorkspaceOpenConfigurationMBS class.
NSWorkspaceOpenConfigurationMBS.activates as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is true, which causes the system to bring the app to the foreground.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.addsToRecentItems as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is true, which causes AppKit to add the items to the Recent Items menu.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.allowsRunningApplicationSubstitution as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
If an instance of an application is already running and is capable of opening the provided URLs, but the running instance is at a different URL, use the running application.
This property defaults to true. Set this to false if you let the user select between specific versions of an application, or let them choose a particular installation.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.appleEvent as Variant
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is nil, which causes the system to send a default Apple event, as needed. The system sends the event only if an instance of the app is already running.
This is an NSAppleEventDescriptorMBS object. But to avoid dependencies, we use a variant here.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.architecture as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is CPUTypeAny, which causes the system to launch the app’s preferred architecture. You may specify a different value to force the system to launch that architecture.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.createsNewApplicationInstance as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
When the value of this property is true, the system always launches a new version of the app, even if an existing copy is already running. The default value of this property is false, which causes the system to open the already running app when present.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.environment as Dictionary
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is an empty dictionary. When launching a new instance of an app, use this property to specify the key/value pairs for any environment variables.
If the calling process is sandboxed, the system ignores the value of this property.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.ForPrinting as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is false, which causes the app to open documents and URLs. Set the value to true if you want the app to print the items instead.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.Handle as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.hides as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is false, which leaves the app in its default state after launch. Setting the property to true causes the app to hide itself.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.hidesOthers as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is false, which leaves the visibility of other apps unchanged. Setting the property to true hides all apps except the one that launched.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.promptsUserIfNeeded as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
When the value of this property is true, the system presents a user interface to request or display relevant information. The system waits until the user dismisses the UI before calling any relevant completion handlers. The default value of this property is true.
(Read and Write property)
NSWorkspaceOpenConfigurationMBS.requiresUniversalLinks as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Cocoa | MBS MacCocoa Plugin | 26.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | All |
The default value of this property is false, which tells the app to open any URL you provide. Set the value to true when you want the app to open only valid universal links.
The app must be specifically configured to open universal links, and attempts to open such links fail with an appropriate error if the app isn’t properly configured. Attempts may also fail with an error if the user disabled support for opening links with the specified app.
(Read and Write property)
The items on this page are in the following plugins: MBS MacCocoa Plugin.