Agent Options

The following table lists the AgentClass options that can be manipulated with the GetOption method and SetOption method. Only options that can be manipulated by the user are listed here; other options are for internal use only.
Agent Option Agent Supported Description
OPT_AGENT_CLICKS_ONLY Classic Agent

BOOLEAN

FALSE to use the API-based clicks; TRUE to use agent-based clicks. The default is FALSE. This option applies to clicks on specific HTML options only. For additional information, see API Click Versus Agent Click.

This option can be set through the Compatibility tab on the Agent Options dialog box, Agent.SetOption, or BindAgentOption(), and may be retrieved through Agent.GetOption().

OPT_ALTERNATE_RECORD_BREAK

Classic Agent

Open Agent

BOOLEAN

TRUE pauses recording when Ctrl+Shift is pressed. Otherwise, Ctrl+Alt is used. By default, this is FALSE.

OPT_APPREADY_RETRY

Classic Agent

Open Agent

NUMBER

The number of seconds that the agent waits between attempts to verify that an application is ready. The agent continues trying to test the application for readiness if it is not ready until the time specified with OPT_APPREADY_TIMEOUT is reached.

OPT_APPREADY_TIMEOUT

Classic Agent

Open Agent

NUMBER

The number of seconds that the agent waits for an application to become ready. If the application is not ready within the specified timeout, Silk Test Classic raises an exception.

To require the agent to check the ready state of an application, set OPT_VERIFY_APPREADY.

This option applies only if the application or extension knows how to communicate to the agent that it is ready. To find out whether the extension has this capability, see the documentation that comes with the extension.

OPT_BITMAP_MATCH_COUNT

Classic Agent

Open Agent

INTEGER

The number of consecutive snapshots that must be the same for the bitmap to be considered stable. Snapshots are taken up to the number of seconds specified by OPT_BITMAP_MATCH_TIMEOUT, with a pause specified by OPT_BITMAP_MATCH_INTERVAL occurring between each snapshot.

Related methods:
  • CaptureBitmap
  • GetBitmapCRC
  • SYS_CompareBitmap
  • VerifyBitmap
  • WaitBitmap
OPT_BITMAP_MATCH_INTERVAL

Classic Agent

Open Agent

INTEGER

The time interval between snapshots to use for ensuring the stability of the bitmap image. The snapshots are taken up to the time specified by OPT_BITMAP_MATCH_TIMEOUT.

Related methods:
  • CaptureBitmap
  • GetBitmapCRC
  • SYS_CompareBitmap
  • VerifyBitmap
  • WaitBitmap
OPT_BITMAP_MATCH_TIMEOUT

Classic Agent

Open Agent

NUMBER

The total time allowed for a bitmap image to become stable.

During the time period, Silk Test Classic takes multiple snapshots of the image, waiting the number of seconds specified with OPT_BITMAP_MATCH_TIMEOUT between snapshots. If the value returned by OPT_BITMAP_MATCH_TIMEOUT is reached before the number of bitmaps specified by OPT_BITMAP_MATCH_COUNT match, Silk Test Classic stops taking snapshots and raises the exception E_BITMAP_NOT_STABLE.

Related methods:
  • CaptureBitmap
  • GetBitmapCRC
  • VerifyBitmap
  • WaitBitmap
OPT_BITMAP_PIXEL_TOLERANCE

Classic Agent

Open Agent

INTEGER

The number of pixels of difference below which two bitmaps are considered to match. If the number of pixels that are different is smaller than the number specified with this option, the bitmaps are considered identical. The maximum tolerance is 32767 pixels.

Related methods:
  • SYS_CompareBitmap
  • VerifyBitmap
  • WaitBitmap
OPT_CLASS_MAP

Classic Agent

Open Agent

LIST OF STRING

The class mapping table for custom objects, with each entry in the list in the form custom_class = standard_class.

OPT_CLOSE_CONFIRM_BUTTONS

Classic Agent

Open Agent

LIST OF STRING

The list of buttons used to close confirmation dialog boxes, which are dialog boxes that display when closing windows with the methods Close, CloseWindows, and Exit.

OPT_CLOSE_DIALOG_KEYS

Classic Agent

Open Agent

LIST OF STRING

The keystroke sequence used to close dialog boxes with the methods Close, CloseWindows, and Exit.

