Display Manager

EMDK For Xamarin - 2.5

Overview

The DisplayMgr provides control of certain display screen features on the device.

Main Functionality

  • Set the display screen timeout interval
  • Enable/disable screen shot usage

Set Screen Timeout Interval

Used to set the length of time the device will wait during periods of inactivity (without screen touches or key presses) before turning off the screen to conserve power. Ideally, this interval should represent a balance between battery preservation and user convenience.

Note: Android supports only the display-screen timeout settings shown in the table below. Specifying a value between any two supported values will change the setting to the closest supported value. Specifying a value outside the minimum or maximum shown will cause an error in the Result XML document and the setting change will be ignored.

Parm Name: TimeoutInterval

Option Name Description Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no change to the current display screen timeout interval; any previously selected setting will be retained.

MX: 4.3+

Android API Level: 1+

15 15 seconds after Display Timeout Causes the display screen to timeout after 15 seconds of device-user inaction.

MX: 4.3+

Android API Level: 1+

30 30 seconds after Display Timeout Causes the display screen to timeout after 30 seconds of device-user inaction.

MX: 4.3+

Android API Level: 1+

60 1 minute after Display Timeout Causes the display screen to timeout after one minute of device-user inaction.

MX: 4.3+

Android API Level: 1+

120 2 minutes after Display Timeout Causes the display screen to timeout after two minutes of device-user inaction.

MX: 4.3+

Android API Level: 1+

300 5 minutes after Display Timeout Causes the display screen to timeout after five minutes of device-user inaction.

MX: 4.3+

Android API Level: 1+

600 10 minutes after Display Timeout Causes the display screen to timeout after 10 minutes of device-user inaction.

MX: 4.3+

Android API Level: 1+

1800 30 minutes after Display Timeout Causes the display screen to timeout after 30 minutes of device-user inaction.

MX: 4.3+

Android API Level: 1+

Screen Shot Usage

Controls whether a device can use Android's built-in screen capture capability, which captures the contents of the screen and saves it to a file on the device.

Note: The method for capturing the screen generally involves a combination of simultaneous key presses, and varies from one device to another.

Parm Name: ScreenShotUsage

Option Name Description Requires
0 Do Nothing This value (or the absence of this parm from the XML) will cause no change to the current behavior; any previously selected setting will be retained.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+

1 Enable Enables the ability to use the Android screen capture feature.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+

2 Disable Disables the ability to use the Android screen capture feature.

OSX: 3.6,4.5 ONLY

NOT IN OSX: 4.0 - 4.4

MX: 5.0+