IEZoneSettings Object

Applies to TestComplete 15.68, last modified on October 16, 2024

The IEZoneSettings object provides a scripting interface to settings of Internet Explorer’s security zone. To obtain the object in scripts, use the GetZoneSettingsById or GetZoneSettingsByUrl methods of the IEZoneSettingsManager object.

The object properties correspond to the security zone settings that are displayed in the Security Settings dialog of Internet Explorer (to display it, select Tools | Internet Options from Internet Explorer’s menu, switch to the Security page and click Custom Level).

Below is a list of object properties with brief descriptions. The properties are ordered by the Internet Explorer setting groups’ and settings’ names.

Two properties do not correspond to Internet Explorer settings:

Property Description
ZoneId Integer. Read-Only. Specifies the identifier of the zone, to which the given IEZoneSettings object corresponds.
ZoneName String. Read-Only. Specifies the name of the zone, to which the given IEZoneSettings object corresponds.
.NET Framework

Loose XAML

Property: LooseXAML. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

XAML Browser Applications

Property: WinFXBrowserApplications. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

XPS Documents

Property: XPSDocuments. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

.NET Framework-reliant components

Run components not signed with Authenticode

Property: RunNotSignedDotNETComponents. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Run components signed with Authenticode

Property: RunSignedDotNETComponents. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
ActiveX controls and plugins

Only allow approved domains to use ActiveX without prompt

Property: AllowActiveXControlsToRunWithoutPromptInApprovedDomains. Boolean. Read/Write.

Available in Internet Explorer 11.

Allow previously unused ActiveX controls to run without prompt

Property: AllowUnusedActiveXControlsToRunWithoutPrompt. Boolean. Read/Write.

Available in Internet Explorer 11.

Allow Scriptlets

Property: AllowScriptlets. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

Automatic prompting for ActiveX controls

Property: AutoPromptForActiveXControls. Boolean. Read/Write.

Binary and script behaviors

Property: BinaryAndScriptBehaviors. Integer. Read/Write. Possible values:
  • (Hex) 00010000 - Administrator approved
  • 0 - Enable
  • 3 - Disable

Display video and animation on a web page that does not use external media player

Property: DisplayDynSrcImageContent. Boolean. Read/Write.

Available in Internet Explorer 11.

Download signed ActiveX controls

Property: DownloadSignedActiveXControls. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Download unsigned ActiveX controls

Property: DownloadUnsignedActiveXControls. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Initialize and run ActiveX controls not marked as safe

Property: ScriptNotSafeActiveXControls. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Run ActiveX controls and plugins

Property: RunActiveXControlsAndPlugIns. Integer. Read/Write. Possible values:
  • (Hex) 00010000 - Administrator approved
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Script ActiveX controls marked safe for scripting

Property: ScriptSafeActiveXControls. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
Downloads

Automatic prompting for file downloads

Property: AutoPromptForFileDownload. Boolean. Read/Write.

File download

Property: FileDownloadEnabled. Boolean. Read/Write.

Font download

Property: FontDownload. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
Enable .NET Framework Components Setup

Enable .NET Framework Components Setup

Property: NetFrameworkSetupEnabled. Boolean. Read/Write.

Available in Internet Explorer 11.

Java VM

Java Permissions

Property: JavaPermissions. Integer. Read/Write. Possible values:
  • (Hex) 00000000 - Disable Java
  • (Hex) 00010000 - High safety
  • (Hex) 00020000 - Medium safety
  • (Hex) 00030000 - Low safety
  • (Hex) 00800000 - Custom

Available in Internet Explorer 11.

File download

Property: FileDownloadEnabled. Boolean. Read/Write.

Font download

Property: FontDownload. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
Miscellaneous

Access data sources across domains

Property: AccessDataSourcesAcrossDomain. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Allow META REFRESH

Property: AllowMetaRefresh. Boolean. Read/Write.

Allow script-initiated windows without size or position constraints

Property: AllowNotConstrainedScriptWindows. Boolean. Read/Write.

Allow web sites to open windows without address or status bars

Property: AllowWindowsWithoutAddressOrStatusBars. Boolean. Read/Write.

Available in Internet Explorer 11.

Allow web pages to use restricted protocols for active content

Property: AllowRestrictedProtocolsForActiveContent. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Allow scripting of Internet Explorer WebBrowser control

Property: AllowScriptingOfWebbrowserControl. Boolean. Read/Write.

Display mixed content

Property: DisplayMixedContent. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Don't prompt for client certificate selection when no certificates or only one certificate exists

Property: SuppressOddCertificateSelectionPrompt. Boolean. Read/Write.

Drag and drop or copy and paste files

Property: DragAndDropFiles. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Include local directory path when uploading files to a server

Property: IncludeLocalPathWhenUploadingFiles. Boolean. Read/Write.

Available in Internet Explorer 11.

Installation of desktop items

Property: InstallationOfDesktopItems. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Launching applications and unsafe files

Property: LaunchingApplicationsAndUnsafeFiles. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

Launching programs and files in an IFRAME

Property: LaunchingProgramsInIFRAME. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Navigate sub-frames across different domains

Property: NavigateSubFramesAcrossDomains. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Open files based on content, not file extension

