Simulating User Actions on Application Windows

You can simulate user actions over application windows by using the appropriate methods of the window object. To call the methods, you can use the On-Screen Action or Call Object Method operations. For example:

1. Open your keyword test for editing.

2. Add the On-Screen Action operation to the test. After the operation is added, TestComplete will display the Operation Parameters wizard.

3. Drag the target glyph to the needed window or control or click to point to the needed window or control with the mouse.

   Note: To simulate user actions on a top-level window, drag the target glyph strictly to the caption of that window.

   The wizard will show the selected window or control. Click Next.

4. The second page of the wizard will display the list of available methods of the object. Choose the needed action from the list and click Next to continue.

5. On the third page of the Operation Parameters wizard, you can specify the method’s parameters (if any).

6. Click Finish to complete the operation creation and close the wizard.

7. If needed, repeat all described steps to add more actions on your window to your test.

For example, the image below shows a keyword test that simulates various actions on the Notepad window - restores it, minimizes it, and so on:

For more information on how to perform typical tasks in keyword tests, see Common Tasks for Keyword Test Operations.

You can also use the actions described above to perform various operations on application windows from your scripts.

The following example simulates various actions over the Notepad window - minimizes it, restores it, and so on:

w = Sys.Process("notepad").Window("Notepad", "*", 1)
w.Activate()
w.Minimize()
w.Restore()
w.Position(10, 10, 450, 250)
w.Maximize()
w.Restore()
w.SetFocus()

The following example minimizes and then restores the currently active window:

w = Sys.Desktop.ActiveWindow();
w.Minimize()
w.Restore()