SINGLEINSTANCE Attribute | singleInstance Property

Internet Development Index

Sets or retrieves a value that indicates whether only one instance of the specified HTML Application (HTA) can run at a time.

Syntax

HTML<HTA:APPLICATION SINGLEINSTANCE = bOpen... >
Scripting[ bOpen = ] HTA:APPLICATION.singleInstance

Possible Values

bOpenBoolean that specifies one of the following values:
yesOnly one instance of the specified application can run at a time.
noDefault. Multiple instances of the specified application can run at the same time.

The property is read-only. The property has a default value of no.

Remarks

Note  The singleInstance property is read-only; however, the SINGLEINSTANCE attribute can be used to set the initial value.

When set to true, the singleInstance property checks the value of the applicationName property before launching an instance of the application. For this check to be valid, the applicationName property must have a unique value assigned to it. You can use the applicationName property to identify a single application, regardless of the URL used to access it.

Example

This example shows how to retrieve the singleInstance property.

<HTML>
<HEAD>
<HTA:APPLICATION ID="oHTA"
APPLICATIONNAME="myApp"
SINGLEINSTANCE="yes"
>
<SCRIPT>
alert("singleInstance    = " + oHTA.singleInstance);
</SCRIPT>
</HEAD>
<BODY SCROLL="no">
</BODY>
</HTML>
This feature requires Microsoft® Internet Explorer 5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

HTA:APPLICATION

See Also

Introduction to HTML Applications (HTAs)