OPT_CLOSE_MENU_NAME

Classic Agent

STRING

A list of strings representing the list of menu items on the system menu used to close windows with the methods Close, CloseWindows, and Exit.

Default is Close.

OPT_CLOSE_WINDOW_BUTTONS

Classic Agent

Open Agent

LIST OF STRING

The list of buttons used to close windows with the methods Close, CloseWindows, and Exit.

OPT_CLOSE_WINDOW_MENUS

Classic Agent

Open Agent

LIST OF STRING

The list of menu items used to close windows with the methods Close, CloseWindows, and Exit.

OPT_CLOSE_WINDOW_TIMEOUT

Classic Agent

Open Agent

NUMBER

The number of seconds that Silk Test Classic waits before it tries a different close strategy for the Close method when the respective window does not close. Close strategies include Alt+F4 or sending the keys specified by OPT_CLOSE_DIALOG_KEYS. By default, this is 2.

OPT_COMPATIBLE_TAGS

Classic Agent

BOOLEAN

TRUE to generate and operate on tags compatible with releases earlier than Release 2; FALSE to use the current algorithm.

The current algorithm affects tags that use index numbers and some tags that use captions. In general, the current tags are more portable, while the earlier algorithm generates more platform-dependent tags.

OPT_COMPATIBILITY

Open Agent

STRING

Enables you to use the behavior of the specified Silk Test Classic version for specific features, when the behavior of these features has changed in a later version.

Example strings:
  • 12
  • 11.1
  • 13.0.1

By default, this option is not set.

OPT_COMPRESS_WHITESPACE

Classic Agent

BOOLEAN

TRUE to replace all multiple consecutive white spaces with a single space for comparison of tags. FALSE (the default) to avoid replacing blank characters in this manner.

This is intended to provide a way to match tags where the only difference is the number of white spaces between words.

If at all possible, use "wildcard " instead of this option.

This option can increase test time because of the increased time it takes for compressing of white spaces in both source and target tags. If Silk Test Classic processes an object that has many children, this option may result in increased testing times.

The tag comparison is performed in two parts. The first part is a simple comparison; if there is a match, no further action is required. The second part is to compress consecutive white spaces and retest for a match.

Due to the possible increase in test time, the most efficient way to use this option is to enable and disable the option as required on sections of the testing that is affected by white space. Do not enable this option to cover your entire test.

Tabs in menu items are processed before the actual tags are compared. Do not modify the window declarations of frame files by adding tabs to any of the tags.

OPT_DROPDOWN_PICK_BEFORE_GET

Classic Agent

BOOLEAN

TRUE to drop down the combo box before trying to access the content of the combo box. This is usually not needed, but some combo boxes only get populated after they are dropped down. If you are having problems getting the contents of a combo box, set this option to TRUE.

Default is FALSE.

OPT_ENABLE_ACCESSIBILITY

Classic Agent

Open Agent

BOOLEAN

TRUE to enable Accessibility when you are testing a Win32 application and Silk Test Classic cannot recognize objects. Accessibility is designed to enhance object recognition at the class level. FALSE to disable Accessibility.

Note: For Mozilla Firefox and Google Chrome, Accessibility is always activated and cannot be deactivated.

Default is FALSE.

OPT_ENABLE_MOBILE_WEBVIEW_FALLBACK_SUPPORT

Open Agent

BOOLEAN

Enables mobile native fallback support for hybrid mobile applications that are not testable with the default browser support.

By default, this is FALSE.

OPT_ENABLE_UI_AUTOMATION_SUPPORT

Open Agent

TRUE to enable Microsoft UI Automation support instead of the normal Win32 control recognition. This option might be useful when you are testing a Win32 application and Silk Test Classic cannot recognize objects. AUTODETECT to automatically enable Microsoft UI Automation support for JavaFX.

By default, this is FALSE.

OPT_ENSURE_ACTIVE_WINDOW

Open Agent

BOOLEAN

TRUE ensures that the main window of the call is active before a call is executed. By default, this is FALSE.

OPT_EXTENSIONS

Classic Agent

LIST OF STRING

The list of loaded extensions. Each extension is identified by the name of the .dll or .vxx file associated with the extension.

