AndroidDesktop Object

Applies to TestComplete 14.72, last modified on December 24, 2020


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
Desktop Property (Android Testing)
iOSDesktop Object
Desktop Object

Highlight search results