Property: OpenFilesBasedOnContent. Boolean. Read/Write.

Protected mode

Property: ProtectedMode. Boolean. Read/Write.

Available in Internet Explorer 11.

Software channel permissions

Property: SoftwareChannelPermissions. Integer. Read/Write. Possible values:
  • (Hex) 00010000 - High safety
  • (Hex) 00020000 - Medium safety
  • (Hex) 00030000 - Low safety

Submit nonencrypted form data

Property: SubmitNonencryptedFromData. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Use Phishing Filter

Property: UsePhishingFilter. Boolean. Read/Write.

Available in Internet Explorer 11.

Use Pop-up Blocker

Property: UsePopupBlocker. Boolean. Read/Write.

Userdata persistence

Property: UserdataPersistence. Boolean. Read/Write.

Web sites in less privileged web content zone can navigate into this zone

Property: NavigateFromLowerZoneToThisZone. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
Scripting

Active scripting

Property: ActiveScripting. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Allow paste operations via script

Property: AllowScriptPasteOperations. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Allow status bar updates via script

Property: AllowScriptStatusBarUpdates. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable

Available in Internet Explorer 11.

Allow websites to prompt for information using scripted windows

Property: AllowInformationPromptUsingScriptedWindows. Boolean. Read/Write.

Available in Internet Explorer 11.

Enable XSS filter

Property: EnableXSSFilter. Boolean. Read/Write.

Available in Internet Explorer 11.

Scripting of Java applets

Property: ScriptingOfJavaApplets. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
Note:

Support for Java applet has been removed from Java version 11.
User Authentication

Logon

Property: UserAuthentication. Integer. Read/Write. Possible values:
  • 0 - Automatic logon with current username and password
  • (Hex) 00010000 - Prompt for user name and password
  • (Hex) 00020000 - Automatic logon only in Intranet zone
  • (Hex) 00030000 - Anonymous logon

Example

The code below changes the value of the Run ActiveX controls and plugins option, performs some test commands and then restores the option's value at the end of the test.

JavaScript, JScript
Python
VBScript
DelphiScript
C++Script, C#Script
Copy Code

JavaScript, JScript

function IEZoneDemo()
{
  // Obtains the Zone Settings object of the "My Computer" zone
  var MyCompZoneID = 0;
  var ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID);
  
  // Saves the current value of the option
  var currentVal = ieOptions.RunActiveXControlsAndPlugIns;
  //Changes the value of the option
  ieOptions.RunActiveXControlsAndPlugIns = 1;
  // ...
  // Performs test commands
  // ...
  
  // Restores the option's value
  ieOptions.RunActiveXControlsAndPlugIns = currentVal;
}

Python

def IEZoneDemo():

  # Obtains the Zone Settings object of the "My Computer" zone
  MyCompZoneID = 0
  ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID)
  
  # Saves the current value of the option
  currentVal = ieOptions.RunActiveXControlsAndPlugIns
  #Changes the value of the option
  ieOptions.RunActiveXControlsAndPlugIns = 1
  # ...
  # Performs test commands
  # ...
  
  # Restores the option's value
  ieOptions.RunActiveXControlsAndPlugIns = currentVal

VBScript

Sub IEZoneDemo()

  ' Obtains the Zone Settings object of the "My Computer" zone
  MyCompZoneIDD = 0
  Set ieOptions = Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID)
  
  ' Saves the current value of the option
  currentVall = ieOptions.RunActiveXControlsAndPlugIns
  ' Changes the value of the option
  ieOptions.RunActiveXControlsAndPlugIns = 1
  ' ...
  ' Performs test commands
  ' ...
  
  ' Restores the option's value
  ieOptions.RunActiveXControlsAndPlugIns = currentVal
  
End Sub

DelphiScript

function IEZoneDemo;
var MyCompZoneID, ieOptions, currentVal;
begin

  // Obtains the Zone Settings object of the "My Computer" zone
  MyCompZoneID := 0;
  ieOptions := Options.IEZoneSettings.GetZoneSettingsById(MyCompZoneID);
  
  // Saves the current value of the option
  currentVal := ieOptions.RunActiveXControlsAndPlugIns;
  //Changes the value of the option
  ieOptions.RunActiveXControlsAndPlugIns := 1;
  // ...
  // Performs test commands
  // ...
  
  // Restores the option's value
  ieOptions.RunActiveXControlsAndPlugIns := currentVal;

end;

C++Script, C#Script

function IEZoneDemo()
{
  // Obtains the Zone Settings object of the "My Computer" zone
  var MyCompZoneID = 0;
  var ieOptions = Options["IEZoneSettings"]["GetZoneSettingsById"](MyCompZoneID);
  
  // Saves the current value of the option
  var currentVal = ieOptions["RunActiveXControlsAndPlugIns"];
  //Changes the value of the option
  ieOptions["RunActiveXControlsAndPlugIns"] = 1;
  // ...
  // Performs test commands
  // ...
  
  // Restores the option's value
  ieOptions["RunActiveXControlsAndPlugIns"] = currentVal;
}

See Also

Options.IEZoneSettings
GetZoneSettingsById Method
GetZoneSettingsByUrl Method

Highlight search results