Unlike the other options, OPT_EXTENSIONS is read-only and works only with GetOption().

OPT_GET_MULTITEXT_KEEP_EMPTY_LINES

Classic Agent

BOOLEAN

TRUE returns an empty list if no text is selected. FALSE removes any blank lines within the selected text.

By default, this is TRUE.

OPT_HANG_APP_TIME_OUT

Open Agent

NUMBER

Specifies the Unresponsive application timeout, which is the timeout for pending playback actions.

The default value is 5 seconds.

OPT_ITEM_RECORD

Open Agent

BOOLEAN

For SWT applications, TRUE records methods that invoke tab items directly rather than recording the tab folder hierarchy. For example, you might record SWTControls.SWTTabControl1.TabFolder.Select(). If this option is set to FALSE, SWT tab folder actions are recorded. For example, you might record SWTControls.SWTTabControl1.Select("TabFolder").

By default, this is TRUE.

OPT_KEYBOARD_DELAY

Classic Agent

Open Agent

NUMBER

Default is 0.02 seconds; you can select a number in increments of .001 from .001 to up to 1000 seconds.

Be aware that the optimal number can vary, depending on the application that you are testing. For example, if you are testing a Web application, a setting of .001 radically slows down the browser. However, setting this to 0 (zero) may cause basic application testing to fail.

OPT_KEYBOARD_LAYOUT

Classic Agent

STRING

Provides support for international keyboard layouts in the Windows environment. Specify an operating-system specific name for the keyboard layout. Refer to the Microsoft Windows documentation to determine what string your operating system expects. Alternatively, use the GetOption method to help you determine the current keyboard layout, as in the following example: Print (Agent.GetOption (OPT_KEYBOARD_LAYOUT))

OPT_KILL_HANGING_APPS

Classic Agent

Open Agent

BOOLEAN

Specifies whether to shutdown the application if communication between the Agent and the application fails or times out. Set this option to TRUE when testing applications that cannot run multiple instances. By default, this is FALSE.

OPT_LOCATOR_ATTRIBUTES_CASE_SENSITIVE

Open Agent

BOOLEAN

Set to Yes to add case-sensitivity to locator attribute names, or to No to match the locator names case insensitive.

OPT_MATCH_ITEM_CASE

Classic Agent

Open Agent

BOOLEAN

Set this option to TRUE to have Silk Test Classic consider case when matching items in combo boxes, list boxes, radio lists, and popup lists, or set this option to FALSE to ignore case differences during execution of a Select method. This option has no effect on a Verify function or a VerifyContents method.

OPT_MENU_INVOKE_POPUP

Classic Agent

STRING

The command, keystrokes or mouse buttons, used to display pop-up menus, which are menus that popup over a particular object. To use mouse buttons, specify <button1>, <button2>, or <button3> in the command sequence.

OPT_MENU_PICK_BEFORE_GET

Classic Agent

BOOLEAN

TRUE to pick the menu before checking whether an item on it exists, is enabled, or is checked, or FALSE to not pick the menu before checking. When TRUE, you may see menus pop up on the screen even though your script does not explicitly call the Pick method.

Default is FALSE.

OPT_MOUSE_DELAY

Classic Agent

Open Agent

NUMBER

The delay used before each mouse event in a script. The delay affects moving the mouse, pressing buttons, and releasing buttons. By default, this is 0.02.

OPT_MULTIPLE_TAGS

Classic Agent

Open Agent

BOOLEAN

TRUE to use multiple tags when recording and playing back. FALSE to use one tag only, as done in previous releases.

This option cannot be set through the Agent Options dialog box. Its default is TRUE and is only set by the INI file, option file, and through Agent.SetOption.

This option overrides the Record multiple tags check box that displays in both the Recorder Options dialog box and the Record Window Declaration Options dialog box.

If the Record multiple tags check box is grayed out and you want to change it, check this setting.

OPT_NO_ICONIC_MESSAGE_BOXES

Classic Agent

BOOLEAN

TRUE to not have minimized windows automatically recognized as message boxes.

Default is FALSE.

OPT_PAUSE_TRUELOG

Classic Agent

BOOLEAN

TRUE to disable TrueLog at runtime for a specific portion of a script, or FALSE to enable TrueLog.

This option has no effect if Truelog is not enabled.

