AndroidDesktop Object

Applies to TestComplete 15.64, last modified on May 16, 2024
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.


The AndroidDesktop object provides information about the display of the connected Android device. To get the object in tests, use the Mobile.Device.Desktop property.

The object has the following properties and methods:

Property Description
Density Returns the density of the display (dots per inch). Integer.
Height Returns the height of the display in pixels. Integer.
Width Returns the width of the display in pixels. Integer.
Method Description
GetOrientation Returns the current orientation of the device's screen.
Picture Returns the specified rectangular area of the screen as an image.
ResetOrientation Resets the current orientation of the device's screen to a default value.
SetOrientation Sets the current orientation of the device's screen


The following code gets the AndroidDesktop object and posts the value of its properties to the Test Log:

JavaScript, JScript

function GetDeskInfo()
  var DeskObj = Mobile.Device("MyDevice").Desktop;
  Log.Message("Width: " + DeskObj.Width);
  Log.Message("Height: " + DeskObj.Height);
  Log.Message("Density:" + DeskObj.Density);


def GetDeskInfo():
   DeskObj = Mobile.Device("MyDevice").Desktop
   Log.Message("Width: " + VarToStr(DeskObj.Width))
   Log.Message("Height: " + VarToStr(DeskObj.Height))
   Log.Message("Density: " + VarToStr(DeskObj.Density))


Sub GetDeskInfo
  Set DeskObj = Mobile.Device("MyDevice").Desktop
  Log.Message("Width: " & VarToStr(DeskObj.Width))
  Log.Message("Height: " & VarToStr(DeskObj.Height))
  Log.Message("Density: " & VarToStr(DeskObj.Density))
End Sub


procedure GetDeskInfo();
var DeskObj;
   DeskObj := Mobile.Device('MyDevice').Desktop;
   Log.Message('Width: ' + VarToStr(DeskObj.Width));
   Log.Message('Height: ' + VarToStr(DeskObj.Height));
   Log.Message('Density: ' + VarToStr(DeskObj.Density));

C++Script, C#Script

function GetDeskInfo()
  var DeskObj = Mobile["Device"]("MyDevice")["Desktop"];
  Log["Message"]("Width: " + DeskObj["Width"]);
  Log["Message"]("Height: " + DeskObj["Height"]);
  Log["Message"]("Density:" + DeskObj["Density"]);

See Also

Testing Android Applications (Legacy)
Desktop Property (Android Testing)
iOSDesktop Object
Desktop Object

Highlight search results