WindowManagerPolicy.java revision 69cb87576ba163b61bb0e6477a3b7c57a9b11d40
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.view; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Configuration; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Rect; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.LocalPowerManager; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.animation.Animation; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 26f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackbornimport java.io.FileDescriptor; 27f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackbornimport java.io.PrintWriter; 28f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This interface supplies all UI-specific behavior of the window manager. An 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance of it is created by the window manager when it starts up, and allows 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * customization of window layering, special window types, key dispatching, and 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout. 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Because this provides deep interaction with the system window manager, 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specific methods on this interface can be called from a variety of contexts 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with various restrictions on what they can do. These are encoded through 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a suffixes at the end of a method encoding the thread the method is called 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from and any locks that are held when it is being called; if no suffix 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is attached to a method, then it is not called with any locks and may be 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called from the main window manager thread or another thread calling into 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The current suffixes are: 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dl> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Ti <dd> Called from the input thread. This is the thread that 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * collects pending input events and dispatches them to the appropriate window. 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It may block waiting for events to be processed, so that the input stream is 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * properly serialized. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Tq <dd> Called from the low-level input queue thread. This is the 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thread that reads events out of the raw input devices and places them 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the global input queue that is read by the <var>Ti</var> thread. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This thread should not block for a long period of time on anything but the 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * key driver. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Lw <dd> Called with the main window manager lock held. Because the 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager is a very low-level system service, there are few other 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system services you can call with this lock held. It is explicitly okay to 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make calls into the package manager and power manager; it is explicitly not 60c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project * okay to make calls into the activity manager or most other services. Note that 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#checkPermission(String, int, int)} and 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * variations require calling into the activity manager. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Li <dd> Called with the input thread lock held. This lock can be 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * acquired by the window manager while it holds the window lock, so this is 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even more restrictive than <var>Lw</var>. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </dl> 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface WindowManagerPolicy { 71b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown // Policy flags. These flags are also defined in frameworks/base/include/ui/Input.h. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WAKE = 0x00000001; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WAKE_DROPPED = 0x00000002; 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_SHIFT = 0x00000004; 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_CAPS_LOCK = 0x00000008; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_ALT = 0x00000010; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_ALT_GR = 0x00000020; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_MENU = 0x00000040; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_LAUNCHER = 0x00000080; 800eaf3931a31c29f3a3883aab426b595c231c2a58Jeff Brown public final static int FLAG_VIRTUAL = 0x00000100; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8285a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown public final static int FLAG_INJECTED = 0x01000000; 83e20c9e0264190f94324197a8271cf03811a4ca58Jeff Brown public final static int FLAG_TRUSTED = 0x02000000; 8485a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WOKE_HERE = 0x10000000; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_BRIGHT_HERE = 0x20000000; 87b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown public final static int FLAG_PASS_TO_USER = 0x40000000; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static boolean WATCH_POINTER = false; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 91ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn /** 92ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * Sticky broadcast of the current HDMI plugged state. 93ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn */ 94ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn public final static String ACTION_HDMI_PLUGGED = "android.intent.action.HDMI_PLUGGED"; 95ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn 96ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn /** 97ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * Extra in {@link #ACTION_HDMI_PLUGGED} indicating the state: true if 98ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * plugged in to HDMI, false if not. 99ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn */ 100ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn public final static String EXTRA_HDMI_PLUGGED_STATE = "state"; 101ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // flags for interceptKeyTq 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Pass this event to the user / app. To be returned from {@link #interceptKeyTq}. 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_PASS_TO_USER = 0x00000001; 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This key event should extend the user activity timeout and turn the lights on. 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * To be returned from {@link #interceptKeyTq}. Do not return this and 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ACTION_GO_TO_SLEEP} or {@link #ACTION_PASS_TO_USER}. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_POKE_USER_ACTIVITY = 0x00000002; 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This key event should put the device to sleep (and engage keyguard if necessary) 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * To be returned from {@link #interceptKeyTq}. Do not return this and 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ACTION_POKE_USER_ACTIVITY} or {@link #ACTION_PASS_TO_USER}. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_GO_TO_SLEEP = 0x00000004; 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface to the Window Manager state associated with a particular 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window. You can hold on to an instance of this interface from the call 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to prepareAddWindow() until removeWindow(). 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface WindowState { 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform standard frame computation. The result can be obtained with 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getFrame() if so desired. Must be called with the window manager 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parentFrame The frame of the parent container this window 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is in, used for computing its basic position. 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayFrame The frame of the overall display in which this 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window can appear, used for constraining the overall dimensions 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the window. 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param contentFrame The frame within the display in which we would 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * like active content to appear. This will cause windows behind to 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be resized to match the given content frame. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param visibleFrame The frame within the display that the window 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is actually visible, used for computing its visible insets to be 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given to windows behind. 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This can be used as a hint for scrolling (avoiding resizing) 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window to make certain that parts of its content 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are visible. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void computeFrameLw(Rect parentFrame, Rect displayFrame, 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect contentFrame, Rect visibleFrame); 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that has been assigned by 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. Must be called with the window manager lock held. 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the window frame. 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getFrameLw(); 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that is actually shown. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Must be called with the window manager lock held. 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the shown window frame. 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getShownFrameLw(); 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the display that this window was last 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. Must be called with the 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the display frame. 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getDisplayFrameLw(); 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the content area that this window was last 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area in which the content of the window 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should be placed. It will be smaller than the display frame to 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * account for screen decorations such as a status bar or soft 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyboard. Must be called with the 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the content frame. 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getContentFrameLw(); 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the visible area that this window was last 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area of the screen in which the window 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will actually be fully visible. It will be smaller than the 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content frame to account for transient UI elements blocking it 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as an input method's candidates UI. Must be called with the 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the visible frame. 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getVisibleFrameLw(); 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window is waiting to receive its given 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internal insets from the client app, and so should not impact the 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout of other windows. 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getGivenInsetsPendingLw(); 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the content 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual contents. 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenContentInsetsLw(); 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the visible 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual visible area. 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenVisibleInsetsLw(); 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current LayoutParams of the window. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return WindowManager.LayoutParams The window's internal LayoutParams 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WindowManager.LayoutParams getAttrs(); 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the layer at which this window's surface will be Z-ordered. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSurfaceLayer(); 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the token for the application (actually activity) that owns 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window. May return null for system windows. 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return An IApplicationToken identifying the owning activity. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public IApplicationToken getAppToken(); 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if, at any point, the application token associated with 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window has actually displayed any windows. This is most useful 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with the "starting up" window to determine if any windows were 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed when it is closed. 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if one or more windows have been displayed, 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else false. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasAppShownWindows(); 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window visible? It is not visible if there is no 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * surface, or we are in the process of running an exit animation 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that will remove the surface. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isVisibleLw(); 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2673d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * Like {@link #isVisibleLw}, but also counts a window that is currently 2683d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * "hidden" behind the keyguard as visible. This allows us to apply 2693d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * things like window flags that impact the keyguard. 2703d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn */ 2713d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn boolean isVisibleOrBehindKeyguardLw(); 2723d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn 2733d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn /** 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window currently visible to the user on-screen? It is 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed either if it is visible or it is currently running an 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animation before no longer being visible. Must be called with the 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isDisplayedLw(); 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window has been shown on screen at some time in 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the past. Must be called with the window manager lock held. 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return boolean 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasDrawnLw(); 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called by the policy to force a window to be hidden, 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * regardless of whether the client or window manager would like 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it shown. Must be called with the window manager lock held. 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #showLw} was last called for the window. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hideLw(boolean doAnimation); 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called to undo the effect of {@link #hideLw}, allowing a 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window to be shown as long as the window manager and client would 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * also like it to be shown. Must be called with the window manager 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #hideLw} was last called for the window. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean showLw(boolean doAnimation); 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3073b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 3083b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Bit mask that is set for all enter transition. 3093b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 3103b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ENTER_MASK = 0x1000; 3113b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 3123b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 3133b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Bit mask that is set for all exit transitions. 3143b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 3153b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_EXIT_MASK = 0x2000; 3163b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 317bfe319e06aa56c081d0d94d64a8181291d7f7388Dianne Hackborn /** Not set up for a transition. */ 3183b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_UNSET = -1; 319bfe319e06aa56c081d0d94d64a8181291d7f7388Dianne Hackborn /** No animation for transition. */ 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int TRANSIT_NONE = 0; 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been added to the screen. */ 3223b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ENTER = 1 | TRANSIT_ENTER_MASK; 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been removed from the screen. */ 3243b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_EXIT = 2 | TRANSIT_EXIT_MASK; 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been made visible. */ 3263b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_SHOW = 3 | TRANSIT_ENTER_MASK; 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been made invisible. */ 3283b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_HIDE = 4 | TRANSIT_EXIT_MASK; 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The "application starting" preview window is no longer needed, and will 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animate away to show the real window. */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int TRANSIT_PREVIEW_DONE = 5; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in a new activity is being opened on top of an existing one 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the same task. */ 3343b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ACTIVITY_OPEN = 6 | TRANSIT_ENTER_MASK; 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The window in the top-most activity is being closed to reveal the 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous activity in the same task. */ 3373b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ACTIVITY_CLOSE = 7 | TRANSIT_EXIT_MASK; 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in a new task is being opened on top of an existing one 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in another activity's task. */ 3403b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_OPEN = 8 | TRANSIT_ENTER_MASK; 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in the top-most activity is being closed to reveal the 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous activity in a different task. */ 3433b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_CLOSE = 9 | TRANSIT_EXIT_MASK; 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in an existing task is being displayed on top of an existing one 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in another activity's task. */ 3463b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_TO_FRONT = 10 | TRANSIT_ENTER_MASK; 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in an existing task is being put below all other tasks. */ 3483b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_TO_BACK = 11 | TRANSIT_EXIT_MASK; 34925994b4306a256b88d79159106834c9f114e6943Dianne Hackborn /** A window in a new activity that doesn't have a wallpaper is being 35025994b4306a256b88d79159106834c9f114e6943Dianne Hackborn * opened on top of one that does, effectively closing the wallpaper. */ 3513b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_CLOSE = 12 | TRANSIT_EXIT_MASK; 35225994b4306a256b88d79159106834c9f114e6943Dianne Hackborn /** A window in a new activity that does have a wallpaper is being 35325994b4306a256b88d79159106834c9f114e6943Dianne Hackborn * opened on one that didn't, effectively opening the wallpaper. */ 3543b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_OPEN = 13 | TRANSIT_ENTER_MASK; 355f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn /** A window in a new activity is being opened on top of an existing one, 356f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn * and both are on top of the wallpaper. */ 3573b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_INTRA_OPEN = 14 | TRANSIT_ENTER_MASK; 358f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn /** The window in the top-most activity is being closed to reveal the 359f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn * previous activity, and both are on top of he wallpaper. */ 3603b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_INTRA_CLOSE = 15 | TRANSIT_EXIT_MASK; 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 362254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // NOTE: screen off reasons are in order of significance, with more 363254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // important ones lower than less important ones. 364254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn 365254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn /** Screen turned off because of a device admin */ 366254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_ADMIN = 1; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of power button */ 368254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_USER = 2; 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of timeout */ 370254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_TIMEOUT = 3; 371435eb6464c1f326caf8179438a5401f358f0d7acMike Lockwood /** Screen turned off because of proximity sensor */ 372254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_PROX_SENSOR = 4; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Magic constant to {@link IWindowManager#setRotation} to not actually 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * modify the rotation. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int USE_LAST_ROTATION = -1000; 379b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler 380b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation should be 381b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * determined by the system (that is, using sensors). */ 382b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_FREE = 0; 383b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation is set by 384b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * the user. */ 385b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_LOCKED = 1; 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform initialization of the policy. 3899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The system context we are running in. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param powerManager 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void init(Context context, IWindowManager windowManager, 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalPowerManager powerManager); 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 39729735689cea7bf52998c1911542dcfdd1c1d9628Dianne Hackborn * Called by window manager once it has the initial, default native 39829735689cea7bf52998c1911542dcfdd1c1d9628Dianne Hackborn * display dimensions. 39929735689cea7bf52998c1911542dcfdd1c1d9628Dianne Hackborn */ 40029735689cea7bf52998c1911542dcfdd1c1d9628Dianne Hackborn public void setInitialDisplaySize(int width, int height); 40168066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn 40229735689cea7bf52998c1911542dcfdd1c1d9628Dianne Hackborn /** 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check permissions when adding a window. 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window's LayoutParams. 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link WindowManagerImpl#ADD_OKAY} if the add can proceed; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else an error code, usually 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link WindowManagerImpl#ADD_PERMISSION_DENIED}, to abort the add. 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int checkAddPermission(WindowManager.LayoutParams attrs); 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sanitize the layout parameters coming from a client. Allows the policy 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to do things like ensure that windows of a specific type can't take 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * input focus. 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window layout parameters to be modified. These values 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are modified in-place. 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustWindowParamsLw(WindowManager.LayoutParams attrs); 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the window manager has computed the current configuration based 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on its knowledge of the display and input devices, it gives the policy 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a chance to adjust the information contained in it. If you want to 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * leave it as-is, simply do nothing. 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method may be called by any thread in the window manager, but 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no internal locks in the window manager will be held. 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The Configuration being computed, for you to change as 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * desired. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustConfigurationLw(Configuration config); 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Assign a window type to a layer. Allows you to control how different 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kinds of windows are ordered on-screen. 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The type of window being assigned. 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int An arbitrary integer used to order windows, with lower 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * numbers below higher ones. 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int windowTypeToLayerLw(int type); 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return how to Z-order sub-windows in relation to the window they are 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached to. Return positive to have them ordered in front, negative for 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * behind. 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The sub-window type code. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int Layer in relation to the attached window, where positive is 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above and negative is below. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int subWindowTypeToLayerLw(int type); 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4616136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * Get the highest layer (actually one more than) that the wallpaper is 4626136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * allowed to be in. 4636136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn */ 4646136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn public int getMaxWallpaperLayer(); 4656136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn 4666136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn /** 46769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display width available after excluding any screen 46869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 46969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 470e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 47169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn public int getNonDecorDisplayWidth(int rotation, int fullWidth); 472e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 473e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 47469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display height available after excluding any screen 47569cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 47669cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 477e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 47869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn public int getNonDecorDisplayHeight(int rotation, int fullHeight); 47969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 48069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 48169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen width that we should report for the 48269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 48369cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * {@link #getNonDecorDisplayWidth(int, int)}; it may be smaller than 48469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 48569cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 48669cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn public int getConfigDisplayWidth(int rotation, int fullWidth); 48769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 48869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 48969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen height that we should report for the 49069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 49169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * {@link #getNonDecorDisplayHeight(int, int)}; it may be smaller than 49269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 49369cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 49469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn public int getConfigDisplayHeight(int rotation, int fullHeight); 495e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 496e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 4973b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Return whether the given window should forcibly hide everything 4983b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * behind it. Typically returns true for the keyguard. 4993b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 5003b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public boolean doesForceHide(WindowState win, WindowManager.LayoutParams attrs); 5013b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 5023b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 5033b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Determine if a window that is behind one that is force hiding 5043b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * (as determined by {@link #doesForceHide}) should actually be hidden. 5053b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * For example, typically returns false for the status bar. Be careful 5063b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * to return false for any window that you may hide yourself, since this 5073b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * will conflict with what you set. 5083b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 5093b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public boolean canBeForceHidden(WindowState win, WindowManager.LayoutParams attrs); 5103b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 5113b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system would like to show a UI to indicate that an 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application is starting. You can use this to add a 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APPLICATION_STARTING_TYPE window with the given appToken to the window 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manager (using the normal window manager APIs) that will be shown until 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the application displays its own window. This is called without the 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked so that you can call back into it. 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application being started. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param packageName The name of the application package being started. 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param theme Resource defining the application's overall visual theme. 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param nonLocalizedLabel The default title label of the application if 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no data is found in the resource. 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param labelRes The resource ID the application would like to use as its name. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param icon The resource ID the application would like to use as its icon. 5267eec10e6c99c30d5ee061fec08ac89ad4254ac32Dianne Hackborn * @param windowFlags Window layout flags. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Optionally you can return the View that was used to create the 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window, for easy removal in removeStartingWindow. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #removeStartingWindow 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public View addStartingWindow(IBinder appToken, String packageName, 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int theme, CharSequence nonLocalizedLabel, 5357eec10e6c99c30d5ee061fec08ac89ad4254ac32Dianne Hackborn int labelRes, int icon, int windowFlags); 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the first window of an application has been displayed, while 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #addStartingWindow} has created a temporary initial window for 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that application. You should at this point remove the window from the 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager. This is called without the window manager locked so 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that you can call back into it. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note: due to the nature of these functions not being called with the 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked, you must be prepared for this function to be 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called multiple times and/or an initial time with a null View window 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even if you previously returned one. 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application that has started. 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param window Window View that was returned by createStartingWindow. 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #addStartingWindow 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeStartingWindow(IBinder appToken, View window); 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prepare for a window being added to the window manager. You can throw an 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exception here to prevent the window being added, or do whatever setup 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you need to keep track of the window. 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being added. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window's LayoutParams. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link WindowManagerImpl#ADD_OKAY} if the add can proceed, else an 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code to abort the add. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int prepareAddWindowLw(WindowState win, 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs); 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a window is being removed from a window manager. Must not 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * throw an exception -- clean up as much as possible. 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being removed. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeWindowLw(WindowState win); 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Control the animation to run when a window's state changes. Return a 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * non-0 number to force the animation to a specific resource ID, or 0 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to use the default animation. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that is changing. 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param transit What is happening to the window: {@link #TRANSIT_ENTER}, 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_EXIT}, {@link #TRANSIT_SHOW}, or 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_HIDE}. 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resource ID of the actual animation to use, or 0 for none. 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int selectAnimationLw(WindowState win, int transit); 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5933b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Create and return an animation to re-display a force hidden window. 5943b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 5953b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public Animation createForceHideEnterAnimation(); 5963b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 5973b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 59800fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input reader thread before a key is enqueued. 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>There are some actions that need to be handled here because they 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affect the power state of the device, for example, the power keys. 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Generally, it's best to keep as little as possible in the queue thread 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because it's the most fragile. 6041f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 60500fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 60600fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param isScreenOn True if the screen is already on 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The bitwise or of the {@link #ACTION_PASS_TO_USER}, 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ACTION_POKE_USER_ACTIVITY} and {@link #ACTION_GO_TO_SLEEP} flags. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6111f2451007c660091b7b090c1ea332f9044515d2dJeff Brown public int interceptKeyBeforeQueueing(KeyEvent event, int policyFlags, boolean isScreenOn); 61256194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 61356194ebec6212e229f4ccdaa4b187166d20013efJeff Brown /** 61456194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * Called from the input reader thread before a motion is enqueued when the screen is off. 61556194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 61656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * <p>There are some actions that need to be handled here because they 61756194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * affect the power state of the device, for example, waking on motions. 61856194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * Generally, it's best to keep as little as possible in the queue thread 61956194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * because it's the most fragile. 62056194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * @param policyFlags The policy flags associated with the motion. 62156194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 62256194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * @return The bitwise or of the {@link #ACTION_PASS_TO_USER}, 62356194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * {@link #ACTION_POKE_USER_ACTIVITY} and {@link #ACTION_GO_TO_SLEEP} flags. 62456194ebec6212e229f4ccdaa4b187166d20013efJeff Brown */ 62556194ebec6212e229f4ccdaa4b187166d20013efJeff Brown public int interceptMotionBeforeQueueingWhenScreenOff(int policyFlags); 62656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 62800fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input dispatcher thread before a key is dispatched to a window. 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Allows you to define 6313915bb845b032dc184dba5e60970b803390ca3edJeff Brown * behavior for keys that can not be overridden by applications. 6323915bb845b032dc184dba5e60970b803390ca3edJeff Brown * This method is called from the input thread, with no locks held. 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that currently has focus. This is where the key 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * event will normally go. 6361f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 63700fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if the policy consumed the event and it should 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * not be further dispatched. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6411f2451007c660091b7b090c1ea332f9044515d2dJeff Brown public boolean interceptKeyBeforeDispatching(WindowState win, KeyEvent event, int policyFlags); 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6443915bb845b032dc184dba5e60970b803390ca3edJeff Brown * Called from the input dispatcher thread when an application did not handle 6453915bb845b032dc184dba5e60970b803390ca3edJeff Brown * a key that was dispatched to it. 6463915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 6473915bb845b032dc184dba5e60970b803390ca3edJeff Brown * <p>Allows you to define default global behavior for keys that were not handled 6483915bb845b032dc184dba5e60970b803390ca3edJeff Brown * by applications. This method is called from the input thread, with no locks held. 6493915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 6503915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param win The window that currently has focus. This is where the key 6513915bb845b032dc184dba5e60970b803390ca3edJeff Brown * event will normally go. 6521f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 6533915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param policyFlags The policy flags associated with the key. 65449ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * @return Returns an alternate key event to redispatch as a fallback, or null to give up. 65549ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * The caller is responsible for recycling the key event. 6563915bb845b032dc184dba5e60970b803390ca3edJeff Brown */ 65749ed71db425c5054e3ad9526496a7e116c89556bJeff Brown public KeyEvent dispatchUnhandledKey(WindowState win, KeyEvent event, int policyFlags); 6583915bb845b032dc184dba5e60970b803390ca3edJeff Brown 6593915bb845b032dc184dba5e60970b803390ca3edJeff Brown /** 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is about to start. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void beginLayoutLw(int displayWidth, int displayHeight); 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called for each window attached to the window manager as layout is 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proceeding. The implementation of this function must take care of 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the window's frame, either here or in finishLayout(). 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attached For sub-windows, the window it is attached to; this 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window will already have had layoutWindow() called on it 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so you can use its Rect. Otherwise null. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void layoutWindowLw(WindowState win, 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs, WindowState attached); 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the insets for the areas covered by system windows. These values 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are computed on the most recent layout, so they are not guaranteed to 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be correct. 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param contentInset The areas covered by system windows, expressed as positive insets 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getContentInsetHintLw(WindowManager.LayoutParams attrs, Rect contentInset); 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is finished. After this function has 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned, all windows given to layoutWindow() <em>must</em> have had a 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * frame assigned. 6977ac3f67c179ec77caeee59b86d87d4ec007c4586Dianne Hackborn * 698b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * @return Return any bit set of {@link #FINISH_LAYOUT_REDO_LAYOUT}, 699b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * {@link #FINISH_LAYOUT_REDO_CONFIG}, {@link #FINISH_LAYOUT_REDO_WALLPAPER}, 700b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * or {@link #FINISH_LAYOUT_REDO_ANIM}. 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7029bfb707597898f54722460b48588007b682f3e2aDianne Hackborn public int finishLayoutLw(); 7039bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 7049bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Layout state may have changed (so another layout will be performed) */ 7059bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_LAYOUT = 0x0001; 7069bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Configuration state may have changed */ 7079bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_CONFIG = 0x0002; 7089bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Wallpaper may need to move */ 7099bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_WALLPAPER = 0x0004; 710b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn /** Need to recompute animations */ 711b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn static final int FINISH_LAYOUT_REDO_ANIM = 0x0008; 7129bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when animation of the windows is about to start. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void beginAnimationLw(int displayWidth, int displayHeight); 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called each time a window is animating. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void animatingWindowLw(WindowState win, 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs); 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when animation of the windows is finished. If in this function you do 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * something that may have modified the animation state of another window, 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sure to return true in order to perform another animation frame. 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 735b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * @return Return any bit set of {@link #FINISH_LAYOUT_REDO_LAYOUT}, 736b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * {@link #FINISH_LAYOUT_REDO_CONFIG}, {@link #FINISH_LAYOUT_REDO_WALLPAPER}, 737b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * or {@link #FINISH_LAYOUT_REDO_ANIM}. 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn public int finishAnimationLw(); 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 742de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * Return true if it is okay to perform animations for an app transition 743de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * that is about to occur. You may return false for this if, for example, 744de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * the lock screen is currently displayed so the switch should happen 745de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * immediately. 746de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn */ 747de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn public boolean allowAppAnimationsLw(); 748664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 749664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 750664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato /** 751664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato * A new window has been focused. 752664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato */ 753664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato public void focusChanged(WindowState lastFocus, WindowState newFocus); 754de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn 755de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after the screen turns off. 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param why {@link #OFF_BECAUSE_OF_USER} or 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #OFF_BECAUSE_OF_TIMEOUT}. 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void screenTurnedOff(int why); 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after the screen turns on. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void screenTurnedOn(); 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 769de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * Return whether the screen is currently on. 770de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn */ 771de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn public boolean isScreenOn(); 77200fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown 773de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 77400fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Tell the policy that the lid switch has changed state. 77500fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param whenNanos The time when the change occurred in uptime nanoseconds. 77600fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param lidOpen True if the lid is now open. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 77846b9ac0ae2162309774a7478cd9d4e578747bfc2Jeff Brown public void notifyLidSwitchChanged(long whenNanos, boolean lidOpen); 77946b9ac0ae2162309774a7478cd9d4e578747bfc2Jeff Brown 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting that keyguard not come on. 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled Whether keyguard can be on or not. does not actually 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * turn it on, unless it was previously disabled with this function. 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#disableKeyguard() 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#reenableKeyguard() 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableKeyguard(boolean enabled); 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback used by {@link WindowManagerPolicy#exitKeyguardSecurely} 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project interface OnKeyguardExitResult { 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onKeyguardExitResult(boolean success); 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting the keyguard to exit securely 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (this would be called after the keyguard was disabled) 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callback Callback to send the result back. 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager#exitKeyguardSecurely(android.app.KeyguardManager.OnKeyguardExitResult) 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void exitKeyguardSecurely(OnKeyguardExitResult callback); 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 807520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardLocked 808520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 809520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard is currently locked. 810520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 811520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is locked. 812520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 813520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardLocked(); 814520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 815520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 816520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardSecure 817520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 818520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard requires a password to unlock. 819520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 820520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is secure. 821520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 822520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardSecure(); 823520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 824520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inKeyguardRestrictedKeyInputMode 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if keyguard screen is showing or in restricted key input mode (i.e. in 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard password emergency screen). When in such mode, certain keys, 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as the Home key and the right soft keys, don't work. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if in keyguard restricted input mode. 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inKeyguardRestrictedKeyInputMode(); 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Given an orientation constant 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ({@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ActivityInfo.SCREEN_ORIENTATION_LANDSCAPE} or 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_PORTRAIT 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * ActivityInfo.SCREEN_ORIENTATION_PORTRAIT}), return a surface 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * rotation. 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 843c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public int rotationForOrientationLw(int orientation, int lastRotation, 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean displayEnabled); 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 84768066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn * Return the currently locked screen rotation, if any. Return 84868066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn * Surface.ROTATION_0, Surface.ROTATION_90, Surface.ROTATION_180, or 84968066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn * Surface.ROTATION_270 if locked; return -1 if not locked. 85068066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn */ 85168066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn public int getLockedRotationLw(); 85268066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn 85368066c2f38e47b56f0510c56eafd827731a0dc08Dianne Hackborn /** 8546af0d50a8edb101d9da1306b6d85abf5dd3f9a30Dianne Hackborn * Called when the system is mostly done booting to determine whether 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system should go into safe mode. 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean detectSafeMode(); 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system is mostly done booting. 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void systemReady(); 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 865ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * Called when userActivity is signalled in the power manager. 866ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * This is safe to call from any thread, with any window manager locks held or not. 867ef73162887943e16587b8e737b19e59348338e8cMike Lockwood */ 868ef73162887943e16587b8e737b19e59348338e8cMike Lockwood public void userActivity(); 869ef73162887943e16587b8e737b19e59348338e8cMike Lockwood 870ef73162887943e16587b8e737b19e59348338e8cMike Lockwood /** 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when we have finished booting and can now display the home 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen to the user. This wilWl happen after systemReady(), and at 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this point the display is active. 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableScreenAfterBoot(); 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 877c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public void setCurrentOrientationLw(int newOrientation); 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call from application to perform haptic feedback on its window. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 882c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public boolean performHapticFeedbackLw(WindowState win, int effectId, boolean always); 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when we have stopped keeping the screen on because a window 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * requesting this is no longer visible. 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 888c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public void screenOnStoppedLw(); 8893d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood 8903d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood /** 8913d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood * Return false to disable key repeat events from being generated. 8923d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood */ 8933d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood public boolean allowKeyRepeat(); 894b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler 895b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** 896b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * Inform the policy that the user has chosen a preferred orientation ("rotation lock"). 897b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * 898b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param mode One of {@link WindowManagerPolicy#USER_ROTATION_LOCKED} or 899b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * {@link * WindowManagerPolicy#USER_ROTATION_FREE}. 900b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param rotation One of {@link Surface#ROTATION_0}, {@link Surface#ROTATION_90}, 901b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * {@link Surface#ROTATION_180}, {@link Surface#ROTATION_270}. 902b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler */ 903b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public void setUserRotationMode(int mode, int rotation); 904f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 905f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn /** 906f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * Print the WindowManagerPolicy's state into the given stream. 907f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * 908f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param prefix Text to print at the front of each line. 909f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param fd The raw file descriptor that the dump is being sent to. 910f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param writer The PrintWriter to which you should dump your state. This will be 911f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * closed for you after you return. 912f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param args additional arguments to the dump request. 913f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn */ 914f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args); 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 916