WindowManagerPolicy.java revision 73ab6a49db2b834ce1d56c7a1164938b409ee6fc
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; 202f0b17573d4324832f7a20402a3d2b5920bc4866Dianne Hackbornimport android.content.res.CompatibilityInfo; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Configuration; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Rect; 23d040edbae968d826aa2c82d382345811a45c646bDianne Hackbornimport android.graphics.RectF; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.LocalPowerManager; 26df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackbornimport android.os.Looper; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.animation.Animation; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 29f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackbornimport java.io.FileDescriptor; 30f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackbornimport java.io.PrintWriter; 31f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This interface supplies all UI-specific behavior of the window manager. An 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance of it is created by the window manager when it starts up, and allows 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * customization of window layering, special window types, key dispatching, and 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout. 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Because this provides deep interaction with the system window manager, 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specific methods on this interface can be called from a variety of contexts 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with various restrictions on what they can do. These are encoded through 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a suffixes at the end of a method encoding the thread the method is called 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from and any locks that are held when it is being called; if no suffix 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is attached to a method, then it is not called with any locks and may be 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called from the main window manager thread or another thread calling into 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The current suffixes are: 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dl> 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Ti <dd> Called from the input thread. This is the thread that 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * collects pending input events and dispatches them to the appropriate window. 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It may block waiting for events to be processed, so that the input stream is 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * properly serialized. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Tq <dd> Called from the low-level input queue thread. This is the 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thread that reads events out of the raw input devices and places them 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the global input queue that is read by the <var>Ti</var> thread. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This thread should not block for a long period of time on anything but the 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * key driver. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Lw <dd> Called with the main window manager lock held. Because the 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager is a very low-level system service, there are few other 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system services you can call with this lock held. It is explicitly okay to 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make calls into the package manager and power manager; it is explicitly not 63c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project * okay to make calls into the activity manager or most other services. Note that 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#checkPermission(String, int, int)} and 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * variations require calling into the activity manager. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Li <dd> Called with the input thread lock held. This lock can be 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * acquired by the window manager while it holds the window lock, so this is 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even more restrictive than <var>Lw</var>. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </dl> 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface WindowManagerPolicy { 74b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown // Policy flags. These flags are also defined in frameworks/base/include/ui/Input.h. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WAKE = 0x00000001; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WAKE_DROPPED = 0x00000002; 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_SHIFT = 0x00000004; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_CAPS_LOCK = 0x00000008; 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_ALT = 0x00000010; 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_ALT_GR = 0x00000020; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_MENU = 0x00000040; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_LAUNCHER = 0x00000080; 830eaf3931a31c29f3a3883aab426b595c231c2a58Jeff Brown public final static int FLAG_VIRTUAL = 0x00000100; 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8585a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown public final static int FLAG_INJECTED = 0x01000000; 86e20c9e0264190f94324197a8271cf03811a4ca58Jeff Brown public final static int FLAG_TRUSTED = 0x02000000; 870029c66203ab9ded4342976bf7a17bb63af8c44aJeff Brown public final static int FLAG_FILTERED = 0x04000000; 880029c66203ab9ded4342976bf7a17bb63af8c44aJeff Brown public final static int FLAG_DISABLE_KEY_REPEAT = 0x08000000; 8985a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WOKE_HERE = 0x10000000; 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_BRIGHT_HERE = 0x20000000; 92b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown public final static int FLAG_PASS_TO_USER = 0x40000000; 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static boolean WATCH_POINTER = false; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 96ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn /** 97ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * Sticky broadcast of the current HDMI plugged state. 98ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn */ 99ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn public final static String ACTION_HDMI_PLUGGED = "android.intent.action.HDMI_PLUGGED"; 100ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn 101ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn /** 102ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * Extra in {@link #ACTION_HDMI_PLUGGED} indicating the state: true if 103ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn * plugged in to HDMI, false if not. 104ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn */ 105ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn public final static String EXTRA_HDMI_PLUGGED_STATE = "state"; 106ad7fa7fa77318d416ed338ede6aae582c239f822Dianne Hackborn 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 108d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * Pass this event to the user / app. To be returned from 109d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * {@link #interceptKeyBeforeQueueing}. 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_PASS_TO_USER = 0x00000001; 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This key event should extend the user activity timeout and turn the lights on. 115d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * To be returned from {@link #interceptKeyBeforeQueueing}. 116d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * Do not return this and {@link #ACTION_GO_TO_SLEEP} or {@link #ACTION_PASS_TO_USER}. 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_POKE_USER_ACTIVITY = 0x00000002; 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This key event should put the device to sleep (and engage keyguard if necessary) 122d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * To be returned from {@link #interceptKeyBeforeQueueing}. 123d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * Do not return this and {@link #ACTION_POKE_USER_ACTIVITY} or {@link #ACTION_PASS_TO_USER}. 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int ACTION_GO_TO_SLEEP = 0x00000004; 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Interface to the Window Manager state associated with a particular 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window. You can hold on to an instance of this interface from the call 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to prepareAddWindow() until removeWindow(). 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface WindowState { 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform standard frame computation. The result can be obtained with 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getFrame() if so desired. Must be called with the window manager 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parentFrame The frame of the parent container this window 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is in, used for computing its basic position. 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayFrame The frame of the overall display in which this 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window can appear, used for constraining the overall dimensions 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the window. 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param contentFrame The frame within the display in which we would 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * like active content to appear. This will cause windows behind to 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be resized to match the given content frame. 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param visibleFrame The frame within the display that the window 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is actually visible, used for computing its visible insets to be 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given to windows behind. 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This can be used as a hint for scrolling (avoiding resizing) 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window to make certain that parts of its content 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are visible. 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void computeFrameLw(Rect parentFrame, Rect displayFrame, 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Rect contentFrame, Rect visibleFrame); 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that has been assigned by 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. Must be called with the window manager lock held. 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the window frame. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getFrameLw(); 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that is actually shown. 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Must be called with the window manager lock held. 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the shown window frame. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 170d040edbae968d826aa2c82d382345811a45c646bDianne Hackborn public RectF getShownFrameLw(); 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the display that this window was last 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. Must be called with the 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the display frame. 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getDisplayFrameLw(); 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the content area that this window was last 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area in which the content of the window 1849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should be placed. It will be smaller than the display frame to 1859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * account for screen decorations such as a status bar or soft 1869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyboard. Must be called with the 1879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the content frame. 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getContentFrameLw(); 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the visible area that this window was last 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area of the screen in which the window 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will actually be fully visible. It will be smaller than the 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content frame to account for transient UI elements blocking it 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as an input method's candidates UI. Must be called with the 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the visible frame. 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getVisibleFrameLw(); 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window is waiting to receive its given 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internal insets from the client app, and so should not impact the 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout of other windows. 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getGivenInsetsPendingLw(); 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the content 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual contents. 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenContentInsetsLw(); 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the visible 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual visible area. 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenVisibleInsetsLw(); 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current LayoutParams of the window. 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return WindowManager.LayoutParams The window's internal LayoutParams 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WindowManager.LayoutParams getAttrs(); 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 24173ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * Return whether this window needs the menu key shown. Must be called 24273ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * with window lock held, because it may need to traverse down through 24373ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * window list to determine the result. 24473ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * @param bottom The bottom-most window to consider when determining this. 24573ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn */ 24673ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn public boolean getNeedsMenuLw(WindowState bottom); 24773ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn 24873ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn /** 2499a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn * Retrieve the current system UI visibility flags associated with 2509a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn * this window. 2519a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn */ 2529a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn public int getSystemUiVisibility(); 2539a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn 2549a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn /** 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the layer at which this window's surface will be Z-ordered. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSurfaceLayer(); 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the token for the application (actually activity) that owns 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window. May return null for system windows. 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return An IApplicationToken identifying the owning activity. 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public IApplicationToken getAppToken(); 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if, at any point, the application token associated with 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window has actually displayed any windows. This is most useful 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with the "starting up" window to determine if any windows were 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed when it is closed. 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if one or more windows have been displayed, 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else false. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasAppShownWindows(); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window visible? It is not visible if there is no 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * surface, or we are in the process of running an exit animation 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that will remove the surface. 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isVisibleLw(); 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2863d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * Like {@link #isVisibleLw}, but also counts a window that is currently 2873d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * "hidden" behind the keyguard as visible. This allows us to apply 2883d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * things like window flags that impact the keyguard. 2893d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn */ 2903d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn boolean isVisibleOrBehindKeyguardLw(); 2913d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn 2923d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn /** 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window currently visible to the user on-screen? It is 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed either if it is visible or it is currently running an 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animation before no longer being visible. Must be called with the 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isDisplayedLw(); 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window has been shown on screen at some time in 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the past. Must be called with the window manager lock held. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return boolean 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasDrawnLw(); 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called by the policy to force a window to be hidden, 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * regardless of whether the client or window manager would like 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it shown. Must be called with the window manager lock held. 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #showLw} was last called for the window. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hideLw(boolean doAnimation); 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called to undo the effect of {@link #hideLw}, allowing a 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window to be shown as long as the window manager and client would 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * also like it to be shown. Must be called with the window manager 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #hideLw} was last called for the window. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean showLw(boolean doAnimation); 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3263b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 327df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Representation of a "fake window" that the policy has added to the 328df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * window manager to consume events. 329df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 330df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public interface FakeWindow { 331df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 332df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Remove the fake window from the window manager. 333df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 334df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn void dismiss(); 335df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn } 336df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 337df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 338df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Interface for calling back in to the window manager that is private 339df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * between it and the policy. 340df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 341df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public interface WindowManagerFuncs { 342df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 343df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Ask the window manager to re-evaluate the system UI flags. 344df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 345df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public void reevaluateStatusBarVisibility(); 346df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 347df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 348df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Add a fake window to the window manager. This window sits 349df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * at the top of the other windows and consumes events. 350df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 351df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public FakeWindow addFakeWindow(Looper looper, InputHandler inputHandler, 352df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn String name, int windowType, int layoutParamsFlags, boolean canReceiveKeys, 353df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn boolean hasFocus, boolean touchFullscreen); 354df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn } 355df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 356df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 3573b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Bit mask that is set for all enter transition. 3583b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 3593b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ENTER_MASK = 0x1000; 3603b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 3613b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 3623b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Bit mask that is set for all exit transitions. 3633b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 3643b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_EXIT_MASK = 0x2000; 3653b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 366bfe319e06aa56c081d0d94d64a8181291d7f7388Dianne Hackborn /** Not set up for a transition. */ 3673b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_UNSET = -1; 368bfe319e06aa56c081d0d94d64a8181291d7f7388Dianne Hackborn /** No animation for transition. */ 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int TRANSIT_NONE = 0; 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been added to the screen. */ 3713b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ENTER = 1 | TRANSIT_ENTER_MASK; 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been removed from the screen. */ 3733b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_EXIT = 2 | TRANSIT_EXIT_MASK; 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been made visible. */ 3753b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_SHOW = 3 | TRANSIT_ENTER_MASK; 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been made invisible. */ 3773b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_HIDE = 4 | TRANSIT_EXIT_MASK; 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The "application starting" preview window is no longer needed, and will 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animate away to show the real window. */ 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final int TRANSIT_PREVIEW_DONE = 5; 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in a new activity is being opened on top of an existing one 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the same task. */ 3833b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ACTIVITY_OPEN = 6 | TRANSIT_ENTER_MASK; 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The window in the top-most activity is being closed to reveal the 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous activity in the same task. */ 3863b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_ACTIVITY_CLOSE = 7 | TRANSIT_EXIT_MASK; 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in a new task is being opened on top of an existing one 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in another activity's task. */ 3893b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_OPEN = 8 | TRANSIT_ENTER_MASK; 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in the top-most activity is being closed to reveal the 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * previous activity in a different task. */ 3923b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_CLOSE = 9 | TRANSIT_EXIT_MASK; 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in an existing task is being displayed on top of an existing one 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in another activity's task. */ 3953b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_TO_FRONT = 10 | TRANSIT_ENTER_MASK; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** A window in an existing task is being put below all other tasks. */ 3973b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_TASK_TO_BACK = 11 | TRANSIT_EXIT_MASK; 39825994b4306a256b88d79159106834c9f114e6943Dianne Hackborn /** A window in a new activity that doesn't have a wallpaper is being 39925994b4306a256b88d79159106834c9f114e6943Dianne Hackborn * opened on top of one that does, effectively closing the wallpaper. */ 4003b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_CLOSE = 12 | TRANSIT_EXIT_MASK; 40125994b4306a256b88d79159106834c9f114e6943Dianne Hackborn /** A window in a new activity that does have a wallpaper is being 40225994b4306a256b88d79159106834c9f114e6943Dianne Hackborn * opened on one that didn't, effectively opening the wallpaper. */ 4033b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_OPEN = 13 | TRANSIT_ENTER_MASK; 404f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn /** A window in a new activity is being opened on top of an existing one, 405f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn * and both are on top of the wallpaper. */ 4063b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_INTRA_OPEN = 14 | TRANSIT_ENTER_MASK; 407f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn /** The window in the top-most activity is being closed to reveal the 408f8fbdb6b920562473dc47046924ac8ffed0b8dafDianne Hackborn * previous activity, and both are on top of he wallpaper. */ 4093b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public final int TRANSIT_WALLPAPER_INTRA_CLOSE = 15 | TRANSIT_EXIT_MASK; 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 411254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // NOTE: screen off reasons are in order of significance, with more 412254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // important ones lower than less important ones. 413254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn 414254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn /** Screen turned off because of a device admin */ 415254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_ADMIN = 1; 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of power button */ 417254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_USER = 2; 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of timeout */ 419254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_TIMEOUT = 3; 420435eb6464c1f326caf8179438a5401f358f0d7acMike Lockwood /** Screen turned off because of proximity sensor */ 421254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_PROX_SENSOR = 4; 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 423b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation should be 424b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * determined by the system (that is, using sensors). */ 425b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_FREE = 0; 426b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation is set by 427b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * the user. */ 428b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_LOCKED = 1; 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform initialization of the policy. 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The system context we are running in. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param powerManager 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void init(Context context, IWindowManager windowManager, 437df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn WindowManagerFuncs windowManagerFuncs, 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project LocalPowerManager powerManager); 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4419d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn * Called by window manager once it has the initial, default native 4429d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn * display dimensions. 4439d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn */ 4449d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn public void setInitialDisplaySize(int width, int height); 445dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn 4469d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn /** 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check permissions when adding a window. 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window's LayoutParams. 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link WindowManagerImpl#ADD_OKAY} if the add can proceed; 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else an error code, usually 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link WindowManagerImpl#ADD_PERMISSION_DENIED}, to abort the add. 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int checkAddPermission(WindowManager.LayoutParams attrs); 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sanitize the layout parameters coming from a client. Allows the policy 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to do things like ensure that windows of a specific type can't take 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * input focus. 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window layout parameters to be modified. These values 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are modified in-place. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustWindowParamsLw(WindowManager.LayoutParams attrs); 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the window manager has computed the current configuration based 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on its knowledge of the display and input devices, it gives the policy 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a chance to adjust the information contained in it. If you want to 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * leave it as-is, simply do nothing. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method may be called by any thread in the window manager, but 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no internal locks in the window manager will be held. 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The Configuration being computed, for you to change as 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * desired. 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustConfigurationLw(Configuration config); 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Assign a window type to a layer. Allows you to control how different 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kinds of windows are ordered on-screen. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The type of window being assigned. 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int An arbitrary integer used to order windows, with lower 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * numbers below higher ones. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int windowTypeToLayerLw(int type); 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return how to Z-order sub-windows in relation to the window they are 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached to. Return positive to have them ordered in front, negative for 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * behind. 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The sub-window type code. 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int Layer in relation to the attached window, where positive is 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above and negative is below. 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int subWindowTypeToLayerLw(int type); 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5056136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * Get the highest layer (actually one more than) that the wallpaper is 5066136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * allowed to be in. 5076136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn */ 5086136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn public int getMaxWallpaperLayer(); 5096136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn 5106136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn /** 51181e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * Return true if the policy allows the status bar to hide. Otherwise, 51281e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn * it is a tablet-style system bar. 51381e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn */ 51481e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn public boolean canStatusBarHide(); 51581e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn 51681e56d535c853d73ff537357da5b935f51cb779dDianne Hackborn /** 51769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display width available after excluding any screen 51869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 51969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 520e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 5211f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getNonDecorDisplayWidth(int fullWidth, int fullHeight, int rotation); 522e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 523e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 52469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display height available after excluding any screen 52569cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 52669cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 527e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 5281f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getNonDecorDisplayHeight(int fullWidth, int fullHeight, int rotation); 52969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 53069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 53169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen width that we should report for the 53269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 53369cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * {@link #getNonDecorDisplayWidth(int, int)}; it may be smaller than 53469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 53569cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 5361f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getConfigDisplayWidth(int fullWidth, int fullHeight, int rotation); 53769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 53869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 53969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen height that we should report for the 54069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 54169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * {@link #getNonDecorDisplayHeight(int, int)}; it may be smaller than 54269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 54369cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 5441f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getConfigDisplayHeight(int fullWidth, int fullHeight, int rotation); 545e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 546e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 5473b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Return whether the given window should forcibly hide everything 5483b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * behind it. Typically returns true for the keyguard. 5493b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 5503b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public boolean doesForceHide(WindowState win, WindowManager.LayoutParams attrs); 5513b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 5523b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 5533b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Determine if a window that is behind one that is force hiding 5543b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * (as determined by {@link #doesForceHide}) should actually be hidden. 5553b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * For example, typically returns false for the status bar. Be careful 5563b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * to return false for any window that you may hide yourself, since this 5573b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * will conflict with what you set. 5583b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 5593b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public boolean canBeForceHidden(WindowState win, WindowManager.LayoutParams attrs); 5603b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 5613b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system would like to show a UI to indicate that an 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application is starting. You can use this to add a 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APPLICATION_STARTING_TYPE window with the given appToken to the window 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manager (using the normal window manager APIs) that will be shown until 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the application displays its own window. This is called without the 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked so that you can call back into it. 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application being started. 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param packageName The name of the application package being started. 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param theme Resource defining the application's overall visual theme. 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param nonLocalizedLabel The default title label of the application if 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no data is found in the resource. 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param labelRes The resource ID the application would like to use as its name. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param icon The resource ID the application would like to use as its icon. 5767eec10e6c99c30d5ee061fec08ac89ad4254ac32Dianne Hackborn * @param windowFlags Window layout flags. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Optionally you can return the View that was used to create the 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window, for easy removal in removeStartingWindow. 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #removeStartingWindow 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public View addStartingWindow(IBinder appToken, String packageName, 5842f0b17573d4324832f7a20402a3d2b5920bc4866Dianne Hackborn int theme, CompatibilityInfo compatInfo, CharSequence nonLocalizedLabel, 5857eec10e6c99c30d5ee061fec08ac89ad4254ac32Dianne Hackborn int labelRes, int icon, int windowFlags); 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the first window of an application has been displayed, while 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #addStartingWindow} has created a temporary initial window for 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that application. You should at this point remove the window from the 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager. This is called without the window manager locked so 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that you can call back into it. 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note: due to the nature of these functions not being called with the 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked, you must be prepared for this function to be 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called multiple times and/or an initial time with a null View window 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even if you previously returned one. 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application that has started. 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param window Window View that was returned by createStartingWindow. 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #addStartingWindow 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeStartingWindow(IBinder appToken, View window); 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prepare for a window being added to the window manager. You can throw an 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exception here to prevent the window being added, or do whatever setup 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you need to keep track of the window. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being added. 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window's LayoutParams. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@link WindowManagerImpl#ADD_OKAY} if the add can proceed, else an 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code to abort the add. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int prepareAddWindowLw(WindowState win, 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs); 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a window is being removed from a window manager. Must not 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * throw an exception -- clean up as much as possible. 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being removed. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeWindowLw(WindowState win); 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Control the animation to run when a window's state changes. Return a 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * non-0 number to force the animation to a specific resource ID, or 0 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to use the default animation. 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that is changing. 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param transit What is happening to the window: {@link #TRANSIT_ENTER}, 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_EXIT}, {@link #TRANSIT_SHOW}, or 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_HIDE}. 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resource ID of the actual animation to use, or 0 for none. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int selectAnimationLw(WindowState win, int transit); 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6433b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Create and return an animation to re-display a force hidden window. 6443b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 6453b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public Animation createForceHideEnterAnimation(); 6463b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn 6473b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 64800fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input reader thread before a key is enqueued. 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>There are some actions that need to be handled here because they 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affect the power state of the device, for example, the power keys. 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Generally, it's best to keep as little as possible in the queue thread 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because it's the most fragile. 6541f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 65500fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 65600fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param isScreenOn True if the screen is already on 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The bitwise or of the {@link #ACTION_PASS_TO_USER}, 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #ACTION_POKE_USER_ACTIVITY} and {@link #ACTION_GO_TO_SLEEP} flags. 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6611f2451007c660091b7b090c1ea332f9044515d2dJeff Brown public int interceptKeyBeforeQueueing(KeyEvent event, int policyFlags, boolean isScreenOn); 66256194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 66356194ebec6212e229f4ccdaa4b187166d20013efJeff Brown /** 66456194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * Called from the input reader thread before a motion is enqueued when the screen is off. 66556194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 66656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * <p>There are some actions that need to be handled here because they 66756194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * affect the power state of the device, for example, waking on motions. 66856194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * Generally, it's best to keep as little as possible in the queue thread 66956194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * because it's the most fragile. 67056194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * @param policyFlags The policy flags associated with the motion. 67156194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 67256194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * @return The bitwise or of the {@link #ACTION_PASS_TO_USER}, 67356194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * {@link #ACTION_POKE_USER_ACTIVITY} and {@link #ACTION_GO_TO_SLEEP} flags. 67456194ebec6212e229f4ccdaa4b187166d20013efJeff Brown */ 67556194ebec6212e229f4ccdaa4b187166d20013efJeff Brown public int interceptMotionBeforeQueueingWhenScreenOff(int policyFlags); 67656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 67800fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input dispatcher thread before a key is dispatched to a window. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Allows you to define 6813915bb845b032dc184dba5e60970b803390ca3edJeff Brown * behavior for keys that can not be overridden by applications. 6823915bb845b032dc184dba5e60970b803390ca3edJeff Brown * This method is called from the input thread, with no locks held. 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that currently has focus. This is where the key 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * event will normally go. 6861f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 68700fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 688d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * @return 0 if the key should be dispatched immediately, -1 if the key should 689d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * not be dispatched ever, or a positive value indicating the number of 690d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * milliseconds by which the key dispatch should be delayed before trying 691d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * again. 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 693d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown public long interceptKeyBeforeDispatching(WindowState win, KeyEvent event, int policyFlags); 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6963915bb845b032dc184dba5e60970b803390ca3edJeff Brown * Called from the input dispatcher thread when an application did not handle 6973915bb845b032dc184dba5e60970b803390ca3edJeff Brown * a key that was dispatched to it. 6983915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 6993915bb845b032dc184dba5e60970b803390ca3edJeff Brown * <p>Allows you to define default global behavior for keys that were not handled 7003915bb845b032dc184dba5e60970b803390ca3edJeff Brown * by applications. This method is called from the input thread, with no locks held. 7013915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 7023915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param win The window that currently has focus. This is where the key 7033915bb845b032dc184dba5e60970b803390ca3edJeff Brown * event will normally go. 7041f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 7053915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param policyFlags The policy flags associated with the key. 70649ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * @return Returns an alternate key event to redispatch as a fallback, or null to give up. 70749ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * The caller is responsible for recycling the key event. 7083915bb845b032dc184dba5e60970b803390ca3edJeff Brown */ 70949ed71db425c5054e3ad9526496a7e116c89556bJeff Brown public KeyEvent dispatchUnhandledKey(WindowState win, KeyEvent event, int policyFlags); 7103915bb845b032dc184dba5e60970b803390ca3edJeff Brown 7113915bb845b032dc184dba5e60970b803390ca3edJeff Brown /** 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is about to start. 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 7161f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn * @param displayRotation The current rotation being applied to the base 7171f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn * window. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7191f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public void beginLayoutLw(int displayWidth, int displayHeight, int displayRotation); 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called for each window attached to the window manager as layout is 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proceeding. The implementation of this function must take care of 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the window's frame, either here or in finishLayout(). 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attached For sub-windows, the window it is attached to; this 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window will already have had layoutWindow() called on it 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so you can use its Rect. Otherwise null. 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void layoutWindowLw(WindowState win, 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs, WindowState attached); 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the insets for the areas covered by system windows. These values 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are computed on the most recent layout, so they are not guaranteed to 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be correct. 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param contentInset The areas covered by system windows, expressed as positive insets 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void getContentInsetHintLw(WindowManager.LayoutParams attrs, Rect contentInset); 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is finished. After this function has 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned, all windows given to layoutWindow() <em>must</em> have had a 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * frame assigned. 7517ac3f67c179ec77caeee59b86d87d4ec007c4586Dianne Hackborn * 752b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * @return Return any bit set of {@link #FINISH_LAYOUT_REDO_LAYOUT}, 753b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * {@link #FINISH_LAYOUT_REDO_CONFIG}, {@link #FINISH_LAYOUT_REDO_WALLPAPER}, 754b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * or {@link #FINISH_LAYOUT_REDO_ANIM}. 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7569bfb707597898f54722460b48588007b682f3e2aDianne Hackborn public int finishLayoutLw(); 7579bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 7589bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Layout state may have changed (so another layout will be performed) */ 7599bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_LAYOUT = 0x0001; 7609bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Configuration state may have changed */ 7619bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_CONFIG = 0x0002; 7629bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Wallpaper may need to move */ 7639bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_WALLPAPER = 0x0004; 764b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn /** Need to recompute animations */ 765b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn static final int FINISH_LAYOUT_REDO_ANIM = 0x0008; 7669bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when animation of the windows is about to start. 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void beginAnimationLw(int displayWidth, int displayHeight); 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called each time a window is animating. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void animatingWindowLw(WindowState win, 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs); 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when animation of the windows is finished. If in this function you do 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * something that may have modified the animation state of another window, 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sure to return true in order to perform another animation frame. 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 789b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * @return Return any bit set of {@link #FINISH_LAYOUT_REDO_LAYOUT}, 790b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * {@link #FINISH_LAYOUT_REDO_CONFIG}, {@link #FINISH_LAYOUT_REDO_WALLPAPER}, 791b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * or {@link #FINISH_LAYOUT_REDO_ANIM}. 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 793b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn public int finishAnimationLw(); 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 796de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * Return true if it is okay to perform animations for an app transition 797de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * that is about to occur. You may return false for this if, for example, 798de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * the lock screen is currently displayed so the switch should happen 799de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * immediately. 800de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn */ 801de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn public boolean allowAppAnimationsLw(); 802664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 803664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 804664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato /** 805664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato * A new window has been focused. 806664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato */ 807df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public int focusChangedLw(WindowState lastFocus, WindowState newFocus); 808de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn 809de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called after the screen turns off. 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param why {@link #OFF_BECAUSE_OF_USER} or 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #OFF_BECAUSE_OF_TIMEOUT}. 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void screenTurnedOff(int why); 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 81738e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn public interface ScreenOnListener { 81838e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn void onScreenOn(); 81938e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn }; 82038e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 82238e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn * Called when the power manager would like to turn the screen on. 82338e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn * Must call back on the listener to tell it when the higher-level system 82438e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn * is ready for the screen to go on (i.e. the lock screen is shown). 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 82638e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn public void screenTurningOn(ScreenOnListener screenOnListener); 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 829bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn * Return whether the screen is about to turn on or is currently on. 830de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn */ 831bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn public boolean isScreenOnEarly(); 832bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn 833bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn /** 834bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn * Return whether the screen is fully turned on. 835bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn */ 836bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn public boolean isScreenOnFully(); 83700fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown 838de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 83900fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Tell the policy that the lid switch has changed state. 84000fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param whenNanos The time when the change occurred in uptime nanoseconds. 84100fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param lidOpen True if the lid is now open. 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 84346b9ac0ae2162309774a7478cd9d4e578747bfc2Jeff Brown public void notifyLidSwitchChanged(long whenNanos, boolean lidOpen); 84446b9ac0ae2162309774a7478cd9d4e578747bfc2Jeff Brown 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting that keyguard not come on. 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled Whether keyguard can be on or not. does not actually 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * turn it on, unless it was previously disabled with this function. 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#disableKeyguard() 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#reenableKeyguard() 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableKeyguard(boolean enabled); 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback used by {@link WindowManagerPolicy#exitKeyguardSecurely} 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project interface OnKeyguardExitResult { 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onKeyguardExitResult(boolean success); 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting the keyguard to exit securely 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (this would be called after the keyguard was disabled) 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callback Callback to send the result back. 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager#exitKeyguardSecurely(android.app.KeyguardManager.OnKeyguardExitResult) 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void exitKeyguardSecurely(OnKeyguardExitResult callback); 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 872520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardLocked 873520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 874520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard is currently locked. 875520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 876520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is locked. 877520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 878520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardLocked(); 879520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 880520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 881520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardSecure 882520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 883520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard requires a password to unlock. 884520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 885520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is secure. 886520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 887520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardSecure(); 888520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 889520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inKeyguardRestrictedKeyInputMode 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if keyguard screen is showing or in restricted key input mode (i.e. in 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard password emergency screen). When in such mode, certain keys, 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as the Home key and the right soft keys, don't work. 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if in keyguard restricted input mode. 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inKeyguardRestrictedKeyInputMode(); 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 90190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Ask the policy to dismiss the keyguard, if it is currently shown. 90290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 90390c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn public void dismissKeyguardLw(); 90490c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn 90590c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 90601a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * Given an orientation constant, returns the appropriate surface rotation, 90701a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * taking into account sensors, docking mode, rotation lock, and other factors. 90801a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * 90901a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param orientation An orientation constant, such as 91001a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. 91101a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param lastRotation The most recently used rotation. 91201a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @return The surface rotation to use. 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 91401a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown public int rotationForOrientationLw(int orientation, int lastRotation); 91501a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 91701a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * Given an orientation constant and a rotation, returns true if the rotation 91801a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * has compatible metrics to the requested orientation. For example, if 91901a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * the application requested landscape and got seascape, then the rotation 92001a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * has compatible metrics; if the application requested portrait and got landscape, 92101a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * then the rotation has incompatible metrics; if the application did not specify 92201a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * a preference, then anything goes. 92301a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * 92401a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param orientation An orientation constant, such as 92501a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. 92601a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param rotation The rotation to check. 92701a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @return True if the rotation is compatible with the requested orientation. 928dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn */ 92901a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown public boolean rotationHasCompatibleMetricsLw(int orientation, int rotation); 930dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn 931dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn /** 932c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * Called by the window manager when the rotation changes. 933c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * 934c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * @param rotation The new rotation. 935c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown */ 936c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown public void setRotationLw(int rotation); 937c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown 938c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown /** 9396af0d50a8edb101d9da1306b6d85abf5dd3f9a30Dianne Hackborn * Called when the system is mostly done booting to determine whether 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system should go into safe mode. 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean detectSafeMode(); 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system is mostly done booting. 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void systemReady(); 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 950ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn * Called when the system is done booting to the point where the 951ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn * user can start interacting with it. 952ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn */ 953ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn public void systemBooted(); 954ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn 955ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn /** 956661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn * Show boot time message to the user. 957661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn */ 958661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn public void showBootMessage(final CharSequence msg, final boolean always); 959661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn 960661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn /** 961661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn * Hide the UI for showing boot messages, never to be displayed again. 962661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn */ 963661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn public void hideBootMessages(); 964661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn 965661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn /** 966ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * Called when userActivity is signalled in the power manager. 967ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * This is safe to call from any thread, with any window manager locks held or not. 968ef73162887943e16587b8e737b19e59348338e8cMike Lockwood */ 969ef73162887943e16587b8e737b19e59348338e8cMike Lockwood public void userActivity(); 970ef73162887943e16587b8e737b19e59348338e8cMike Lockwood 971ef73162887943e16587b8e737b19e59348338e8cMike Lockwood /** 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when we have finished booting and can now display the home 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * screen to the user. This wilWl happen after systemReady(), and at 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this point the display is active. 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableScreenAfterBoot(); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 978c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public void setCurrentOrientationLw(int newOrientation); 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call from application to perform haptic feedback on its window. 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 983c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public boolean performHapticFeedbackLw(WindowState win, int effectId, boolean always); 9849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9860601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * Called when we have started keeping the screen on because a window 9870601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * requesting this has become visible. 9880601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler */ 9890601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler public void screenOnStartedLw(); 9900601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler 9910601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler /** 9920601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * Called when we have stopped keeping the screen on because the last window 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * requesting this is no longer visible. 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 995c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public void screenOnStoppedLw(); 9963d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood 9973d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood /** 9983d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood * Return false to disable key repeat events from being generated. 9993d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood */ 10003d0ea72dd74bb0a7ad082a82dbf53df11a4f487cMike Lockwood public boolean allowKeyRepeat(); 1001b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler 1002b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** 1003b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * Inform the policy that the user has chosen a preferred orientation ("rotation lock"). 1004b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * 1005b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param mode One of {@link WindowManagerPolicy#USER_ROTATION_LOCKED} or 1006b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * {@link * WindowManagerPolicy#USER_ROTATION_FREE}. 1007b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param rotation One of {@link Surface#ROTATION_0}, {@link Surface#ROTATION_90}, 1008b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * {@link Surface#ROTATION_180}, {@link Surface#ROTATION_270}. 1009b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler */ 1010b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public void setUserRotationMode(int mode, int rotation); 1011f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 1012f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn /** 1013df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Called when a new system UI visibility is being reported, allowing 1014df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * the policy to adjust what is actually reported. 1015df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * @param visibility The raw visiblity reported by the status bar. 1016df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * @return The new desired visibility. 1017df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 1018df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public int adjustSystemUiVisibilityLw(int visibility); 1019df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 1020df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 10210c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler * Specifies whether there is an on-screen navigation bar separate from the status bar. 10220c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler */ 10230c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler public boolean hasNavigationBar(); 10240c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler 10250c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler /** 1026f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * Print the WindowManagerPolicy's state into the given stream. 1027f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * 1028f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param prefix Text to print at the front of each line. 1029f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param fd The raw file descriptor that the dump is being sent to. 1030f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param writer The PrintWriter to which you should dump your state. This will be 1031f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * closed for you after you return. 1032f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param args additional arguments to the dump request. 1033f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn */ 1034f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args); 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1036