Default is FALSE.

OPT_PLAY_MODE

Classic Agent

STRING

Used to specify playback mechanism. For additional information for Windows applications, see Playing Back Mouse Actions.
OPT_POST_REPLAY_DELAY

Classic Agent

Open Agent

NUMBER

The time in seconds to wait after invoking a function or writing properties. Increase this delay if you experience replay problems due to the application taking too long to process mouse and keyboard input. By default, this is 0.00.

OPT_RADIO_LIST

Classic Agent

BOOLEAN

TRUE to view option buttons as a group; FALSE to use the pre-Release 2 method of viewing option buttons as individual objects.

OPT_RECORD_LISTVIEW_SELECT_BY_TYPEKEYS

Open Agent

BOOLEAN

TRUE records methods with typekeys statements rather than with keyboard input for certain selected values. By default, this is FALSE.

OPT_RECORD_MOUSE_CLICK_RADIUS

Open Agent

INTEGER

The number of pixels that defines the radius in which a mouse down and mouse up event must occur in order for the Open Agent to recognize it as a click. If the mouse down and mouse up event radius is greater than the defined value, a PressMouse and ReleaseMouse event are scripted. By default, this is set to 5 pixels.

OPT_RECORD_MOUSEMOVES

Classic Agent

Open Agent

BOOLEAN

TRUE records mouse moves for Web pages, Win32 applications, and Windows Forms applications that use mouse move events. You cannot record mouse moves for child domains of the xBrowser technology domain, for example Apache Flex and Swing. By default, this is FALSE.

OPT_RECORD_SCROLLBAR_ABSOLUT

Open Agent

BOOLEAN

TRUE records scroll events with absolute values instead of relative to the previous scroll position. By default, this is FALSE.

OPT_REL1_CLASS_LIBRARY

Classic Agent

BOOLEAN

TRUE to use pre-Release 2 versions of GetChildren, GetClass, and GetParent, or FALSE to use current versions.

OPT_REMOVE_FOCUS_ON_CAPTURE_TEXT

Open Agent

BOOLEAN

TRUE to remove the focus from a window before text is captured. By default, this is FALSE.

OPT_REPLAY_HIGHLIGHT_TIME

Open Agent

NUMBER

The number of seconds before each invoke command that the object is highlighted.

By default, this is 0, which means that objects are not highlighted by default.

OPT_REPLAY_MODE

Classic Agent

Open Agent

NUMBER

The replay mode defines how replays on a control are executed: They can be executed with mouse and keyboard (low level) or using the API (high level). Each control defines which replay mode is the default mode for the control. When the default replay mode is enabled, most controls use a low level replay. The default mode for each control is the mode that works most reliably. If a replay fails, the user can change the replay mode and try again. Each control that supports that mode will execute the replay in the specified mode. If a control does not support the mode, it executes the default mode. For example, if PushButton supports low level replay but uses high level replay by default, it will use low level replay only if the option specifies it. Otherwise, it will use the high level implementation.

Possible values include 0, 1, and 2. 0 is default, 1 is high level, 2 is low level. By default, this is 0.

OPT_REQUIRE_ACTIVE

Classic Agent

BOOLEAN

Setting this option to FALSE allows 4Test statements to be attempted against inactive windows.

Default is TRUE, except when running script statements that were recorded and are in a recording statement.

OPT_RESIZE_APPLICATION_BEFORE_RECORDING

Open Agent

BOOLEAN

Define whether to resize the application under test (AUT) when a recording session starts, to display the Silk Recorder next to the AUT. If this option is disabled, the AUT and the Silk Recorder might overlap. This option is TRUE by default.

OPT_SCROLL_INTO_VIEW

Classic Agent

BOOLEAN

TRUE to scroll a control into view before recording events against it or capturing its bitmap. This option applies only when OPT_SHOW_OUT_OF_VIEW is set to TRUE. This option is useful for testing Web applications in which dialog boxes contain scroll bars. This option applies only to HTML objects when you are using the DOM extension.

OPT_SET_TARGET_MACHINE

Classic Agent

STRING

The IP address and port number to use for the target machine in distributed testing using the SetOption method. To set the target machine, type: Agent.SetOption(OPT_SET_TARGET_MACHINE, < IPAddress >:< PortNumber >) .

