diff options
author | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 18:28:45 -0800 |
---|---|---|
committer | The Android Open Source Project <initial-contribution@android.com> | 2009-03-03 18:28:45 -0800 |
commit | d83a98f4ce9cfa908f5c54bbd70f03eec07e7553 (patch) | |
tree | 4b825dc642cb6eb9a060e54bf8d69288fbee4904 /core/java/android/app/KeyguardManager.java | |
parent | 076357b8567458d4b6dfdcf839ef751634cd2bfb (diff) | |
download | frameworks_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.java | 155 |
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) { - - } - } -} |