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
A Boolean value indicating whether the system activates the app and brings it to the foreground.

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
A Boolean value indicating whether to add the app or documents to the Recent Items menu.

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
A Boolean value that indicates whether to use a running instance of an application even if it’s at a different URL.

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 first Apple event to send to the new app.

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 architecture version of the app to launch.
Example
Var c As New NSWorkspaceOpenConfigurationMBS

// run Apple Silicon
c.architecture = c.CPUTypeARM64

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
A Boolean value indicating whether you want the system to launch a new instance of the app.

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 set of environment variables to set in a new app instance.

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
A Boolean value indicating whether you want to print the contents of documents and URLs instead of opening them.

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
The internal object reference.

(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
A Boolean value indicating whether you want the app to hide itself after it launches.

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
A Boolean value indicating whether you want to hide all apps except the one that launched.

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
A Boolean value indicating whether to display errors, authentication requests, or other UI elements to the user.

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
A Boolean value indicating whether you require the URL to have an associated universal link.

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.


The biggest plugin in space...