| |
1 /* |
| |
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 |
| |
20 #include "Input.h" |
| |
21 #include "InputTransport.h" |
| |
22 #include <utils/RefBase.h> |
| |
23 #include <utils/Timers.h> |
| |
24 #include <utils/String8.h> |
| |
25 |
| |
26 #include <SkRegion.h> |
| |
27 |
| |
28 #include "InputApplication.h" |
| |
29 |
| |
30 namespace android { |
| |
31 |
| |
32 /* |
| |
33 * Describes the properties of a window that can receive input. |
| |
34 */ |
| |
35 struct InputWindowInfo { |
| |
36 // 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, |
| |
62 FLAG_HARDWARE_ACCELERATED = 0x01000000, |
| |
63 FLAG_HARDWARE_ACCELERATED_SYSTEM = 0x02000000, |
| |
64 FLAG_SLIPPERY = 0x04000000, |
| |
65 FLAG_NEEDS_MENU_KEY = 0x08000000, |
| |
66 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, |
| |
100 TYPE_STATUS_BAR_PANEL = FIRST_SYSTEM_WINDOW+14, |
| |
101 TYPE_SECURE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW+15, |
| |
102 TYPE_DRAG = FIRST_SYSTEM_WINDOW+16, |
| |
103 TYPE_STATUS_BAR_SUB_PANEL = FIRST_SYSTEM_WINDOW+17, |
| |
104 TYPE_POINTER = FIRST_SYSTEM_WINDOW+18, |
| |
105 TYPE_NAVIGATION_BAR = FIRST_SYSTEM_WINDOW+19, |
| |
106 TYPE_VOLUME_OVERLAY = FIRST_SYSTEM_WINDOW+20, |
| |
107 TYPE_BOOT_PROGRESS = FIRST_SYSTEM_WINDOW+21, |
| |
108 LAST_SYSTEM_WINDOW = 2999, |
| |
109 }; |
| |
110 |
| |
111 enum { |
| |
112 INPUT_FEATURE_DISABLE_TOUCH_PAD_GESTURES = 0x00000001, |
| |
113 INPUT_FEATURE_NO_INPUT_CHANNEL = 0x00000002, |
| |
114 INPUT_FEATURE_DISABLE_USER_ACTIVITY = 0x00000004, |
| |
115 }; |
| |
116 |
| |
117 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; |
| |
126 float scaleFactor; |
| |
127 SkRegion touchableRegion; |
| |
128 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; |
| |
136 int32_t inputFeatures; |
| |
137 int32_t displayId; |
| |
138 |
| |
139 bool touchableRegionContainsPoint(int32_t x, int32_t y) const; |
| |
140 bool frameContainsPoint(int32_t x, int32_t y) const; |
| |
141 |
| |
142 /* 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; |
| |
150 }; |
| |
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 */ |
| |
159 class InputWindowHandle : public RefBase { |
| |
160 public: |
| |
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 } |
| |
178 |
| |
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 */ |
| |
188 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(); |
| |
195 |
| |
196 protected: |
| |
197 InputWindowHandle(const sp<InputApplicationHandle>& inputApplicationHandle); |
| |
198 virtual ~InputWindowHandle(); |
| |
199 |
| |
200 InputWindowInfo* mInfo; |
| |
201 }; |
| |
202 |
| |
203 } // namespace android |
| |
204 |
| |
205 #endif // _UI_INPUT_WINDOW_H |