The information below concerns legacy mobile tests that work with mobile devices connected to the local computer. For new mobile tests, we recommend using the newer cloud-compatible approach.

Description

Simulates touching the screen at the specified point for the specified period of time and then moving a fingertip to the specified point.

Declaration

ProgObj.Drag(StartX, StartY, EndX, EndY, Delay)

ProgObj	An expression, variable or parameter that specifies a reference to one of the objects listed in the Applies To section
StartX	[in]	Required	Integer
StartY	[in]	Required	Integer
EndX	[in]	Required	Integer
EndY	[in]	Required	Integer
Delay	[in]	Optional	Integer	Default value: 1000
Result	None

Applies To

The method is applied to the following objects:

AndroidDevice, iOSDevice

Parameters

The method has the following parameters:

StartX

Specifies the horizontal coordinate (in pixels) of the start point of the drag action.

StartY

Specifies the vertical coordinate (in pixels) of the start point of the drag action.

EndX

Specifies the horizontal coordinate (in pixels) of the end point of the drag action.

EndY

Specifies the vertical coordinate (in pixels) of the end point of the drag action.

Delay

Specifies the touch delay (in milliseconds).

Result Value

None.

Remarks

This method is asynchronous. This means that TestComplete continues running the test, no matter whether it has finished or not. For information on how it may affect testing on Android devices, see Possible Issues.

Example

The code below demonstrates how to use the Drag method to simulate dragging on a mobile device:

JavaScript, JScript

function Test()
{

  // Specify the current device
  Mobile.SetCurrent("MyDevice");

  // Launch the tested application
  …

  // Simulate user actions
  …
  Mobile.Device().Drag(5, 5, 55, 55);
  …

}

Python

def Test():

  # Specify the current device
  Mobile.SetCurrent("MyDevice")

  # Launch the tested application
  # ...

  # Simulate user actions
  # ...
  Mobile.Device().Drag(5, 5, 55, 55)
  # ...

VBScript

Sub Test

  ' Specify the current device
  Call Mobile.SetCurrent("MyDevice")

  ' Launch the tested application
  …

  ' Simulate user actions
  …
  Call Mobile.Device.Drag(5, 5, 55, 55)
  …

End Sub

DelphiScript

procedure Test();
begin

  // Specify the current device
  Mobile.SetCurrent('MyDevice');

  // Launch the tested application
  …

  // Simulate user actions
  …
  Mobile.Device.Drag(5, 5, 55, 55);
  …

end;