blob: 7bd3af796e4ff923f0e66bab7f9186fa6135151b [file] [log] [blame]
Jeff Brown928e0542011-01-10 11:17:36 -08001/*
2 * Copyright (C) 2011 The Android Open Source Project
3 *
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.apache.org/licenses/LICENSE-2.0
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16
17#ifndef _UI_INPUT_WINDOW_H
18#define _UI_INPUT_WINDOW_H
19
Mathias Agopianb93a03f82012-02-17 15:34:57 -080020#include <androidfw/Input.h>
21#include <androidfw/InputTransport.h>
Jeff Brown928e0542011-01-10 11:17:36 -080022#include <utils/RefBase.h>
23#include <utils/Timers.h>
24#include <utils/String8.h>
25
Jeff Brownfbf09772011-01-16 14:06:57 -080026#include <SkRegion.h>
27
Jeff Brown928e0542011-01-10 11:17:36 -080028#include "InputApplication.h"
29
30namespace android {
31
32/*
Jeff Browncc4f7db2011-08-30 20:34:48 -070033 * Describes the properties of a window that can receive input.
Jeff Brown928e0542011-01-10 11:17:36 -080034 */
Jeff Browncc4f7db2011-08-30 20:34:48 -070035struct InputWindowInfo {
Jeff Brown928e0542011-01-10 11:17:36 -080036 // Window flags from WindowManager.LayoutParams
37 enum {
38 FLAG_ALLOW_LOCK_WHILE_SCREEN_ON = 0x00000001,
39 FLAG_DIM_BEHIND = 0x00000002,
40 FLAG_BLUR_BEHIND = 0x00000004,
41 FLAG_NOT_FOCUSABLE = 0x00000008,
42 FLAG_NOT_TOUCHABLE = 0x00000010,
43 FLAG_NOT_TOUCH_MODAL = 0x00000020,
44 FLAG_TOUCHABLE_WHEN_WAKING = 0x00000040,
45 FLAG_KEEP_SCREEN_ON = 0x00000080,
46 FLAG_LAYOUT_IN_SCREEN = 0x00000100,
47 FLAG_LAYOUT_NO_LIMITS = 0x00000200,
48 FLAG_FULLSCREEN = 0x00000400,
49 FLAG_FORCE_NOT_FULLSCREEN = 0x00000800,
50 FLAG_DITHER = 0x00001000,
51 FLAG_SECURE = 0x00002000,
52 FLAG_SCALED = 0x00004000,
53 FLAG_IGNORE_CHEEK_PRESSES = 0x00008000,
54 FLAG_LAYOUT_INSET_DECOR = 0x00010000,
55 FLAG_ALT_FOCUSABLE_IM = 0x00020000,
56 FLAG_WATCH_OUTSIDE_TOUCH = 0x00040000,
57 FLAG_SHOW_WHEN_LOCKED = 0x00080000,
58 FLAG_SHOW_WALLPAPER = 0x00100000,
59 FLAG_TURN_SCREEN_ON = 0x00200000,
60 FLAG_DISMISS_KEYGUARD = 0x00400000,
61 FLAG_SPLIT_TOUCH = 0x00800000,
Jeff Brown98db5fa2011-06-08 15:37:10 -070062 FLAG_HARDWARE_ACCELERATED = 0x01000000,
63 FLAG_HARDWARE_ACCELERATED_SYSTEM = 0x02000000,
64 FLAG_SLIPPERY = 0x04000000,
65 FLAG_NEEDS_MENU_KEY = 0x08000000,
Jeff Brown928e0542011-01-10 11:17:36 -080066 FLAG_KEEP_SURFACE_WHILE_ANIMATING = 0x10000000,
67 FLAG_COMPATIBLE_WINDOW = 0x20000000,
68 FLAG_SYSTEM_ERROR = 0x40000000,
69 };
70
71 // Window types from WindowManager.LayoutParams
72 enum {
73 FIRST_APPLICATION_WINDOW = 1,
74 TYPE_BASE_APPLICATION = 1,
75 TYPE_APPLICATION = 2,
76 TYPE_APPLICATION_STARTING = 3,
77 LAST_APPLICATION_WINDOW = 99,
78 FIRST_SUB_WINDOW = 1000,
79 TYPE_APPLICATION_PANEL = FIRST_SUB_WINDOW,
80 TYPE_APPLICATION_MEDIA = FIRST_SUB_WINDOW+1,
81 TYPE_APPLICATION_SUB_PANEL = FIRST_SUB_WINDOW+2,
82 TYPE_APPLICATION_ATTACHED_DIALOG = FIRST_SUB_WINDOW+3,
83 TYPE_APPLICATION_MEDIA_OVERLAY = FIRST_SUB_WINDOW+4,
84 LAST_SUB_WINDOW = 1999,
85 FIRST_SYSTEM_WINDOW = 2000,
86 TYPE_STATUS_BAR = FIRST_SYSTEM_WINDOW,
87 TYPE_SEARCH_BAR = FIRST_SYSTEM_WINDOW+1,
88 TYPE_PHONE = FIRST_SYSTEM_WINDOW+2,
89 TYPE_SYSTEM_ALERT = FIRST_SYSTEM_WINDOW+3,
90 TYPE_KEYGUARD = FIRST_SYSTEM_WINDOW+4,
91 TYPE_TOAST = FIRST_SYSTEM_WINDOW+5,
92 TYPE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW+6,
93 TYPE_PRIORITY_PHONE = FIRST_SYSTEM_WINDOW+7,
94 TYPE_SYSTEM_DIALOG = FIRST_SYSTEM_WINDOW+8,
95 TYPE_KEYGUARD_DIALOG = FIRST_SYSTEM_WINDOW+9,
96 TYPE_SYSTEM_ERROR = FIRST_SYSTEM_WINDOW+10,
97 TYPE_INPUT_METHOD = FIRST_SYSTEM_WINDOW+11,
98 TYPE_INPUT_METHOD_DIALOG= FIRST_SYSTEM_WINDOW+12,
99 TYPE_WALLPAPER = FIRST_SYSTEM_WINDOW+13,
Daniel Sandler6d8a98a2011-04-27 14:07:12 -0400100 TYPE_STATUS_BAR_PANEL = FIRST_SYSTEM_WINDOW+14,
Jeff Brown928e0542011-01-10 11:17:36 -0800101 TYPE_SECURE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW+15,
102 TYPE_DRAG = FIRST_SYSTEM_WINDOW+16,
Daniel Sandler6d8a98a2011-04-27 14:07:12 -0400103 TYPE_STATUS_BAR_SUB_PANEL = FIRST_SYSTEM_WINDOW+17,
104 TYPE_POINTER = FIRST_SYSTEM_WINDOW+18,
Daniel Sandler8956dbb2011-04-22 07:55:02 -0400105 TYPE_NAVIGATION_BAR = FIRST_SYSTEM_WINDOW+19,
Jeff Brownbfcb60a2011-09-08 18:51:14 -0700106 TYPE_VOLUME_OVERLAY = FIRST_SYSTEM_WINDOW+20,
107 TYPE_BOOT_PROGRESS = FIRST_SYSTEM_WINDOW+21,
Jeff Brown928e0542011-01-10 11:17:36 -0800108 LAST_SYSTEM_WINDOW = 2999,
109 };
110
Jeff Brown474dcb52011-06-14 20:22:50 -0700111 enum {
112 INPUT_FEATURE_DISABLE_TOUCH_PAD_GESTURES = 0x00000001,
Jeff Brown1e3b98d2012-09-30 18:58:59 -0700113 INPUT_FEATURE_NO_INPUT_CHANNEL = 0x00000002,
114 INPUT_FEATURE_DISABLE_USER_ACTIVITY = 0x00000004,
Jeff Brown474dcb52011-06-14 20:22:50 -0700115 };
116
Jeff Brown928e0542011-01-10 11:17:36 -0800117 sp<InputChannel> inputChannel;
118 String8 name;
119 int32_t layoutParamsFlags;
120 int32_t layoutParamsType;
121 nsecs_t dispatchingTimeout;
122 int32_t frameLeft;
123 int32_t frameTop;
124 int32_t frameRight;
125 int32_t frameBottom;
Dianne Hackborne2515ee2011-04-27 18:52:56 -0400126 float scaleFactor;
Jeff Brownfbf09772011-01-16 14:06:57 -0800127 SkRegion touchableRegion;
Jeff Brown928e0542011-01-10 11:17:36 -0800128 bool visible;
129 bool canReceiveKeys;
130 bool hasFocus;
131 bool hasWallpaper;
132 bool paused;
133 int32_t layer;
134 int32_t ownerPid;
135 int32_t ownerUid;
Jeff Brown474dcb52011-06-14 20:22:50 -0700136 int32_t inputFeatures;
Jeff Brown83d616a2012-09-09 20:33:43 -0700137 int32_t displayId;
Jeff Brown928e0542011-01-10 11:17:36 -0800138
Jeff Brownfbf09772011-01-16 14:06:57 -0800139 bool touchableRegionContainsPoint(int32_t x, int32_t y) const;
Jeff Brown928e0542011-01-10 11:17:36 -0800140 bool frameContainsPoint(int32_t x, int32_t y) const;
141
Jeff Brown928e0542011-01-10 11:17:36 -0800142 /* Returns true if the window is of a trusted type that is allowed to silently
143 * overlay other windows for the purpose of implementing the secure views feature.
144 * Trusted overlays, such as IME windows, can partly obscure other windows without causing
145 * motion events to be delivered to them with AMOTION_EVENT_FLAG_WINDOW_IS_OBSCURED.
146 */
147 bool isTrustedOverlay() const;
148
149 bool supportsSplitTouch() const;
Jeff Browncc4f7db2011-08-30 20:34:48 -0700150};
151
152
153/*
154 * Handle for a window that can receive input.
155 *
156 * Used by the native input dispatcher to indirectly refer to the window manager objects
157 * that describe a window.
158 */
159class InputWindowHandle : public RefBase {
160public:
161 const sp<InputApplicationHandle> inputApplicationHandle;
162
163 inline const InputWindowInfo* getInfo() const {
164 return mInfo;
165 }
166
167 inline sp<InputChannel> getInputChannel() const {
168 return mInfo ? mInfo->inputChannel : NULL;
169 }
170
171 inline String8 getName() const {
172 return mInfo ? mInfo->name : String8("<invalid>");
173 }
174
175 inline nsecs_t getDispatchingTimeout(nsecs_t defaultValue) const {
176 return mInfo ? mInfo->dispatchingTimeout : defaultValue;
177 }
Jeff Brown9302c872011-07-13 22:51:29 -0700178
179 /**
180 * Requests that the state of this object be updated to reflect
181 * the most current available information about the application.
182 *
183 * This method should only be called from within the input dispatcher's
184 * critical section.
185 *
186 * Returns true on success, or false if the handle is no longer valid.
187 */
Jeff Browncc4f7db2011-08-30 20:34:48 -0700188 virtual bool updateInfo() = 0;
189
190 /**
191 * Releases the storage used by the associated information when it is
192 * no longer needed.
193 */
194 void releaseInfo();
Jeff Brown9302c872011-07-13 22:51:29 -0700195
196protected:
Jeff Browncc4f7db2011-08-30 20:34:48 -0700197 InputWindowHandle(const sp<InputApplicationHandle>& inputApplicationHandle);
198 virtual ~InputWindowHandle();
199
200 InputWindowInfo* mInfo;
Jeff Brown928e0542011-01-10 11:17:36 -0800201};
202
203} // namespace android
204
205#endif // _UI_INPUT_WINDOW_H