Simulating Basic User Actions in Image-Based Tests

• Click and double-click actions - To simulate a single or double click with the left, middle or right mouse button, call the appropriate method:

  Click ClickM ClickR

  DblClick DblClickM DblClickR

  To simulate a click at a certain point of the control or area or a click with a key modifier, call the needed method with the appropriate parameters.

• Hover mouse action - To simulate moving a mouse pointer to the specified position within the control or screen area, call the Hover method.

• Drag action - To simulate a drag action performed with the left, right or middle mouse button, call the appropriate method:

  • Drag

  • DragM

  • DragR

• Touch action - To simulate a touch action over a control, call the Touch method. If you want to simulate a touch action at a certain point of the control, call the Touch method with the parameters specifying the target point’s coordinates.

• Long press actions - To simulate a long press action, call the LongTouch method. To simulate the actions at the specified point, call the method with the parameters specifying the point’s coordinates.

• Drag action - To simulate a drag action, that is, to drag one object from one point to another, call the LongTouch actions with the parameters that specify the starting point’s coordinates and the ending point’s coordinates.

To simulate basic actions over a control or screen area in an image-based test, use the Image Based Action operation:

1. Add the operation to your test:

   

   Click the image to enlarge it.

2. Select the image that TestComplete will use to search for a control over which you want to simulate the needed action:

   

3. Select the method you want to use to simulate the user action:

   

4. Specify the method parameters if needed:

   

To simulate basic touch actions over a control or screen area in a mobile application:

• Use the Image Touch operation:

  

  Click the image to enlarge it.

– or –

• Use the Image Based Action operation. To simulate a touch action, select the Touch method from the list of available methods.

  

  Click the image to enlarge it.

You can add the operations to your test from the operations palette or from the Test Visualizer panel (see Creating Test Commands From Visualizer Frames). To add operations to your tests from the Test Visualizer panel, the images from which you add the operations must be captured with the Capture tested objects properties option enabled.

To simulate a long touch and drag actions, call the LongTouch method with the desired parameters by using the Image Based Action, Call Object Method, Run Code Snippet and Run Script Routine operations.