Note: A colon must separate the IP address and the port number.

To return the IP address and port number of the current target machine, type: Agent.GetOption(OPT_SET_TARGET_MACHINE)

OPT_SHOW_OUT_OF_VIEW

Classic Agent

BOOLEAN

TRUE to have the agent see a control not currently scrolled into view; FALSE to have the Agent consider an out-of-view window to be invisible. This option applies only to HTML objects when you are using the DOM extension.

OPT_SYNC_TIMEOUT

Open Agent

NUMBER

Specifies the maximum time in seconds for an object to be ready.

Note: When you upgrade from a Silk Test version prior to Silk Test 13.0, and you had set the OPT_XBROWSER_SYNC_TIMEOUT option, the Options dialog box will display the default value of the OPT_SYNC_TIMEOUT, although your timeout is still set to the value you have defined.
OPT_TEXT_NEW_LINE

Classic Agent

STRING

The keys to type to enter a new line using the SetMultiText method of the TextField class. The default value is "<Enter>".

OPT_TRANSLATE_TABLE

Classic Agent

STRING

Specifies the name of the translation table to use. If a translation DLL is in use, the QAP_SetTranslateTable entry point is called with the string specified in this option.

OPT_TRIM_ITEM_SPACE

Classic Agent

BOOLEAN

TRUE to trim leading and trailing spaces from items on windows, or FALSE to avoid trimming spaces.

OPT_USE_ANSICALL

Classic Agent

BOOLEAN

If set to TRUE, each following DLL function is called as ANSI. If set to FALSE, which is the default value, UTF-8 DLL calls are used. For single ANSI DLL calls you can also use the ansicall keyword.

OPT_USE_SILKBEAN

Classic Agent

BOOLEAN

TRUE to enable the agent to interact with the SilkBean running on a UNIX machine.

Default is FALSE.

OPT_VERIFY_ACTIVE

Classic Agent

Open Agent

BOOLEAN

TRUE to verify that windows are active before interacting with them; FALSE to not check. See Active and Enabled Statuses for information about how this option affects Silk Test Classic methods.

Default is TRUE, except when running script statements that were recorded and are in a recording statement.

OPT_VERIFY_APPREADY

Classic Agent

BOOLEAN

TRUE to synchronize the agent with the application under test. Calls to the agent will not proceed unless the application is ready.

OPT_VERIFY_CLOSED

Classic Agent

BOOLEAN

TRUE to verify that a window has closed. When FALSE, Silk Test Classic closes a window as usual, but does not verify that the window actually closed.

Default is TRUE, except when running script statements that were recorded and are in a recording statement.

OPT_VERIFY_COORD

Classic Agent

BOOLEAN

TRUE to check that coordinates passed to a method are inside the window before the mouse is pressed; FALSE to not check. Typically, you use the checking feature unless you need to be able to pass coordinates outside of the window, such as negative coordinates.

If this option is set to TRUE and coordinates fall outside the window, Silk Test Classic raises the exception E_COORD_OUTSIDE_WINDOW.

OPT_VERIFY_CTRLTYPE

Classic Agent

BOOLEAN

TRUE to check that objects are of the specified type before interacting with them; FALSE to not check.

When TRUE, Silk Test Classic checks, for example, that an object that claims to be a listbox is actually a listbox. For custom objects, you must map them to the standard types to prevent the checking from signaling an exception, using the Silk Test Classic class map facility.

Default is FALSE.

OPT_VERIFY_ENABLED

Classic Agent

BOOLEAN

TRUE to verify that windows are enabled before interacting with them; FALSE to not check. For information about how this option affects various Silk Test Classic methods, see Active and Enabled Statuses.

OPT_VERIFY_EXPOSED

Classic Agent

BOOLEAN

TRUE to verify that windows are exposed (that is, not covered, obscured, or logically hidden by another window) before interacting with them; FALSE to not check.

Default is TRUE, except when running script statements that were recorded and are in a recording statement.

OPT_VERIFY_RESPONDING

Classic Agent

BOOLEAN

Setting this option to FALSE suppresses "control not responding" errors.

OPT_VERIFY_UNIQUE

Classic Agent

Open Agent

BOOLEAN

