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 19d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.annotation.IntDef; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Context; 21d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport android.content.pm.ActivityInfo; 222f0b17573d4324832f7a20402a3d2b5920bc4866Dianne Hackbornimport android.content.res.CompatibilityInfo; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.res.Configuration; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.graphics.Rect; 25d040edbae968d826aa2c82d382345811a45c646bDianne Hackbornimport android.graphics.RectF; 26f752202bee88e31ce765483ba2efa6999ae9c9adAdam Cohenimport android.os.Bundle; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 28df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackbornimport android.os.Looper; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.animation.Animation; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 31f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackbornimport java.io.PrintWriter; 32d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.Retention; 33d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbyeimport java.lang.annotation.RetentionPolicy; 34f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This interface supplies all UI-specific behavior of the window manager. An 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance of it is created by the window manager when it starts up, and allows 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * customization of window layering, special window types, key dispatching, and 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout. 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Because this provides deep interaction with the system window manager, 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * specific methods on this interface can be called from a variety of contexts 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with various restrictions on what they can do. These are encoded through 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a suffixes at the end of a method encoding the thread the method is called 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * from and any locks that are held when it is being called; if no suffix 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is attached to a method, then it is not called with any locks and may be 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called from the main window manager thread or another thread calling into 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>The current suffixes are: 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dl> 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Ti <dd> Called from the input thread. This is the thread that 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * collects pending input events and dispatches them to the appropriate window. 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It may block waiting for events to be processed, so that the input stream is 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * properly serialized. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Tq <dd> Called from the low-level input queue thread. This is the 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * thread that reads events out of the raw input devices and places them 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * into the global input queue that is read by the <var>Ti</var> thread. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This thread should not block for a long period of time on anything but the 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * key driver. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Lw <dd> Called with the main window manager lock held. Because the 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager is a very low-level system service, there are few other 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * system services you can call with this lock held. It is explicitly okay to 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make calls into the package manager and power manager; it is explicitly not 66c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project * okay to make calls into the activity manager or most other services. Note that 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#checkPermission(String, int, int)} and 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * variations require calling into the activity manager. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <dt> Li <dd> Called with the input thread lock held. This lock can be 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * acquired by the window manager while it holds the window lock, so this is 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even more restrictive than <var>Lw</var>. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </dl> 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface WindowManagerPolicy { 77b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown // Policy flags. These flags are also defined in frameworks/base/include/ui/Input.h. 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public final static int FLAG_WAKE = 0x00000001; 79337d9d2edc262141f9b8f684e53aae5e47f0ae13Michael Wright public final static int FLAG_VIRTUAL = 0x00000002; 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8185a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown public final static int FLAG_INJECTED = 0x01000000; 82e20c9e0264190f94324197a8271cf03811a4ca58Jeff Brown public final static int FLAG_TRUSTED = 0x02000000; 830029c66203ab9ded4342976bf7a17bb63af8c44aJeff Brown public final static int FLAG_FILTERED = 0x04000000; 840029c66203ab9ded4342976bf7a17bb63af8c44aJeff Brown public final static int FLAG_DISABLE_KEY_REPEAT = 0x08000000; 8585a3176704b5bfbeece9bd928369fbb76eec7dc6Jeff Brown 86037c33eae74bee2774897d969d48947f9abe254fJeff Brown public final static int FLAG_INTERACTIVE = 0x20000000; 87b699726018a0049665d8ad6b90dbc5af0e18f135Jeff Brown public final static int FLAG_PASS_TO_USER = 0x40000000; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 89daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown // Flags used for indicating whether the internal and/or external input devices 90daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown // of some type are available. 91daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown public final static int PRESENCE_INTERNAL = 1 << 0; 92daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown public final static int PRESENCE_EXTERNAL = 1 << 1; 93daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown 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 * Interface to the Window Manager state associated with a particular 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window. You can hold on to an instance of this interface from the call 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to prepareAddWindow() until removeWindow(). 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public interface WindowState { 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 120f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn * Return the uid of the app that owns this window. 121f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn */ 122f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn int getOwningUid(); 123f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn 124f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn /** 125f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn * Return the package name of the app that owns this window. 126f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn */ 127f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn String getOwningPackage(); 128f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn 129f265ea9d8307282ff1da3915978625a94fc2859eDianne Hackborn /** 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform standard frame computation. The result can be obtained with 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * getFrame() if so desired. Must be called with the window manager 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param parentFrame The frame of the parent container this window 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is in, used for computing its basic position. 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayFrame The frame of the overall display in which this 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window can appear, used for constraining the overall dimensions 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the window. 139c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * @param overlayFrame The frame within the display that is inside 140c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * of the overlay region. 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param contentFrame The frame within the display in which we would 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * like active content to appear. This will cause windows behind to 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be resized to match the given content frame. 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param visibleFrame The frame within the display that the window 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is actually visible, used for computing its visible insets to be 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * given to windows behind. 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This can be used as a hint for scrolling (avoiding resizing) 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window to make certain that parts of its content 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are visible. 1504664623c304cf162b9a78f3aee3290a92e54b628John Spurlock * @param decorFrame The decor frame specified by policy specific to this window, 1514664623c304cf162b9a78f3aee3290a92e54b628John Spurlock * to use for proper cropping during animation. 152fa10423fa00f3495e451016acba9b6848eb995c9Adrian Roos * @param stableFrame The frame around which stable system decoration is positioned. 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void computeFrameLw(Rect parentFrame, Rect displayFrame, 155fa10423fa00f3495e451016acba9b6848eb995c9Adrian Roos Rect overlayFrame, Rect contentFrame, Rect visibleFrame, Rect decorFrame, 156fa10423fa00f3495e451016acba9b6848eb995c9Adrian Roos Rect stableFrame); 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that has been assigned by 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the window manager. Must be called with the window manager lock held. 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the window frame. 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getFrameLw(); 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current frame of the window that is actually shown. 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Must be called with the window manager lock held. 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the shown window frame. 1719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 172d040edbae968d826aa2c82d382345811a45c646bDianne Hackborn public RectF getShownFrameLw(); 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the display that this window was last 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. Must be called with the 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1785c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn * 1799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the display frame. 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getDisplayFrameLw(); 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 184c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * Retrieve the frame of the area inside the overscan region of the 185c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * display that this window was last laid out in. Must be called with the 186c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * window manager lock held. 187c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * 188c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn * @return Rect The rectangle holding the display overscan frame. 189c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn */ 190c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn public Rect getOverscanFrameLw(); 191c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn 192c4aad01cbbb69c916ef323693e1fd0560b0eccbaDianne Hackborn /** 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the content area that this window was last 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area in which the content of the window 1959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should be placed. It will be smaller than the display frame to 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * account for screen decorations such as a status bar or soft 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyboard. Must be called with the 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the content frame. 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getContentFrameLw(); 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the frame of the visible area that this window was last 2069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * laid out in. This is the area of the screen in which the window 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will actually be fully visible. It will be smaller than the 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * content frame to account for transient UI elements blocking it 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as an input method's candidates UI. Must be called with the 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The rectangle holding the visible frame. 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getVisibleFrameLw(); 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window is waiting to receive its given 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internal insets from the client app, and so should not impact the 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * layout of other windows. 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean getGivenInsetsPendingLw(); 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the content 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual contents. 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenContentInsetsLw(); 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the insets given by this window's client for the visible 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * area of windows behind it. Must be called with the 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Rect The left, top, right, and bottom insets, relative 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the window's frame, of the actual visible area. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Rect getGivenVisibleInsetsLw(); 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve the current LayoutParams of the window. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return WindowManager.LayoutParams The window's internal LayoutParams 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * instance. 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WindowManager.LayoutParams getAttrs(); 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 25273ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * Return whether this window needs the menu key shown. Must be called 25373ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * with window lock held, because it may need to traverse down through 25473ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * window list to determine the result. 25573ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn * @param bottom The bottom-most window to consider when determining this. 25673ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn */ 25773ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn public boolean getNeedsMenuLw(WindowState bottom); 25873ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn 25973ab6a49db2b834ce1d56c7a1164938b409ee6fcDianne Hackborn /** 2609a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn * Retrieve the current system UI visibility flags associated with 2619a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn * this window. 2629a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn */ 2639a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn public int getSystemUiVisibility(); 2649a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn 2659a230e01a1237749a8a19a5de8d46531b0c8ca6aDianne Hackborn /** 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Get the layer at which this window's surface will be Z-ordered. 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getSurfaceLayer(); 2699cf34e2ee4cb3d2e14c2863298ad3a2fafc31d39Craig Mautner 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the token for the application (actually activity) that owns 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window. May return null for system windows. 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return An IApplicationToken identifying the owning activity. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public IApplicationToken getAppToken(); 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 279e30e02f5d9a9141c9ee70c712d4f9d52c88ea969Dianne Hackborn * Return true if this window is participating in voice interaction. 280e30e02f5d9a9141c9ee70c712d4f9d52c88ea969Dianne Hackborn */ 281e30e02f5d9a9141c9ee70c712d4f9d52c88ea969Dianne Hackborn public boolean isVoiceInteraction(); 282e30e02f5d9a9141c9ee70c712d4f9d52c88ea969Dianne Hackborn 283e30e02f5d9a9141c9ee70c712d4f9d52c88ea969Dianne Hackborn /** 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return true if, at any point, the application token associated with 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this window has actually displayed any windows. This is most useful 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with the "starting up" window to determine if any windows were 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed when it is closed. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns true if one or more windows have been displayed, 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else false. 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasAppShownWindows(); 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window visible? It is not visible if there is no 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * surface, or we are in the process of running an exit animation 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that will remove the surface. 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isVisibleLw(); 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3023d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * Like {@link #isVisibleLw}, but also counts a window that is currently 3033d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * "hidden" behind the keyguard as visible. This allows us to apply 3043d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn * things like window flags that impact the keyguard. 3053d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn */ 3063d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn boolean isVisibleOrBehindKeyguardLw(); 3073d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn 3083d163f073f5cf3b3bf0287fc7d60fabce0269748Dianne Hackborn /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Is this window currently visible to the user on-screen? It is 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * displayed either if it is visible or it is currently running an 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animation before no longer being visible. Must be called with the 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager lock held. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project boolean isDisplayedLw(); 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3175c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn * Return true if this window (or a window it is attached to, but not 3185c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn * considering its app token) is currently animating. 3195c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn */ 3205c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn public boolean isAnimatingLw(); 3215c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn 3225c58de3a523a384c47b0b1e0f5dd9728a74cd9f7Dianne Hackborn /** 32301b02a734d2988c22b00f5df6346ad03d8bf52b6Dianne Hackborn * Is this window considered to be gone for purposes of layout? 32401b02a734d2988c22b00f5df6346ad03d8bf52b6Dianne Hackborn */ 32501b02a734d2988c22b00f5df6346ad03d8bf52b6Dianne Hackborn boolean isGoneForLayoutLw(); 32601b02a734d2988c22b00f5df6346ad03d8bf52b6Dianne Hackborn 32701b02a734d2988c22b00f5df6346ad03d8bf52b6Dianne Hackborn /** 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if this window has been shown on screen at some time in 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the past. Must be called with the window manager lock held. 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hasDrawnLw(); 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called by the policy to force a window to be hidden, 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * regardless of whether the client or window manager would like 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it shown. Must be called with the window manager lock held. 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #showLw} was last called for the window. 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean hideLw(boolean doAnimation); 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Can be called to undo the effect of {@link #hideLw}, allowing a 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window to be shown as long as the window manager and client would 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * also like it to be shown. Must be called with the window manager 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock held. 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns true if {@link #hideLw} was last called for the window. 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean showLw(boolean doAnimation); 349f87d19621dc2a30232bba1f51862a0b671eb9729Dianne Hackborn 350f87d19621dc2a30232bba1f51862a0b671eb9729Dianne Hackborn /** 351f87d19621dc2a30232bba1f51862a0b671eb9729Dianne Hackborn * Check whether the process hosting this window is currently alive. 352f87d19621dc2a30232bba1f51862a0b671eb9729Dianne Hackborn */ 353f87d19621dc2a30232bba1f51862a0b671eb9729Dianne Hackborn public boolean isAlive(); 35469b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner 35569b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner /** 35669b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner * Check if window is on {@link Display#DEFAULT_DISPLAY}. 35769b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner * @return true if window is on default display. 35869b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner */ 35969b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner public boolean isDefaultDisplay(); 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3623b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 363df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Representation of a "fake window" that the policy has added to the 364df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * window manager to consume events. 365df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 366df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public interface FakeWindow { 367df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 368df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Remove the fake window from the window manager. 369df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 370df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn void dismiss(); 371df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn } 372df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 373df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 374df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Interface for calling back in to the window manager that is private 375df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * between it and the policy. 376df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 377df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public interface WindowManagerFuncs { 378ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int LID_ABSENT = -1; 379ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int LID_CLOSED = 0; 380ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public static final int LID_OPEN = 1; 381ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 3823818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright public static final int CAMERA_LENS_COVER_ABSENT = -1; 3833818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright public static final int CAMERA_LENS_UNCOVERED = 0; 3843818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright public static final int CAMERA_LENS_COVERED = 1; 3853818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright 386df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 387df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Ask the window manager to re-evaluate the system UI flags. 388df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 389df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public void reevaluateStatusBarVisibility(); 390df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 391df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 392df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Add a fake window to the window manager. This window sits 393df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * at the top of the other windows and consumes events. 394df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 39532cbc3855c2a971aa5a801fd339fb6a37db91a1aJeff Brown public FakeWindow addFakeWindow(Looper looper, 39632cbc3855c2a971aa5a801fd339fb6a37db91a1aJeff Brown InputEventReceiver.Factory inputEventReceiverFactory, 39795c42974f719d1fac90fc0438eac778e9795681fAdam Lesinski String name, int windowType, int layoutParamsFlags, int layoutParamsPrivateFlags, 39895c42974f719d1fac90fc0438eac778e9795681fAdam Lesinski boolean canReceiveKeys, boolean hasFocus, boolean touchFullscreen); 399ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 400ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 401ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Returns a code that describes the current state of the lid switch. 402ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown */ 403ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public int getLidState(); 404ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown 405ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown /** 4063818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright * Returns a code that descripbes whether the camera lens is covered or not. 4073818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright */ 4083818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright public int getCameraLensCoverState(); 4093818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright 4103818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright /** 411cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Switch the keyboard layout for the given device. 412cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown * Direction should be +1 or -1 to go to the next or previous keyboard layout. 413cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown */ 414cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown public void switchKeyboardLayout(int deviceId, int direction); 415cf39bdf3dff5e29447f6ce734b76dc3490385e58Jeff Brown 4169a538ee7bde42ad36f43edc48594282d98e191a4Jeff Brown public void shutdown(boolean confirm); 4179a538ee7bde42ad36f43edc48594282d98e191a4Jeff Brown public void rebootSafeMode(boolean confirm); 41804db1762fb75a3938dda34537626c41c8e97d9c5John Spurlock 41904db1762fb75a3938dda34537626c41c8e97d9c5John Spurlock /** 42004db1762fb75a3938dda34537626c41c8e97d9c5John Spurlock * Return the window manager lock needed to correctly call "Lw" methods. 42104db1762fb75a3938dda34537626c41c8e97d9c5John Spurlock */ 42204db1762fb75a3938dda34537626c41c8e97d9c5John Spurlock public Object getWindowManagerLock(); 423037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner 424037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner /** Register a system listener for touch events */ 425037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner void registerPointerEventListener(PointerEventListener listener); 426037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner 427037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner /** Unregister a system listener for touch events */ 428037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner void unregisterPointerEventListener(PointerEventListener listener); 429037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner } 430037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner 431037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner public interface PointerEventListener { 432037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner /** 433037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner * 1. onPointerEvent will be called on the service.UiThread. 434037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner * 2. motionEvent will be recycled after onPointerEvent returns so if it is needed later a 435037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner * copy() must be made and the copy must be recycled. 436037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner **/ 437037aa8d434984840691378f3cc7d99d63dcc4076Craig Mautner public void onPointerEvent(MotionEvent motionEvent); 438df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn } 439df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been added to the screen. */ 4414b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner public static final int TRANSIT_ENTER = 1; 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been removed from the screen. */ 4434b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner public static final int TRANSIT_EXIT = 2; 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Window has been made visible. */ 4454b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner public static final int TRANSIT_SHOW = 3; 4464b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner /** Window has been made invisible. 4474b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner * TODO: Consider removal as this is unused. */ 4484b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner public static final int TRANSIT_HIDE = 4; 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The "application starting" preview window is no longer needed, and will 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * animate away to show the real window. */ 4514b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner public static final int TRANSIT_PREVIEW_DONE = 5; 4524b71aa1f8a1a3b7189fd29241ea7c594ce01623cCraig Mautner 453254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // NOTE: screen off reasons are in order of significance, with more 454254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn // important ones lower than less important ones. 455254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn 456254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn /** Screen turned off because of a device admin */ 457254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_ADMIN = 1; 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of power button */ 459254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_USER = 2; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Screen turned off because of timeout */ 461254cb446faa7cb13699d8150eb4cc4f44cb61a2dDianne Hackborn public final int OFF_BECAUSE_OF_TIMEOUT = 3; 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 463d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye /** @hide */ 464d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @IntDef({USER_ROTATION_FREE, USER_ROTATION_LOCKED}) 465d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @Retention(RetentionPolicy.SOURCE) 466d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public @interface UserRotationMode {} 467d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye 468b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation should be 469b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * determined by the system (that is, using sensors). */ 470b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_FREE = 0; 471b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** When not otherwise specified by the activity's screenOrientation, rotation is set by 472b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * the user. */ 473b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler public final int USER_ROTATION_LOCKED = 1; 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Perform initialization of the policy. 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param context The system context we are running in. 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void init(Context context, IWindowManager windowManager, 4819630704ed3b265f008a8f64ec60a33cf9dcd3345Jeff Brown WindowManagerFuncs windowManagerFuncs); 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 48446ac6fa614131d567bed93d1d2067d765ecef85dCraig Mautner * @return true if com.android.internal.R.bool#config_forceDefaultOrientation is true. 48546ac6fa614131d567bed93d1d2067d765ecef85dCraig Mautner */ 48646ac6fa614131d567bed93d1d2067d765ecef85dCraig Mautner public boolean isDefaultOrientationForced(); 48746ac6fa614131d567bed93d1d2067d765ecef85dCraig Mautner 48846ac6fa614131d567bed93d1d2067d765ecef85dCraig Mautner /** 4899d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn * Called by window manager once it has the initial, default native 4909d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn * display dimensions. 4919d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn */ 492dde331cebd87982faded6818ad5f9927ff994c96Dianne Hackborn public void setInitialDisplaySize(Display display, int width, int height, int density); 493dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn 4949d13264f6b5818812e61d66baaada599b8ad1fafDianne Hackborn /** 495c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn * Called by window manager to set the overscan region that should be used for the 496c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn * given display. 497c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn */ 498c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn public void setDisplayOverscan(Display display, int left, int top, int right, int bottom); 499c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn 500c652de8141f5b8e3c6bcf8916842b6e106413b1aDianne Hackborn /** 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check permissions when adding a window. 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 503c2293025a25e04b26bf53713d71f85fd9ca5e8e9Dianne Hackborn * @param attrs The window's LayoutParams. 504c2293025a25e04b26bf53713d71f85fd9ca5e8e9Dianne Hackborn * @param outAppOp First element will be filled with the app op corresponding to 505c2293025a25e04b26bf53713d71f85fd9ca5e8e9Dianne Hackborn * this window, or OP_NONE. 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 50798365d7663cbd82979a5700faf0050220b01084dJeff Brown * @return {@link WindowManagerGlobal#ADD_OKAY} if the add can proceed; 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * else an error code, usually 50998365d7663cbd82979a5700faf0050220b01084dJeff Brown * {@link WindowManagerGlobal#ADD_PERMISSION_DENIED}, to abort the add. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 511c2293025a25e04b26bf53713d71f85fd9ca5e8e9Dianne Hackborn public int checkAddPermission(WindowManager.LayoutParams attrs, int[] outAppOp); 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 51488400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * Check permissions when adding a window. 51588400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * 51688400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * @param attrs The window's LayoutParams. 51788400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * 51888400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * @return True if the window may only be shown to the current user, false if the window can 51988400d3a31139c40c4014faf86c243647087ef6cCraig Mautner * be shown on all users' windows. 52088400d3a31139c40c4014faf86c243647087ef6cCraig Mautner */ 52188400d3a31139c40c4014faf86c243647087ef6cCraig Mautner public boolean checkShowToOwnerOnly(WindowManager.LayoutParams attrs); 52288400d3a31139c40c4014faf86c243647087ef6cCraig Mautner 52388400d3a31139c40c4014faf86c243647087ef6cCraig Mautner /** 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sanitize the layout parameters coming from a client. Allows the policy 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to do things like ensure that windows of a specific type can't take 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * input focus. 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window layout parameters to be modified. These values 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are modified in-place. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void adjustWindowParamsLw(WindowManager.LayoutParams attrs); 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * After the window manager has computed the current configuration based 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on its knowledge of the display and input devices, it gives the policy 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a chance to adjust the information contained in it. If you want to 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * leave it as-is, simply do nothing. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>This method may be called by any thread in the window manager, but 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no internal locks in the window manager will be held. 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The Configuration being computed, for you to change as 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * desired. 544daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown * @param keyboardPresence Flags that indicate whether internal or external 545daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown * keyboards are present. 546daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown * @param navigationPresence Flags that indicate whether internal or external 547daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown * navigation devices are present. 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 549daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown public void adjustConfigurationLw(Configuration config, int keyboardPresence, 550daa3753a04699724d2cfe824ac1f5a266d643a05Jeff Brown int navigationPresence); 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Assign a window type to a layer. Allows you to control how different 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * kinds of windows are ordered on-screen. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The type of window being assigned. 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int An arbitrary integer used to order windows, with lower 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * numbers below higher ones. 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int windowTypeToLayerLw(int type); 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return how to Z-order sub-windows in relation to the window they are 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached to. Return positive to have them ordered in front, negative for 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * behind. 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param type The sub-window type code. 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return int Layer in relation to the attached window, where positive is 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above and negative is below. 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int subWindowTypeToLayerLw(int type); 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5766136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * Get the highest layer (actually one more than) that the wallpaper is 5776136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn * allowed to be in. 5786136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn */ 5796136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn public int getMaxWallpaperLayer(); 580a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn 581a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn /** 582a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn * Return the window layer at which windows appear above the normal 583a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn * universe (that is no longer impacted by the universe background 584a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn * transform). 585a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn */ 586a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn public int getAboveUniverseLayer(); 587a4b7f2f75e7803193429ec1179fb5e2eb1c6fbdaDianne Hackborn 5886136b7ef169a65a02a6660be636fcec370c68145Dianne Hackborn /** 58969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display width available after excluding any screen 59069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 59169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 592e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 5931f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getNonDecorDisplayWidth(int fullWidth, int fullHeight, int rotation); 594e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 595e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 59669cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the display height available after excluding any screen 59769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * decorations that can never be removed. That is, system bar or 59869cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * button bar. 599e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn */ 6001f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getNonDecorDisplayHeight(int fullWidth, int fullHeight, int rotation); 60169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 60269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 60369cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen width that we should report for the 60469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 60561ac6bb250494db602b485491a493b64776eaf3bCraig Mautner * {@link #getNonDecorDisplayWidth(int, int, int)}; it may be smaller than 60669cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 60769cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 6081f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getConfigDisplayWidth(int fullWidth, int fullHeight, int rotation); 60969cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn 61069cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn /** 61169cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * Return the available screen height that we should report for the 61269cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * configuration. This must be no larger than 61361ac6bb250494db602b485491a493b64776eaf3bCraig Mautner * {@link #getNonDecorDisplayHeight(int, int, int)}; it may be smaller than 61469cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn * that to account for more transient decoration like a status bar. 61569cb87576ba163b61bb0e6477a3b7c57a9b11d40Dianne Hackborn */ 6161f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn public int getConfigDisplayHeight(int fullWidth, int fullHeight, int rotation); 617e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn 618e2515eebf42c763c0a2d9f873a153711778cfc17Dianne Hackborn /** 619c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner * Return whether the given window is forcibly hiding all windows except windows with 620c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner * FLAG_SHOW_WHEN_LOCKED set. Typically returns true for the keyguard. 6213b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 622c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner public boolean isForceHiding(WindowManager.LayoutParams attrs); 6230d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi 6240d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi 6250d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi /** 626c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner * Return whether the given window can become one that passes isForceHiding() test. 6270d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi * Typically returns true for the StatusBar. 6280d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi */ 6290d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi public boolean isKeyguardHostWindow(WindowManager.LayoutParams attrs); 6300d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi 6313b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 6323b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Determine if a window that is behind one that is force hiding 633c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner * (as determined by {@link #isForceHiding}) should actually be hidden. 6343b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * For example, typically returns false for the status bar. Be careful 6353b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * to return false for any window that you may hide yourself, since this 6363b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * will conflict with what you set. 6373b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 6383b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn public boolean canBeForceHidden(WindowState win, WindowManager.LayoutParams attrs); 6390d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi 6403b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 6417d7808fcf8e6a1c27d52375210f9da2705d5f590Craig Mautner * Return the window that is hiding the keyguard, if such a thing exists. 6427d7808fcf8e6a1c27d52375210f9da2705d5f590Craig Mautner */ 6437d7808fcf8e6a1c27d52375210f9da2705d5f590Craig Mautner public WindowState getWinShowWhenLockedLw(); 6447d7808fcf8e6a1c27d52375210f9da2705d5f590Craig Mautner 6457d7808fcf8e6a1c27d52375210f9da2705d5f590Craig Mautner /** 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system would like to show a UI to indicate that an 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * application is starting. You can use this to add a 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * APPLICATION_STARTING_TYPE window with the given appToken to the window 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * manager (using the normal window manager APIs) that will be shown until 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the application displays its own window. This is called without the 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked so that you can call back into it. 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application being started. 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param packageName The name of the application package being started. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param theme Resource defining the application's overall visual theme. 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param nonLocalizedLabel The default title label of the application if 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * no data is found in the resource. 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param labelRes The resource ID the application would like to use as its name. 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param icon The resource ID the application would like to use as its icon. 6607eec10e6c99c30d5ee061fec08ac89ad4254ac32Dianne Hackborn * @param windowFlags Window layout flags. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Optionally you can return the View that was used to create the 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window, for easy removal in removeStartingWindow. 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #removeStartingWindow 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public View addStartingWindow(IBinder appToken, String packageName, 6682f0b17573d4324832f7a20402a3d2b5920bc4866Dianne Hackborn int theme, CompatibilityInfo compatInfo, CharSequence nonLocalizedLabel, 66904fe6ebb9f919f196ec06a19bebc09b8e943f95bAdam Powell int labelRes, int icon, int logo, int windowFlags); 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the first window of an application has been displayed, while 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #addStartingWindow} has created a temporary initial window for 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that application. You should at this point remove the window from the 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager. This is called without the window manager locked so 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * that you can call back into it. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Note: due to the nature of these functions not being called with the 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window manager locked, you must be prepared for this function to be 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called multiple times and/or an initial time with a null View window 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * even if you previously returned one. 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param appToken Token of the application that has started. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param window Window View that was returned by createStartingWindow. 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #addStartingWindow 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeStartingWindow(IBinder appToken, View window); 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Prepare for a window being added to the window manager. You can throw an 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * exception here to prevent the window being added, or do whatever setup 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you need to keep track of the window. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being added. 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The window's LayoutParams. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 69898365d7663cbd82979a5700faf0050220b01084dJeff Brown * @return {@link WindowManagerGlobal#ADD_OKAY} if the add can proceed, else an 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code to abort the add. 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int prepareAddWindowLw(WindowState win, 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project WindowManager.LayoutParams attrs); 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when a window is being removed from a window manager. Must not 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * throw an exception -- clean up as much as possible. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being removed. 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeWindowLw(WindowState win); 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Control the animation to run when a window's state changes. Return a 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * non-0 number to force the animation to a specific resource ID, or 0 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to use the default animation. 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that is changing. 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param transit What is happening to the window: {@link #TRANSIT_ENTER}, 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_EXIT}, {@link #TRANSIT_SHOW}, or 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #TRANSIT_HIDE}. 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Resource ID of the actual animation to use, or 0 for none. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int selectAnimationLw(WindowState win, int transit); 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7273c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * Determine the animation to run for a rotation transition based on the 7283c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * top fullscreen windows {@link WindowManager.LayoutParams#rotationAnimation} 7293c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * and whether it is currently fullscreen and frontmost. 7303c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * 7313c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * @param anim The exiting animation resource id is stored in anim[0], the 7323c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * entering animation resource id is stored in anim[1]. 7333c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner */ 7343c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner public void selectRotationAnimationLw(int anim[]); 7353c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner 7363c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner /** 7373c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * Validate whether the current top fullscreen has specified the same 7383c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * {@link WindowManager.LayoutParams#rotationAnimation} value as that 7393c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * being passed in from the previous top fullscreen window. 7403c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * 7413c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * @param exitAnimId exiting resource id from the previous window. 7423c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * @param enterAnimId entering resource id from the previous window. 7433c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * @param forceDefault For rotation animations only, if true ignore the 7443c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * animation values and just return false. 7453c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * @return true if the previous values are still valid, false if they 7463c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner * should be replaced with the default. 7473c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner */ 7483c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner public boolean validateRotationAnimationLw(int exitAnimId, int enterAnimId, 7493c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner boolean forceDefault); 7503c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner 7513c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner /** 7523b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn * Create and return an animation to re-display a force hidden window. 7533b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn */ 75484a3e7aacf6dbeccf4afb36a29f2f069dca7d486Jorim Jaggi public Animation createForceHideEnterAnimation(boolean onWallpaper, 75584a3e7aacf6dbeccf4afb36a29f2f069dca7d486Jorim Jaggi boolean goingToNotificationShade); 75676a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi 75776a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi /** 75876a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi * Create and return an animation to let the wallpaper disappear after being shown on a force 75976a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi * hiding window. 76076a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi */ 76184a3e7aacf6dbeccf4afb36a29f2f069dca7d486Jorim Jaggi public Animation createForceHideWallpaperExitAnimation(boolean goingToNotificationShade); 76276a1623afc170a13923b68f3256057d8adeb7937Jorim Jaggi 7633b3e145d3c41fd68974e08f799b1fd1f8f060cf0Dianne Hackborn /** 76400fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input reader thread before a key is enqueued. 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>There are some actions that need to be handled here because they 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affect the power state of the device, for example, the power keys. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Generally, it's best to keep as little as possible in the queue thread 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * because it's the most fragile. 7701f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 77100fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7732687550272ba061448f5d5b914700dc335299ee7Jeff Brown * @return Actions flags: may be {@link #ACTION_PASS_TO_USER}. 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 775037c33eae74bee2774897d969d48947f9abe254fJeff Brown public int interceptKeyBeforeQueueing(KeyEvent event, int policyFlags); 77656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 77756194ebec6212e229f4ccdaa4b187166d20013efJeff Brown /** 77870af00abf73160235d4efe114fcf4753007a8ff3Michael Wright * Called from the input reader thread before a motion is enqueued when the device is in a 77970af00abf73160235d4efe114fcf4753007a8ff3Michael Wright * non-interactive state. 78056194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 78156194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * <p>There are some actions that need to be handled here because they 78256194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * affect the power state of the device, for example, waking on motions. 78356194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * Generally, it's best to keep as little as possible in the queue thread 78456194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * because it's the most fragile. 78556194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * @param policyFlags The policy flags associated with the motion. 78656194ebec6212e229f4ccdaa4b187166d20013efJeff Brown * 7872687550272ba061448f5d5b914700dc335299ee7Jeff Brown * @return Actions flags: may be {@link #ACTION_PASS_TO_USER}. 78856194ebec6212e229f4ccdaa4b187166d20013efJeff Brown */ 78970af00abf73160235d4efe114fcf4753007a8ff3Michael Wright public int interceptMotionBeforeQueueingNonInteractive(long whenNanos, int policyFlags); 79056194ebec6212e229f4ccdaa4b187166d20013efJeff Brown 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 79200fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Called from the input dispatcher thread before a key is dispatched to a window. 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Allows you to define 7953915bb845b032dc184dba5e60970b803390ca3edJeff Brown * behavior for keys that can not be overridden by applications. 7963915bb845b032dc184dba5e60970b803390ca3edJeff Brown * This method is called from the input thread, with no locks held. 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window that currently has focus. This is where the key 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * event will normally go. 8001f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 80100fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param policyFlags The policy flags associated with the key. 802d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * @return 0 if the key should be dispatched immediately, -1 if the key should 803d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * not be dispatched ever, or a positive value indicating the number of 804d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * milliseconds by which the key dispatch should be delayed before trying 805d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown * again. 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 807d5bb82d18cbd95bb9e751d8315b9ed0b69595033Jeff Brown public long interceptKeyBeforeDispatching(WindowState win, KeyEvent event, int policyFlags); 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8103915bb845b032dc184dba5e60970b803390ca3edJeff Brown * Called from the input dispatcher thread when an application did not handle 8113915bb845b032dc184dba5e60970b803390ca3edJeff Brown * a key that was dispatched to it. 8123915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 8133915bb845b032dc184dba5e60970b803390ca3edJeff Brown * <p>Allows you to define default global behavior for keys that were not handled 8143915bb845b032dc184dba5e60970b803390ca3edJeff Brown * by applications. This method is called from the input thread, with no locks held. 8153915bb845b032dc184dba5e60970b803390ca3edJeff Brown * 8163915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param win The window that currently has focus. This is where the key 8173915bb845b032dc184dba5e60970b803390ca3edJeff Brown * event will normally go. 8181f2451007c660091b7b090c1ea332f9044515d2dJeff Brown * @param event The key event. 8193915bb845b032dc184dba5e60970b803390ca3edJeff Brown * @param policyFlags The policy flags associated with the key. 82049ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * @return Returns an alternate key event to redispatch as a fallback, or null to give up. 82149ed71db425c5054e3ad9526496a7e116c89556bJeff Brown * The caller is responsible for recycling the key event. 8223915bb845b032dc184dba5e60970b803390ca3edJeff Brown */ 82349ed71db425c5054e3ad9526496a7e116c89556bJeff Brown public KeyEvent dispatchUnhandledKey(WindowState win, KeyEvent event, int policyFlags); 8243915bb845b032dc184dba5e60970b803390ca3edJeff Brown 8253915bb845b032dc184dba5e60970b803390ca3edJeff Brown /** 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is about to start. 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 82869b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner * @param isDefaultDisplay true if window is on {@link Display#DEFAULT_DISPLAY}. 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 8311f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn * @param displayRotation The current rotation being applied to the base 8321f903c3b577d20f7db7e3d5875cafe577d0d845fDianne Hackborn * window. 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 83469b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner public void beginLayoutLw(boolean isDefaultDisplay, int displayWidth, int displayHeight, 83569b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner int displayRotation); 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8384664623c304cf162b9a78f3aee3290a92e54b628John Spurlock * Returns the bottom-most layer of the system decor, above which no policy decor should 8394664623c304cf162b9a78f3aee3290a92e54b628John Spurlock * be applied. 84085afd1b6f871d471fdff1980134676a5f1690525Dianne Hackborn */ 8414664623c304cf162b9a78f3aee3290a92e54b628John Spurlock public int getSystemDecorLayerLw(); 84285afd1b6f871d471fdff1980134676a5f1690525Dianne Hackborn 84385afd1b6f871d471fdff1980134676a5f1690525Dianne Hackborn /** 844967212cb542e6eeb308678367b53381bff984c31Craig Mautner * Return the rectangle of the screen that is available for applications to run in. 845967212cb542e6eeb308678367b53381bff984c31Craig Mautner * This will be called immediately after {@link #beginLayoutLw}. 846967212cb542e6eeb308678367b53381bff984c31Craig Mautner * 847967212cb542e6eeb308678367b53381bff984c31Craig Mautner * @param r The rectangle to be filled with the boundaries available to applications. 848967212cb542e6eeb308678367b53381bff984c31Craig Mautner */ 849967212cb542e6eeb308678367b53381bff984c31Craig Mautner public void getContentRectLw(Rect r); 850967212cb542e6eeb308678367b53381bff984c31Craig Mautner 851967212cb542e6eeb308678367b53381bff984c31Craig Mautner /** 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called for each window attached to the window manager as layout is 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * proceeding. The implementation of this function must take care of 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * setting the window's frame, either here or in finishLayout(). 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attached For sub-windows, the window it is attached to; this 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * window will already have had layoutWindow() called on it 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * so you can use its Rect. Otherwise null. 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 861c9457faeb6bf22ce8fc72bc61af5109a2b567c51Craig Mautner public void layoutWindowLw(WindowState win, WindowState attached); 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the insets for the areas covered by system windows. These values 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are computed on the most recent layout, so they are not guaranteed to 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be correct. 86837d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos * 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param attrs The LayoutParams of the window. 87037d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos * @param outContentInsets The areas covered by system windows, expressed as positive insets. 87137d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos * @param outStableInsets The areas covered by stable system windows irrespective of their 87237d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos * current visibility. Expressed as positive insets. 87337d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos * 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 87537d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos public void getInsetHintLw(WindowManager.LayoutParams attrs, Rect outContentInsets, 87637d7a68de7e353c31a3a4736054cd86f0e002eafAdrian Roos Rect outStableInsets); 87785afd1b6f871d471fdff1980134676a5f1690525Dianne Hackborn 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when layout of the windows is finished. After this function has 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * returned, all windows given to layoutWindow() <em>must</em> have had a 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * frame assigned. 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 88361ac6bb250494db602b485491a493b64776eaf3bCraig Mautner public void finishLayoutLw(); 8849bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 8859bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Layout state may have changed (so another layout will be performed) */ 8869bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_LAYOUT = 0x0001; 8879bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Configuration state may have changed */ 8889bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_CONFIG = 0x0002; 8899bfb707597898f54722460b48588007b682f3e2aDianne Hackborn /** Wallpaper may need to move */ 8909bfb707597898f54722460b48588007b682f3e2aDianne Hackborn static final int FINISH_LAYOUT_REDO_WALLPAPER = 0x0004; 891b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn /** Need to recompute animations */ 892b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn static final int FINISH_LAYOUT_REDO_ANIM = 0x0008; 8939bfb707597898f54722460b48588007b682f3e2aDianne Hackborn 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 895398341927f3dca68d71024483aa276d10af4c080Craig Mautner * Called following layout of all windows before each window has policy applied. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayWidth The current full width of the screen. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param displayHeight The current full height of the screen. 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 900398341927f3dca68d71024483aa276d10af4c080Craig Mautner public void beginPostLayoutPolicyLw(int displayWidth, int displayHeight); 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 903398341927f3dca68d71024483aa276d10af4c080Craig Mautner * Called following layout of all window to apply policy to each window. 9043ae0d3157d5fdeee851f3e72b80f4ed57add0ff8Wale Ogunwale * 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param win The window being positioned. 9063ae0d3157d5fdeee851f3e72b80f4ed57add0ff8Wale Ogunwale * @param attrs The LayoutParams of the window. 9073ae0d3157d5fdeee851f3e72b80f4ed57add0ff8Wale Ogunwale * @param attached For sub-windows, the window it is attached to. Otherwise null. 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 909398341927f3dca68d71024483aa276d10af4c080Craig Mautner public void applyPostLayoutPolicyLw(WindowState win, 9103ae0d3157d5fdeee851f3e72b80f4ed57add0ff8Wale Ogunwale WindowManager.LayoutParams attrs, WindowState attached); 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 913398341927f3dca68d71024483aa276d10af4c080Craig Mautner * Called following layout of all windows and after policy has been applied 914398341927f3dca68d71024483aa276d10af4c080Craig Mautner * to each window. If in this function you do 915398341927f3dca68d71024483aa276d10af4c080Craig Mautner * something that may have modified the animation state of another window, 916398341927f3dca68d71024483aa276d10af4c080Craig Mautner * be sure to return non-zero in order to perform another pass through layout. 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 918b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * @return Return any bit set of {@link #FINISH_LAYOUT_REDO_LAYOUT}, 919b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * {@link #FINISH_LAYOUT_REDO_CONFIG}, {@link #FINISH_LAYOUT_REDO_WALLPAPER}, 920b8b11a0b1d82e24f7a79f2e1672e7f5cf1611a55Dianne Hackborn * or {@link #FINISH_LAYOUT_REDO_ANIM}. 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 922398341927f3dca68d71024483aa276d10af4c080Craig Mautner public int finishPostLayoutPolicyLw(); 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 925de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * Return true if it is okay to perform animations for an app transition 926de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * that is about to occur. You may return false for this if, for example, 927de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * the lock screen is currently displayed so the switch should happen 928de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn * immediately. 929de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn */ 930de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn public boolean allowAppAnimationsLw(); 931664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 932664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato 933664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato /** 934664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato * A new window has been focused. 935664644d9e012aa2a28ac96f305b1ce6499ec8806Joe Onorato */ 936df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public int focusChangedLw(WindowState lastFocus, WindowState newFocus); 93736c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown 93836c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown /** 93936c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * Called when the device is waking up. 94036c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown */ 94136c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown public void wakingUp(); 94236c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown 943de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 944140ffc783c50bbe3b62e817c117a31b93e7f627eJeff Brown * Called when the device is going to sleep. 9459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param why {@link #OFF_BECAUSE_OF_USER} or 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #OFF_BECAUSE_OF_TIMEOUT}. 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949140ffc783c50bbe3b62e817c117a31b93e7f627eJeff Brown public void goingToSleep(int why); 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 95236c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * Called when the device is about to turn on the screen to show content. 95336c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * When waking up, this method will be called once after the call to wakingUp(). 95436c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * When dozing, the method will be called sometime after the call to goingToSleep() and 95536c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * may be called repeatedly in the case where the screen is pulsing on and off. 95636c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown * 95738e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn * Must call back on the listener to tell it when the higher-level system 95838e29a61d0c87fe3e391d24e2eb11dd1800d107dDianne Hackborn * is ready for the screen to go on (i.e. the lock screen is shown). 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 96036c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown public void screenTurningOn(ScreenOnListener screenOnListener); 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9623ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown /** 9633ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown * Called when the device has turned the screen off. 9643ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown */ 9653ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown public void screenTurnedOff(); 9663ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown 96736c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown public interface ScreenOnListener { 96836c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown void onScreenOn(); 96936c4db8bd3bd7dad4b6cb8abd9cdc1a627fe3bbcJeff Brown } 970bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn 971bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn /** 9723ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown * Return whether the default display is on and not blocked by a black surface. 973bc1aa7bbc753ebcd32da4507fa23215489b6d314Dianne Hackborn */ 9743ee549ca2404067bb8b2fcbaa741ec118c76bf3eJeff Brown public boolean isScreenOn(); 97500fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown 976de2606dcd36e9dfa49c42dbc68c539505d5ff8d4Dianne Hackborn /** 97700fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * Tell the policy that the lid switch has changed state. 97800fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param whenNanos The time when the change occurred in uptime nanoseconds. 97900fa7bdd69f0868fd17ea7c881c771d785b2fbbdJeff Brown * @param lidOpen True if the lid is now open. 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 98146b9ac0ae2162309774a7478cd9d4e578747bfc2Jeff Brown public void notifyLidSwitchChanged(long whenNanos, boolean lidOpen); 9823818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright 9833818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright /** 9843818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright * Tell the policy that the camera lens has been covered or uncovered. 9853818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright * @param whenNanos The time when the change occurred in uptime nanoseconds. 9863818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright * @param lensCovered True if the lens is covered. 9873818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright */ 9883818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright public void notifyCameraLensCoverSwitchChanged(long whenNanos, boolean lensCovered); 9893818c9261ceaa3a700ff984fbcd245faeede38d7Michael Wright 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting that keyguard not come on. 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled Whether keyguard can be on or not. does not actually 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * turn it on, unless it was previously disabled with this function. 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#disableKeyguard() 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager.KeyguardLock#reenableKeyguard() 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9993c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner @SuppressWarnings("javadoc") 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableKeyguard(boolean enabled); 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Callback used by {@link WindowManagerPolicy#exitKeyguardSecurely} 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project interface OnKeyguardExitResult { 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void onKeyguardExitResult(boolean success); 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the policy if anyone is requesting the keyguard to exit securely 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (this would be called after the keyguard was disabled) 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param callback Callback to send the result back. 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see android.app.KeyguardManager#exitKeyguardSecurely(android.app.KeyguardManager.OnKeyguardExitResult) 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10153c1743705c4df816089e07a17753c6043b4d8e66Craig Mautner @SuppressWarnings("javadoc") 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project void exitKeyguardSecurely(OnKeyguardExitResult callback); 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1019520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardLocked 1020520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 1021520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard is currently locked. 1022520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 1023520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is locked. 1024520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 1025520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardLocked(); 1026520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 1027520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 1028520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * isKeyguardSecure 1029520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 1030520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * Return whether the keyguard requires a password to unlock. 1031520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * 1032520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood * @return true if in keyguard is secure. 1033520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood */ 1034520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood public boolean isKeyguardSecure(); 1035520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood 1036520d8bc1d840966b5519195aaa514597a662c053Mike Lockwood /** 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * inKeyguardRestrictedKeyInputMode 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if keyguard screen is showing or in restricted key input mode (i.e. in 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * keyguard password emergency screen). When in such mode, certain keys, 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * such as the Home key and the right soft keys, don't work. 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 10439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if in keyguard restricted input mode. 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean inKeyguardRestrictedKeyInputMode(); 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 104890c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn * Ask the policy to dismiss the keyguard, if it is currently shown. 104990c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn */ 105090c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn public void dismissKeyguardLw(); 105190c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn 105290c52de28691ca0bbbf7c039ef20f85ce46882ccDianne Hackborn /** 10538de4311c51229efbe2f2d0afbf298982c5cadd96Jorim Jaggi * Notifies the keyguard that the activity has drawn it was waiting for. 10548de4311c51229efbe2f2d0afbf298982c5cadd96Jorim Jaggi */ 10558de4311c51229efbe2f2d0afbf298982c5cadd96Jorim Jaggi public void notifyActivityDrawnForKeyguardLw(); 10568de4311c51229efbe2f2d0afbf298982c5cadd96Jorim Jaggi 10578de4311c51229efbe2f2d0afbf298982c5cadd96Jorim Jaggi /** 1058cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi * Ask the policy whether the Keyguard has drawn. If the Keyguard is disabled, this method 1059cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi * returns true as soon as we know that Keyguard is disabled. 1060cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi * 1061cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi * @return true if the keyguard has drawn. 1062cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi */ 1063cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi public boolean isKeyguardDrawnLw(); 1064cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi 1065cff0acb6b1eea23c3f44a078a0a5e81c11faea35Jorim Jaggi /** 106601a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * Given an orientation constant, returns the appropriate surface rotation, 106701a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * taking into account sensors, docking mode, rotation lock, and other factors. 106801a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * 106901a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param orientation An orientation constant, such as 107001a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. 107101a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param lastRotation The most recently used rotation. 107201a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @return The surface rotation to use. 10739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1074d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public int rotationForOrientationLw(@ActivityInfo.ScreenOrientation int orientation, 1075d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye int lastRotation); 107601a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 107801a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * Given an orientation constant and a rotation, returns true if the rotation 107901a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * has compatible metrics to the requested orientation. For example, if 108001a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * the application requested landscape and got seascape, then the rotation 108101a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * has compatible metrics; if the application requested portrait and got landscape, 108201a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * then the rotation has incompatible metrics; if the application did not specify 108301a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * a preference, then anything goes. 108401a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * 108501a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param orientation An orientation constant, such as 108601a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * {@link android.content.pm.ActivityInfo#SCREEN_ORIENTATION_LANDSCAPE}. 108701a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @param rotation The rotation to check. 108801a98ddbdfbaf1f0d2bc602537e6e314364902a3Jeff Brown * @return True if the rotation is compatible with the requested orientation. 1089dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn */ 1090d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public boolean rotationHasCompatibleMetricsLw(@ActivityInfo.ScreenOrientation int orientation, 1091d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye int rotation); 1092dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn 1093dacea8ce503369e7b82ff1c0e1a5a8a48863a25aDianne Hackborn /** 1094c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * Called by the window manager when the rotation changes. 1095c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * 1096c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown * @param rotation The new rotation. 1097c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown */ 1098c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown public void setRotationLw(int rotation); 1099c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown 1100c0347aa19f354a8e1ff4fcd5372b134c0c7c16adJeff Brown /** 1101ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown * Called when the system is mostly done booting to set whether 11029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the system should go into safe mode. 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1104ac14351e16e1258f1cb54e2bf772b8be004eb2b8Jeff Brown public void setSafeMode(boolean safeMode); 11059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when the system is mostly done booting. 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void systemReady(); 11109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1112ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn * Called when the system is done booting to the point where the 1113ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn * user can start interacting with it. 1114ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn */ 1115ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn public void systemBooted(); 1116ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn 1117ba24e4d8bbeb60e96d74f05e21691dad61ce497eDianne Hackborn /** 1118661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn * Show boot time message to the user. 1119661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn */ 1120661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn public void showBootMessage(final CharSequence msg, final boolean always); 1121661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn 1122661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn /** 1123661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn * Hide the UI for showing boot messages, never to be displayed again. 1124661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn */ 1125661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn public void hideBootMessages(); 1126661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn 1127661cd52e0e1d527132eb1cae604d3e64da7ec0cbDianne Hackborn /** 1128ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * Called when userActivity is signalled in the power manager. 1129ef73162887943e16587b8e737b19e59348338e8cMike Lockwood * This is safe to call from any thread, with any window manager locks held or not. 1130ef73162887943e16587b8e737b19e59348338e8cMike Lockwood */ 1131ef73162887943e16587b8e737b19e59348338e8cMike Lockwood public void userActivity(); 1132ef73162887943e16587b8e737b19e59348338e8cMike Lockwood 1133ef73162887943e16587b8e737b19e59348338e8cMike Lockwood /** 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Called when we have finished booting and can now display the home 1135c042ee2acd8529b95c5dc99240d626e61d2500cdJeff Brown * screen to the user. This will happen after systemReady(), and at 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * this point the display is active. 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void enableScreenAfterBoot(); 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1140d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public void setCurrentOrientationLw(@ActivityInfo.ScreenOrientation int newOrientation); 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call from application to perform haptic feedback on its window. 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1145c39a6e0c51e182338deb8b63d07933b585134929The Android Open Source Project public boolean performHapticFeedbackLw(WindowState win, int effectId, boolean always); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11480601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * Called when we have started keeping the screen on because a window 11490601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * requesting this has become visible. 11500601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler */ 1151c38c9be031ddad5cf551b55458889f11e01dc5b2Jeff Brown public void keepScreenOnStartedLw(); 11520601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler 11530601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler /** 11540601eb7953cbf77d92826bef3ca37e208d922de7Daniel Sandler * Called when we have stopped keeping the screen on because the last window 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * requesting this is no longer visible. 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1157c38c9be031ddad5cf551b55458889f11e01dc5b2Jeff Brown public void keepScreenOnStoppedLw(); 1158b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler 1159b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler /** 116080943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * Gets the current user rotation mode. 116180943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * 116280943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * @return The rotation mode. 116380943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * 116480943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * @see WindowManagerPolicy#USER_ROTATION_LOCKED 116580943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov * @see WindowManagerPolicy#USER_ROTATION_FREE 116680943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov */ 1167d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye @UserRotationMode 116880943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov public int getUserRotationMode(); 116980943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov 117080943d8daa6ab31ab5c486d57aea406aa0730d58Svetoslav Ganov /** 1171b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * Inform the policy that the user has chosen a preferred orientation ("rotation lock"). 1172b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * 1173b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param mode One of {@link WindowManagerPolicy#USER_ROTATION_LOCKED} or 117469b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner * {@link WindowManagerPolicy#USER_ROTATION_FREE}. 1175b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler * @param rotation One of {@link Surface#ROTATION_0}, {@link Surface#ROTATION_90}, 117669b0818179201fadc9d2a384d692d8ae4aecd85cCraig Mautner * {@link Surface#ROTATION_180}, {@link Surface#ROTATION_270}. 1177b73617de462579f7c12c25a4c2747c576f00f6a2Daniel Sandler */ 1178d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye public void setUserRotationMode(@UserRotationMode int mode, @Surface.Rotation int rotation); 1179f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn 1180f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn /** 1181df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * Called when a new system UI visibility is being reported, allowing 1182df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * the policy to adjust what is actually reported. 1183d9273d6f289d9b55da3fd0db2f659fdfb48106a8Tor Norbye * @param visibility The raw visibility reported by the status bar. 1184df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn * @return The new desired visibility. 1185df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn */ 1186df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn public int adjustSystemUiVisibilityLw(int visibility); 1187df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn 1188df89e65bf0fcc651d20b208c8d8d0b848fb43418Dianne Hackborn /** 11890c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler * Specifies whether there is an on-screen navigation bar separate from the status bar. 11900c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler */ 11910c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler public boolean hasNavigationBar(); 11920c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler 11930c4ccff36930ff4f0292b94ad51e164c9fa060a3Daniel Sandler /** 119493c518e4f8abd98f87cda1712b30a5a86cfa60ddJim Miller * Lock the device now. 119593c518e4f8abd98f87cda1712b30a5a86cfa60ddJim Miller */ 1196f752202bee88e31ce765483ba2efa6999ae9c9adAdam Cohen public void lockNow(Bundle options); 119793c518e4f8abd98f87cda1712b30a5a86cfa60ddJim Miller 119893c518e4f8abd98f87cda1712b30a5a86cfa60ddJim Miller /** 11991bc0a49e3cade697201e454bb6e46ee789cef6e4satok * Set the last used input method window state. This state is used to make IME transition 12001bc0a49e3cade697201e454bb6e46ee789cef6e4satok * smooth. 12011bc0a49e3cade697201e454bb6e46ee789cef6e4satok * @hide 12021bc0a49e3cade697201e454bb6e46ee789cef6e4satok */ 12031bc0a49e3cade697201e454bb6e46ee789cef6e4satok public void setLastInputMethodWindowLw(WindowState ime, WindowState target); 12041bc0a49e3cade697201e454bb6e46ee789cef6e4satok 12051bc0a49e3cade697201e454bb6e46ee789cef6e4satok /** 120684984faf530e525b066e28710d0f9beb32142ec5Craig Mautner * Show the recents task list app. 120784984faf530e525b066e28710d0f9beb32142ec5Craig Mautner * @hide 120884984faf530e525b066e28710d0f9beb32142ec5Craig Mautner */ 120984984faf530e525b066e28710d0f9beb32142ec5Craig Mautner public void showRecentApps(); 121084984faf530e525b066e28710d0f9beb32142ec5Craig Mautner 121184984faf530e525b066e28710d0f9beb32142ec5Craig Mautner /** 1212e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette * Show the global actions dialog. 1213e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette * @hide 1214e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette */ 1215e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette public void showGlobalActions(); 1216e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette 1217e34560b21989eea54a139a0586d156ba573cc2eaAlan Viverette /** 1218658c7b896a751b971db1292d86655dbb97f00067Satoshi Kataoka * @return The current height of the input method window. 1219658c7b896a751b971db1292d86655dbb97f00067Satoshi Kataoka */ 1220658c7b896a751b971db1292d86655dbb97f00067Satoshi Kataoka public int getInputMethodWindowVisibleHeightLw(); 1221658c7b896a751b971db1292d86655dbb97f00067Satoshi Kataoka 1222658c7b896a751b971db1292d86655dbb97f00067Satoshi Kataoka /** 1223f1b674197577e815040cd75ef86d611965d603adCraig Mautner * Called when the current user changes. Guaranteed to be called before the broadcast 1224f1b674197577e815040cd75ef86d611965d603adCraig Mautner * of the new user id is made to all listeners. 1225f1b674197577e815040cd75ef86d611965d603adCraig Mautner * 1226f1b674197577e815040cd75ef86d611965d603adCraig Mautner * @param newUserId The id of the incoming user. 1227f1b674197577e815040cd75ef86d611965d603adCraig Mautner */ 1228f1b674197577e815040cd75ef86d611965d603adCraig Mautner public void setCurrentUserLw(int newUserId); 12291cf70bbf96930662cab0e699d70b62865766ff52Svetoslav Ganov 12301cf70bbf96930662cab0e699d70b62865766ff52Svetoslav Ganov /** 1231f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * Print the WindowManagerPolicy's state into the given stream. 1232f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * 1233f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param prefix Text to print at the front of each line. 1234f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param writer The PrintWriter to which you should dump your state. This will be 1235f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * closed for you after you return. 1236f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn * @param args additional arguments to the dump request. 1237f99f9c5f92dbcdf5f6e9c93847a5dae4c35a817eDianne Hackborn */ 1238d7a04de16798acc04ec0a89a0c7d9f1cf60d1521Jeff Brown public void dump(String prefix, PrintWriter writer, String[] args); 12394eeb4f664ac6b5901a8e874dcf70c0382295f792Jim Miller 12404eeb4f664ac6b5901a8e874dcf70c0382295f792Jim Miller /** 1241545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * Returns whether a given window type can be magnified. 1242545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * 1243545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * @param windowType The window type. 1244545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * @return True if the window can be magnified. 1245545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov */ 1246545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov public boolean canMagnifyWindow(int windowType); 1247545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov 1248545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov /** 1249545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * Returns whether a given window type is considered a top level one. 1250545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * A top level window does not have a container, i.e. attached window, 1251545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * or if it has a container it is laid out as a top-level window, not 1252545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * as a child of its container. 1253545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * 1254545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * @param windowType The window type. 1255545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov * @return True if the window is a top level one. 1256545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov */ 1257545252f4fde6fbb70b07e97a120c7d1405758017Svetoslav Ganov public boolean isTopLevelWindow(int windowType); 12580d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi 12590d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi /** 12600d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi * Notifies the keyguard to start fading out. 1261e29b2dbc762bfa66093d76f5a65f55328d8753c9Jorim Jaggi * 1262e29b2dbc762bfa66093d76f5a65f55328d8753c9Jorim Jaggi * @param startTime the start time of the animation in uptime milliseconds 1263e29b2dbc762bfa66093d76f5a65f55328d8753c9Jorim Jaggi * @param fadeoutDuration the duration of the exit animation, in milliseconds 12640d674623facfbd3e9c520d2be4ed98977b92a1a2Jorim Jaggi */ 1265e29b2dbc762bfa66093d76f5a65f55328d8753c9Jorim Jaggi public void startKeyguardExitAnimation(long startTime, long fadeoutDuration); 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1267