IWindowManager.aidl revision 9266c558bf1d21ff647525ff99f7dadbca417309 
1/* //device/java/android/android/view/IWindowManager.aidl
2**
3** Copyright 2006, The Android Open Source Project
4**
5** Licensed under the Apache License, Version 2.0 (the "License");
6** you may not use this file except in compliance with the License.
7** You may obtain a copy of the License at
8**
9**     http://www.apache.org/licenses/LICENSE-2.0
10**
11** Unless required by applicable law or agreed to in writing, software
12** distributed under the License is distributed on an "AS IS" BASIS,
13** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14** See the License for the specific language governing permissions and
15** limitations under the License.
16*/
17
18package android.view;
19
20import com.android.internal.view.IInputContext;
21import com.android.internal.view.IInputMethodClient;
22
23import android.content.res.Configuration;
24import android.view.IApplicationToken;
25import android.view.IOnKeyguardExitResult;
26import android.view.IRotationWatcher;
27import android.view.IWindowSession;
28import android.view.KeyEvent;
29import android.view.MotionEvent;
30
31/**
32 * System private interface to the window manager.
33 *
34 * {@hide}
35 */
36interface IWindowManager
37{
38    /**
39     * ===== NOTICE =====
40     * The first three methods must remain the first three methods. Scripts
41     * and tools rely on their transaction number to work properly.
42     */
43    // This is used for debugging
44    boolean startViewServer(int port);   // Transaction #1
45    boolean stopViewServer();            // Transaction #2
46    boolean isViewServerRunning();       // Transaction #3
47
48    IWindowSession openSession(in IInputMethodClient client,
49            in IInputContext inputContext);
50    boolean inputMethodClientHasFocus(IInputMethodClient client);
51
52    // These can only be called when injecting events to your own window,
53    // or by holding the INJECT_EVENTS permission.
54    boolean injectKeyEvent(in KeyEvent ev, boolean sync);
55    boolean injectPointerEvent(in MotionEvent ev, boolean sync);
56    boolean injectTrackballEvent(in MotionEvent ev, boolean sync);
57
58    // These can only be called when holding the MANAGE_APP_TOKENS permission.
59    void pauseKeyDispatching(IBinder token);
60    void resumeKeyDispatching(IBinder token);
61    void setEventDispatching(boolean enabled);
62    void addAppToken(int addPos, IApplicationToken token,
63            int groupId, int requestedOrientation, boolean fullscreen);
64    void setAppGroupId(IBinder token, int groupId);
65    Configuration updateOrientationFromAppTokens(IBinder freezeThisOneIfNeeded);
66    void setAppOrientation(IApplicationToken token, int requestedOrientation);
67    int getAppOrientation(IApplicationToken token);
68    void setFocusedApp(IBinder token, boolean moveFocusNow);
69    void prepareAppTransition(int transit);
70    int getPendingAppTransition();
71    void executeAppTransition();
72    void setAppStartingWindow(IBinder token, String pkg, int theme,
73            CharSequence nonLocalizedLabel, int labelRes,
74            int icon, IBinder transferFrom, boolean createIfNeeded);
75    void setAppWillBeHidden(IBinder token);
76    void setAppVisibility(IBinder token, boolean visible);
77    void startAppFreezingScreen(IBinder token, int configChanges);
78    void stopAppFreezingScreen(IBinder token, boolean force);
79    void removeAppToken(IBinder token);
80    void moveAppToken(int index, IBinder token);
81    void moveAppTokensToTop(in List<IBinder> tokens);
82    void moveAppTokensToBottom(in List<IBinder> tokens);
83    void addWindowToken(IBinder token, int type);
84    void removeWindowToken(IBinder token);
85
86    // these require DISABLE_KEYGUARD permission
87    void disableKeyguard(IBinder token, String tag);
88    void reenableKeyguard(IBinder token);
89    void exitKeyguardSecurely(IOnKeyguardExitResult callback);
90    boolean inKeyguardRestrictedInputMode();
91
92
93    // These can only be called with the SET_ANIMATON_SCALE permission.
94    float getAnimationScale(int which);
95    float[] getAnimationScales();
96    void setAnimationScale(int which, float scale);
97    void setAnimationScales(in float[] scales);
98
99    // These require the READ_INPUT_STATE permission.
100    int getSwitchState(int sw);
101    int getSwitchStateForDevice(int devid, int sw);
102    int getScancodeState(int sw);
103    int getScancodeStateForDevice(int devid, int sw);
104    int getKeycodeState(int sw);
105    int getKeycodeStateForDevice(int devid, int sw);
106
107    // For testing
108    void setInTouchMode(boolean showFocus);
109
110    // These can only be called with the SET_ORIENTATION permission.
111    /**
112     * Change the current screen rotation, constants as per
113     * {@link android.view.Surface}.
114     * @param rotation the intended rotation.
115     * @param alwaysSendConfiguration Flag to force a new configuration to
116     * be evaluated.  This can be used when there are other parameters in
117     * configuration that are changing.
118     * {@link android.view.Surface}.
119     */
120    void setRotation(int rotation, boolean alwaysSendConfiguration);
121
122    /**
123     * Retrieve the current screen orientation, constants as per
124     * {@link android.view.Surface}.
125     */
126    int getRotation();
127
128    /**
129     * Watch the rotation of the screen.  Returns the current rotation,
130     * calls back when it changes.
131     */
132    int watchRotation(IRotationWatcher watcher);
133}
134