IEZoneSettings Object

Applies to TestComplete 14.0, last modified on January 23, 2019

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 10 and later.

XAML Browser Applications

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

Available in Internet Explorer 10 and later.

XPS Documents

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

Available in Internet Explorer 10 and later.

.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 10 and later.

Allow previously unused ActiveX controls to run without prompt

Property: AllowUnusedActiveXControlsToRunWithoutPrompt. Boolean. Read/Write.

Available in Internet Explorer 10 and later.

Allow Scriptlets

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

Available in Internet Explorer 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

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 10 and later.

Allow websites to prompt for information using scripted windows

Property: AllowInformationPromptUsingScriptedWindows. Boolean. Read/Write.

Available in Internet Explorer 10 and later.

Enable XSS filter

Property: EnableXSSFilter. Boolean. Read/Write.

Available in Internet Explorer 10 and later.

Scripting of Java applets

Property: ScriptingOfJavaApplets. Integer. Read/Write. Possible values:
  • 0 - Enable
  • 1 - Prompt
  • 3 - Disable
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

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