iOSDesktop Object

Applies to TestComplete 15.64, last modified on June 12, 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 iOSDesktop object provides information on the display of the connected iOS device. To get the object in tests, use the Mobile.Device.Desktop property.

The iOSDesktop object has the following properties and methods:

Property Description
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.
SetOrientation Sets the current orientation of the device's screen.


The following code gets the iOSDesktop object and posts the value of its properties to the test log:

JavaScript, JScript

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


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


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


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

C++Script, C#Script

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

See Also

Testing iOS Applications (Legacy)
Desktop Property
AndroidDesktop Object
Desktop Object

Highlight search results