TestComplete Tutorial 9 - Mouse Actions and Mouse Wheel Events

 TestComplete provides mouse actions and mouse wheel events.

Mouse Actions

To simulate clicks, double-clicks, dragging and hovering (hot-tracking) operations, each onscreen object provides the following methods:

  1. Click( ) - Simulates a single click performed with the left mouse button.
  2. ClickR( ) -  Simulates a single click performed with the right mouse button.
  3. ClickM( ) -  Simulates a single click performed with the middle mouse button.
  4. DblClick( ) -  Simulates a double click performed with the middle mouse button.
  5. DblClickR( ) -  Simulates a double click performed with the middle mouse button.
  6. DblClickM( ) -  Simulates a double click performed with the middle mouse button.
  7. Drag( ) -  Simulates a dragging operation performed with the left mouse button.
  8. DragR( ) -  Simulates a dragging operation performed with the right mouse button.
  9. DragM( ) -  Simulates a dragging operation performed with the middle mouse button.
  10. HoverMouse( ) - Simulates moving the mouse pointer to the specified position within an object.
Each of these actions have parameters that specify window-related coordinates of the event. 

You can also simulate mouse clicks by using the MouseDown and MouseUp methods of the Desktop object.

Examples - 

Example to Click on button - 

            btnStart =  "name mapping of btn";
            btnStart.Click( );

Example to DblClick on button - 
            
            btnStart.DblClick( );

Mouse Wheel Events

TestComplete records user actions over tested applications, including the mouse wheel rotation, as object operations.

For example, if you rotate the mouse wheel to scroll the contents displayed in a text editor, TestComplete will record the scrolling as modifying the VScroll.Pos property of the editor window. 

The VScroll property of the window object provides access to the vertical scroll bar and its Pos property specifies the scroll bar position.

If a tested object does not have a vertical scroll bar, TestComplete uses the MouseWheel action.

To simulate mouse wheel rotation from a script routine, call the OnScreenObject.MouseWheel method with proper parameters.

Example - 
                Sys.Process("Notepad").Window("Notepad", "*").Window("Edit", "").MouseWheel(-1);

Note: TestComplete does not record mouse wheel actions over web pages.

Comments

Post a Comment

Popular posts from this blog

TestComplete Tutorial 19 - Adding Objects to the Name Mapping Repository

Image
You can add objects to the Name Mapping repository in several ways: Automatically  when recording and editing tests. Manually  from the screen or from the Object Browser. From scripts . Mapping Objects Automatically By default, TestComplete adds objects to the  Name Mapping  repository  automatically  when you – Record tests, Create  checkpoints , Add or edit keyword test operations. This behavior is controlled by the  Engines > Name Mapping > Map object names automatically   option of TestComplete: If you do not use the Name Mapping repository in your project, you can disable this option to prevent TestComplete from mapping objects. To enable or disable automatic name mapping Select  Tools > Options  from the TestComplete main menu. This will open the  Options  dialog. Select the  Engines > Name Mapping  category. Select or clear the  Map object names automatically  check box. Click  O...
Read more

TestComplete Tutorial 14 - Object identification criteria in Name Mapping

  The object identification criteria that the repository stores and that TestComplete uses to search for objects in the applications can be: Property-value pairs -  For example: ObjectType = Page, URL=http://example.com Conditional expressions -  For example: WndCaption = Open OR Select File Selectors  -  (for web and mobile applications) For web applications, it can be XPath expressions and CSS selectors, for example,  //input[@id='instasearch']  or  #instasearch . For mobile applications, it can be the object class name, accessibility identifier, or an XPath expression, for example,  XCUIElementTypeStatusBar  or  //*[@name="Orders"] . Extended search -  Search for an object on all the levels down the object hierarchy rather than just on the current level. Required child objects -  Search for an object that has specific child objects.
Read more