summaryrefslogtreecommitdiffstats
path: root/core/java/android/app/KeyguardManager.java
diff options
context:
space:
mode:
authorThe Android Open Source Project <initial-contribution@android.com>2009-03-03 18:28:45 -0800
committerThe Android Open Source Project <initial-contribution@android.com>2009-03-03 18:28:45 -0800
commitd83a98f4ce9cfa908f5c54bbd70f03eec07e7553 (patch)
tree4b825dc642cb6eb9a060e54bf8d69288fbee4904 /core/java/android/app/KeyguardManager.java
parent076357b8567458d4b6dfdcf839ef751634cd2bfb (diff)
downloadframeworks_base-d83a98f4ce9cfa908f5c54bbd70f03eec07e7553.zip
frameworks_base-d83a98f4ce9cfa908f5c54bbd70f03eec07e7553.tar.gz
frameworks_base-d83a98f4ce9cfa908f5c54bbd70f03eec07e7553.tar.bz2
auto import from //depot/cupcake/@135843
Diffstat (limited to 'core/java/android/app/KeyguardManager.java')
-rw-r--r--core/java/android/app/KeyguardManager.java155
1 files changed, 0 insertions, 155 deletions
diff --git a/core/java/android/app/KeyguardManager.java b/core/java/android/app/KeyguardManager.java
deleted file mode 100644
index 0c07553..0000000
--- a/core/java/android/app/KeyguardManager.java
+++ /dev/null
@@ -1,155 +0,0 @@
-/*
- * Copyright (C) 2007 The Android Open Source Project
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-package android.app;
-
-import android.content.Context;
-import android.os.Binder;
-import android.os.RemoteException;
-import android.os.IBinder;
-import android.os.ServiceManager;
-import android.view.IWindowManager;
-import android.view.IOnKeyguardExitResult;
-
-/**
- * Class that can be used to lock and unlock the keyboard. Get an instance of this
- * class by calling {@link android.content.Context#getSystemService(java.lang.String)}
- * with argument {@link android.content.Context#KEYGUARD_SERVICE}. The
- * Actual class to control the keyboard locking is
- * {@link android.app.KeyguardManager.KeyguardLock}.
- */
-public class KeyguardManager {
- private IWindowManager mWM;
-
- /**
- * Handle returned by {@link KeyguardManager#newKeyguardLock} that allows
- * you to disable / reenable the keyguard.
- */
- public class KeyguardLock {
- private IBinder mToken = new Binder();
- private String mTag;
-
- KeyguardLock(String tag) {
- mTag = tag;
- }
-
- /**
- * Disable the keyguard from showing. If the keyguard is currently
- * showing, hide it. The keyguard will be prevented from showing again
- * until {@link #reenableKeyguard()} is called.
- *
- * A good place to call this is from {@link android.app.Activity#onResume()}
- *
- * @see #reenableKeyguard()
- */
- public void disableKeyguard() {
- try {
- mWM.disableKeyguard(mToken, mTag);
- } catch (RemoteException ex) {
- }
- }
-
- /**
- * Reenable the keyguard. The keyguard will reappear if the previous
- * call to {@link #disableKeyguard()} caused it it to be hidden.
- *
- * A good place to call this is from {@link android.app.Activity#onPause()}
- *
- * @see #disableKeyguard()
- */
- public void reenableKeyguard() {
- try {
- mWM.reenableKeyguard(mToken);
- } catch (RemoteException ex) {
- }
- }
- }
-
- /**
- * Callback passed to {@link KeyguardManager#exitKeyguardSecurely} to notify
- * caller of result.
- */
- public interface OnKeyguardExitResult {
-
- /**
- * @param success True if the user was able to authenticate, false if
- * not.
- */
- void onKeyguardExitResult(boolean success);
- }
-
-
- KeyguardManager() {
- mWM = IWindowManager.Stub.asInterface(ServiceManager.getService(Context.WINDOW_SERVICE));
- }
-
- /**
- * Enables you to lock or unlock the keyboard. Get an instance of this class by
- * calling {@link android.content.Context#getSystemService(java.lang.String) Context.getSystemService()}.
- * This class is wrapped by {@link android.app.KeyguardManager KeyguardManager}.
- * @param tag A tag that informally identifies who you are (for debugging who
- * is disabling he keyguard).
- *
- * @return A {@link KeyguardLock} handle to use to disable and reenable the
- * keyguard.
- */
- public KeyguardLock newKeyguardLock(String tag) {
- return new KeyguardLock(tag);
- }
-
- /**
- * 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.
- *
- * @return true if in keyguard restricted input mode.
- *
- * @see android.view.WindowManagerPolicy#inKeyguardRestrictedKeyInputMode
- */
- public boolean inKeyguardRestrictedInputMode() {
- try {
- return mWM.inKeyguardRestrictedInputMode();
- } catch (RemoteException ex) {
- return false;
- }
- }
-
- /**
- * 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.
- *
- * @param 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.
- */
- public void exitKeyguardSecurely(final OnKeyguardExitResult callback) {
- try {
- mWM.exitKeyguardSecurely(new IOnKeyguardExitResult.Stub() {
- public void onKeyguardExitResult(boolean success) throws RemoteException {
- callback.onKeyguardExitResult(success);
- }
- });
- } catch (RemoteException e) {
-
- }
- }
-}