Select an Object page of the Verification Point and Action Wizard

The Verification Point and Action Wizard is opened with the Insert Verification Point or Action Command button Insert Verification Point or Action Command on the Recording toolbar or the product toolbar. It is used to select objects or images to test in your application, and to select the types of tests to perform on them.

The Select an Object page is the first step. You use one of the selection methods on this page to select the object in your application you want to perform a test on. When the object is selected, its recognition properties are listed in the grid at the bottom of the page.

To perform an image verification test, use the Capture Screen Image tool to select the image or use the Object Finder tool to select the object and create an image verification point.

If you select the wrong object, or decide to test a different one, use any of the methods and select a different object. It will then be shown in the grid. Once you advance past this first page by clicking the Next button, the object that is listed in the grid is the one that you will be testing. After you select a test object, you'll select an action in the next page of the wizard. Once you have moved on, you can always click the Back button to select a different object.

The following three selection methods are available:

Object Finder Tool

Use this tool to select an object and all descendents of the object, select one object, or select an object and the immediate children of an object.

This is the most common and direct method of selecting an object. Grab the Object Finder tool icon with your mouse and the cursor turns into the tool. Drag it over the object in your application that you want to select. You'll see that the object is highlighted and the object name is displayed. When you release the mouse button, the object is selected, and its recognition properties are listed in the grid.

Note that you can also use the Insert Verification Point or Action Command button Insert Verification Point or Action Command on the Recording toolbar directly to select an object. If you click it and drag it off of the toolbar, it will become the object selector tool from this page of the wizard.

If the After selecting an object advance to next page option is selected, you'll go directly to the next page of the wizard after you select the object. Clear this option if you want to remain on this page to see the object recognition properties after selecting the object.

Object Browser

Use this method to browse for the object that you want to select. The browser displays a hierarchical tree of objects in your application. The top level shows any applications you have running. Under each top level,Test UI displays the object hierarchy within that application. It is a dynamic view of the currently available objects.

Using this method, you browse for your object. The browser displays a hierarchical tree of objects in your system that are testable. The top level shows any applications you have running, and under each one is the object hierarchy within that application. It is a dynamic view of the currently available objects. Browse the object tree till you find the object, then click it. That will select it, and its recognition properties will be listed in the grid.

Delay Method

Use this method to select pop-up objects, such as menus. This method uses the Object Finder tool, but enables you to set a delay, which gives you time to get to an object that requires clicking on other objects first.

This uses the Object Finder tool, but with a delay that you set. The delay gives you time to get to an object that requires clicking on other objects first, such as a menu command. Set the number of seconds (the default is 10), then click the tool icon. Move your mouse to hover over your application until you get to the object you want to select. Anything you do during that delay period is not recorded. This allows you to "dig" for objects if necessary. For example, you might click with your mouse to cause a menu to open. The timer counts down, and when it runs out the object under the cursor is selected, and its recognition properties will be listed in the grid.

Note: In order for the delayed location of objects to play back correctly, the object must be exposed by actions in the script. If the object is not exposed, an Object Not Found Exception is thrown during playback.

If the After selecting an object advance to next page option is selected, you'll go directly to the next page of the wizard after you select the object. Clear this option if you want to remain on this page to see the object recognition properties after selecting the object.

Object recognition properties grid

When the object is selected by any of the above methods, its recognition properties are listed in the grid at the bottom of the page. The recognition properties are determined by the object's proxy. For example, a "button" object has three recognition properties: label, .class, and .classIndex. This grid will list the name and value of your specific object's recognition properties. You can use that information to confirm that you selected the correct object. If no information is listed, the object is not testable or the environment may not be enabled.

Capture Screen Image

To perform image verification test, use the Capture Screen Image Capture Screen Image tool to capture the screen. This tool captures the full image of the screen.

Your next step

After you select an object using one of the methods listed above, click the Next button to choose an action to perform on the object. These include creating a data verification point, creating a properties verification point, creating an image verification point, getting a single property value, or setting a wait state on an object. For more information on the actions, see the Select an Action Page.