This method is available in legacy mobile tests that work with devices connected to the local computer. To learn how to simulate user actions in newer cloud-compatible mobile tests, see the Simulating user actions in tests section. |
Description
The TouchItemXY
action simulates touching at the specific point within the item, specified by its index or name.
Declaration
TestObj.TouchItemXY(Group, Item, X, Y)
TestObj | A variable, parameter or expression that specifies a reference to one of the objects listed in the Applies To section | |||
Group | [in] | Required | Variant | |
Item | [in] | Required | Integer | |
X | [in] | Required | Integer | |
Y | [in] | Required | Integer | |
Result | None |
Applies To
The method is applied to the following object:
View Mode
To view this method in the Object Browser panel and in other panels and dialogs, activate the Advanced view mode.
Parameters
The method has the following parameters:
Group
Specifies the desired group. You can enter the group’s index (from 0) or its name.
The caption can contain asterisk (*) or question mark (?) wildcards or regular expressions. The asterisk corresponds to a string of any length (including an empty string), the question mark corresponds to any single character (including none). To specify more complicated parts of a caption, use regular expressions.
The caption can be case-sensitive or case-insensitive depending on the value of the Use case-sensitive parameters project setting.
Item
Specifies a zero-based item’s index.
X
Specifies the horizontal coordinate (in pixels) of the point where touching will be simulated. This coordinate is specified relatively to the top-left corner of the underlying control.
Y
Specifies the vertical coordinate (in pixels) of the point where touching will be simulated. This coordinate is specified relatively to the top-left corner of the underlying control.
Result Value
None.
Example
The following example simulates a touch over the first item in the "Group 1" of the expandable list.
JavaScript, JScript
function Test()
{
// Select an Android device
Mobile.SetCurrent("MyDevice");
// Obtain an application
var app = Mobile.Device().Process("com.example.myapp");
// Obtain an expandable list
expList = app.Layout("layoutListView").ExpandableListView("elv1");
// Simulating a touch at the specified point within the Item1
expList.TouchItemXY("Group 1", 0, 5, 5)
}
Python
def Test():
# Select an Android device
Mobile.SetCurrent("MyDevice")
# Obtain an application
app = Mobile.Device().Process("com.example.myapp")
# Obtain an expandable list
expList = app.Layout("layoutListView").ExpandableListView("elv1")
# Simulating a touch at the specified point within the Item1
expList.TouchItemXY("Group 1", 0, 5, 5)
VBScript
Sub Test
Dim app, actionbar
' Select an Android device
Mobile.SetCurrent("MyDevice")
' Obtain an application
Set app = Mobile.Device.Process("com.example.myapp")
' Obtain an expandable list
Set expList = app.Layout("layoutListView").ExpandableListView("elv1")
' Simulating a touch at the specified point within the Item1
Call expList.TouchItemXY("Group 1", 0, 5, 5)
End Sub
DelphiScript
function Test();
var
app, actionbar: OleVariant;
begin
// Select an Android device
Mobile.SetCurrent('MyDevice');
// Obtain an application
app := Mobile.Device.Process('com.example.myapp');
// Obtain an expandable list
expList := app.Layout('layoutListView').ExpandableListView('elv1');
// Simulating a touch at the specified point within the Item1
expList.TouchItemXY('Group 1', 0, 5, 5);
end;
C++Script, C#Script
function Test()
{
// Select an Android device
Mobile["SetCurrent"]("MyDevice");
// Obtain an application
var app = Mobile["Device"]["Process"]("com.example.myapp");
// Obtain an expandable list
var expList = app["Layout"]("layoutListView")["ExpandableListView"]("elv1");
// Simulating a touch at the specified point within the Item1
expList["TouchItemXY"]("Group 1", 0, 5, 5)
}
See Also
Testing Android Applications (Legacy)
Selecting Expandable List Groups and Items
Android ExpandableList Support
Touch Action (Mobile Objects)
TouchItem Method (Mobile Controls)
LongTouchItemXY Action (Android Controls)