TRUE to raise the E_WINDOW_NOT_UNIQUE exception upon encountering two or more windows with the same tag; FALSE to not raise the exception. When OPT_VERIFY_UNIQUE is FALSE, Silk Test Classic ignores the duplication and chooses the first window with that tag that it encounters.

You can use a modified tag syntax to refer to a window with a non-unique tag, even when OPT_VERIFY_UNIQUE is TRUE. You can either include an index number after the object, as in myDialog("Cancel[2]"), or you can specify the window by including the text of a child that uniquely identifies the window, such as "myDialog/uniqueText/...", where the unique text is the tag of a child of that window.

OPT_WAIT_ACTIVE_WINDOW

Open Agent

NUMBER

The number of seconds Silk Test Classic waits for a window to become active. If a window does not become active within the specified time, Silk Test Classic raises an exception.

To require the Open Agent to check the active state of a window, set OPT_ENSURE_ACTIVE_WINDOW to TRUE.

By default, OPT_WAIT_ACTIVE_WINDOW is set to 2 seconds.

OPT_WAIT_ACTIVE_WINDOW_RETRY

Open Agent

NUMBER

The number of seconds Silk Test Classic waits for a window to become active before trying to verify again that the window is active.

To require the Open Agent to retry the active state of an object, set OPT_ENSURE_ACTIVE_WINDOW to TRUE.

By default, OPT_WAIT_ACTIVE_WINDOW_RETRY is set to 0.5 seconds.

OPT_WINDOW_MOVE_TOLERANCE

Classic Agent

INTEGER

The number of pixels allowed for a tolerance when a moved window does not end up at the specified position.

For some windows and GUIs, you cannot always move the window to the specified pixel. If the ending position is not exactly what was specified and the difference between the expected and actual positions is greater than the tolerance, Silk Test Classic raises an exception.

On Windows, the tolerance can be set through the Control Panel, by setting the desktop window granularity option. If the granularity is zero, you can place a window at any pixel location. If the granularity is greater than zero, the desktop is split into a grid of the specified pixels in width, determining where a window can be placed. In general, the tolerance should be greater than or equal to the granularity.

OPT_WINDOW_RETRY

Classic Agent

Open Agent

NUMBER

The number of seconds Silk Test Classic waits between attempts to verify a window, if the window does not exist or is in the incorrect state. Silk Test Classic continues trying to find the window until the time specified with OPT_WINDOW_TIMEOUT is reached.

The correct state of the window depends on various options. For example, Silk Test Classic might check whether a window is enabled, active, exposed, or unique, depending on the settings of the following options:

  • OPT_VERIFY_ENABLED
  • OPT_VERIFY_ACTIVE
  • OPT_VERIFY_EXPOSED
  • OPT_VERIFY_UNIQUE
OPT_WINDOW_SIZE_TOLERANCE

Classic Agent

INTEGER

The number of pixels allowed for a tolerance when a resized window does not end at the specified size.

For some windows and GUIs, you cant always resize the window to the particular size specified. If the ending size is not exactly what was specified and the difference between the expected and actual sizes is greater than the tolerance, Silk Test Classic raises an exception.

On Windows, windows cannot be sized smaller than will fit comfortably with the menu bar.

OPT_WINDOW_TIMEOUT

Classic Agent

Open Agent

NUMBER

The number of seconds Silk Test Classic waits for a window to appear and be in the correct state. If a window does not appear within the specified timeout, Silk Test Classic raise an exception.

The correct state of the window depends on various options. For example, Silk Test Classic might check whether a window is enabled, active, exposed, or unique, depending on the settings of the following options:

  • OPT_VERIFY_ENABLED
  • OPT_VERIFY_ACTIVE
  • OPT_VERIFY_EXPOSED
  • OPT_VERIFY_UNIQUE
OPT_WPF_CHECK_DISPATCHER_FOR_IDLE

Open Agent

BOOLEAN

For some WPF applications the Silk Test synchronization might not work due to how certain controls are implemented, resulting in Silk Test Classic not recognising when the WPF application is idle. Setting this option to FALSE disables the WPF synchronization and prevents Silk Test Classic from checking the WPF dispatcher, which is the thread that controls the WPF application. Set this option to FALSE to solve synchronization issues with certain WPF applications. By default, this is TRUE.
OPT_WPF_CUSTOM_CLASSES

