Build 1.0_r1(from source)

android.app
Class KeyguardManager

java.lang.Object
  extended by android.app.KeyguardManager

public class KeyguardManager
extends Object

Class that can be used to lock and unlock the keyboard. Get an instance of this class by calling Context.getSystemService(java.lang.String) with argument Context.KEYGUARD_SERVICE. The Actual class to control the keyboard locking is KeyguardManager.KeyguardLock.


Nested Class Summary
 class KeyguardManager.KeyguardLock
          Handle returned by newKeyguardLock(java.lang.String) that allows you to disable / reenable the keyguard.
static interface KeyguardManager.OnKeyguardExitResult
          Callback passed to exitKeyguardSecurely(android.app.KeyguardManager.OnKeyguardExitResult) to notify caller of result.
 
Constructor Summary
KeyguardManager()
           
 
Method Summary
 void exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback)
          Exit the keyguard securely.
 boolean inKeyguardRestrictedInputMode()
          If keyguard screen is showing or in restricted key input mode (i.e.
 KeyguardManager.KeyguardLock newKeyguardLock(String tag)
          Enables you to lock or unlock the keyboard.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

KeyguardManager

KeyguardManager()
Method Detail

newKeyguardLock

public KeyguardManager.KeyguardLock newKeyguardLock(String tag)
Enables you to lock or unlock the keyboard. Get an instance of this class by calling Context.getSystemService(). This class is wrapped by KeyguardManager.

Parameters:
tag - A tag that informally identifies who you are (for debugging who is disabling he keyguard).
Returns:
A KeyguardManager.KeyguardLock handle to use to disable and reenable the keyguard.

inKeyguardRestrictedInputMode

public boolean inKeyguardRestrictedInputMode()
If keyguard screen is showing or in restricted key input mode (i.e. in keyguard password emergency screen). When in such mode, certain keys, such as the Home key and the right soft keys, don't work.

Returns:
true if in keyguard restricted input mode.
See Also:
WindowManagerPolicy.inKeyguardRestrictedKeyInputMode()

exitKeyguardSecurely

public void exitKeyguardSecurely(KeyguardManager.OnKeyguardExitResult callback)
Exit the keyguard securely. The use case for this api is that, after disabling the keyguard, your app, which was granted permission to disable the keyguard and show a limited amount of information deemed safe without the user getting past the keyguard, needs to navigate to something that is not safe to view without getting past the keyguard. This will, if the keyguard is secure, bring up the unlock screen of the keyguard.

Parameters:
callback - Let's you know whether the operation was succesful and it is safe to launch anything that would normally be considered safe once the user has gotten past the keyguard.

Build 1.0_r1(from source)

Please submit a feedback, bug or feature