Open Agent

LIST OF STRING

Specify the names of any WPF classes that you want to expose during recording and playback. For example, if a custom class called MyGrid derives from the WPF Grid class, the objects of the MyGrid custom class are not available for recording and playback. Grid objects are not available for recording and playback because the Grid class is not relevant for functional testing since it exists only for layout purposes. As a result, Grid objects are not exposed by default. In order to use custom classes that are based on classes that are not relevant to functional testing, add the custom class, in this case MyGrid, to the OPT_WPF_CUSTOM_CLASSES option. Then you can record, playback, find, verify properties, and perform any other supported actions for the specified classes.

OPT_WPF_PREFILL_ITEMS

Open Agent

BOOLEAN

Defines whether items in a WPFItemsControl, like WPFComboBox or WPFListBox, are pre-filled during recording and playback. WPF itself lazily loads items for certain controls, so these items are not available for Silk Test Classic if they are not scrolled into view. Turn pre-filling on, which is the default setting, to additionally access items that are not accessible without scrolling them into view. However, some applications have problems when the items are pre-filled by Silk Test Classic in the background, and these applications can therefore crash. In this case turn pre-filling off.

OPT_XBROWSER_ENABLE_IFRAME_SUPPORT

Open Agent

BOOLEAN

Specifies whether to enable iframe and frame support for browsers. If you are not interested in the content of the iframes in a web application, disabling the iframe support might improve replay performance. For example, disabling the iframe support might significantly improve replay performance for web pages with many adds and when testing in a mobile browser. This option is ignored by Internet Explorer. This option is enabled by default.

OPT_XBROWSER_EXCLUDE_IFRAMES

Open Agent

Every entry in the list defines an attribute name and the corresponding value. All iframes and frames that do not match at least one of the entries are considered during testing. Wildcards are allowed, for example the entry "src:*advertising*" would exclude <IFRAME src=http://my.domain/advertising-banner.html>. This option is ignored by Internet Explorer. If the list is empty, all iframes and frames are considered during testing. Separate multiple entries with a comma.
OPT_XBROWSER_FIND_HIDDEN_INPUT_FIELDS

Open Agent

BOOLEAN

Specifies whether to display hidden input fields, which are HTML fields for which the tag includes type="hidden". The default value is TRUE.

OPT_XBROWSER_INCLUDE_IFRAMES

Open Agent

Every entry in the list defines an attribute name and the corresponding value. All iframes and frames that do not match at least one of the entries are excluded. Wildcards are allowed, for example the entry "name:*form" would include <IFRAME name="user-form" src=…>. This option is ignored by Internet Explorer. If the list is empty, all iframes and frames are considered during testing. Separate multiple entries with a comma.
OPT_XBROWSER_SYNC_MODE

Open Agent

STRING

Configures the supported synchronization mode for HTML or AJAX. Using the HTML mode ensures that all HTML documents are in an interactive state. With this mode, you can test simple Web pages. If more complex scenarios with Java script are used, it might be necessary to manually script synchronization functions, such as WaitForObject, WaitForProperty, WaitForDisappearance, or WaitForChildDisappearance. Using the AJAX mode eliminates the need to manually script synchronization functions. By default, this value is set to AJAX.

OPT_XBROWSER_SYNC_TIMEOUT

Open Agent

NUMBER

Specifies the maximum time in seconds for an object to be ready.

Note: Deprecated. Use the option OPT_SYNC_TIMEOUT instead.
OPT_XBROWSER_SYNC_EXCLUDE_URLS

Open Agent

STRING

Specifies the URLs of any services or web pages that you want to exclude during page synchronization. Some AJAX frameworks or browser applications use special HTTP requests, which are permanently open in order to retrieve asynchronous data from the server. These requests may let the synchronization hang until the specified synchronization timeout expires. To prevent this situation, either use the HTML synchronization mode or specify the URL of the problematic request in the Synchronization exclude list setting.

Type the entire URL or a fragment of the URL, such as http://test.com/timeService or timeService. Separate entries by comma. For example:
Agent.SetOption(OPT_XBROWSER_SYNC_EXCLUDE_URLS, { "fpdownload.macromedia.com", "fpdownload.adobe.com", "download.microsoft.com" })