1 /* //device/java/android/android/view/IWindowSession.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 18 package android.view; 19 20 import android.content.res.Configuration; 21 import android.graphics.Rect; 22 import android.graphics.Region; 23 import android.os.Bundle; 24 import android.view.IWindow; 25 import android.view.MotionEvent; 26 import android.view.WindowManager; 27 import android.view.Surface; 28 29 /** 30 * System private per-application interface to the window manager. 31 * 32 * {@hide} 33 */ 34 interface IWindowSession { 35 int add(IWindow window, in WindowManager.LayoutParams attrs, 36 in int viewVisibility, out Rect outContentInsets); 37 void remove(IWindow window); 38 39 /** 40 * Change the parameters of a window. You supply the 41 * new parameters, it returns the new frame of the window on screen (the 42 * position should be ignored) and surface of the window. The surface 43 * will be invalid if the window is currently hidden, else you can use it 44 * to draw the window's contents. 45 * 46 * @param window The window being modified. 47 * @param attrs If non-null, new attributes to apply to the window. 48 * @param requestedWidth The width the window wants to be. 49 * @param requestedHeight The height the window wants to be. 50 * @param viewVisibility Window root view's visibility. 51 * @param insetsPending Set to true if the client will be later giving 52 * internal insets; as a result, the window will not impact other window 53 * layouts until the insets are given. 54 * @param outFrame Rect in which is placed the new position/size on 55 * screen. 56 * @param outContentInsets Rect in which is placed the offsets from 57 * <var>outFrame</var> in which the content of the window should be 58 * placed. This can be used to modify the window layout to ensure its 59 * contents are visible to the user, taking into account system windows 60 * like the status bar or a soft keyboard. 61 * @param outVisibleInsets Rect in which is placed the offsets from 62 * <var>outFrame</var> in which the window is actually completely visible 63 * to the user. This can be used to temporarily scroll the window's 64 * contents to make sure the user can see it. This is different than 65 * <var>outContentInsets</var> in that these insets change transiently, 66 * so complex relayout of the window should not happen based on them. 67 * @param outConfiguration New configuration of window, if it is now 68 * becoming visible and the global configuration has changed since it 69 * was last displayed. 70 * @param outSurface Object in which is placed the new display surface. 71 * 72 * @return int Result flags: {@link WindowManagerImpl#RELAYOUT_SHOW_FOCUS}, 73 * {@link WindowManagerImpl#RELAYOUT_FIRST_TIME}. 74 */ 75 int relayout(IWindow window, in WindowManager.LayoutParams attrs, 76 int requestedWidth, int requestedHeight, int viewVisibility, 77 boolean insetsPending, out Rect outFrame, out Rect outContentInsets, 78 out Rect outVisibleInsets, out Configuration outConfig, 79 out Surface outSurface); 80 81 /** 82 * Give the window manager a hint of the part of the window that is 83 * completely transparent, allowing it to work with the surface flinger 84 * to optimize compositing of this part of the window. 85 */ 86 void setTransparentRegion(IWindow window, in Region region); 87 88 /** 89 * Tell the window manager about the content and visible insets of the 90 * given window, which can be used to adjust the <var>outContentInsets</var> 91 * and <var>outVisibleInsets</var> values returned by 92 * {@link #relayout relayout()} for windows behind this one. 93 * 94 * @param touchableInsets Controls which part of the window inside of its 95 * frame can receive pointer events, as defined by 96 * {@link android.view.ViewTreeObserver.InternalInsetsInfo}. 97 */ 98 void setInsets(IWindow window, int touchableInsets, in Rect contentInsets, 99 in Rect visibleInsets); 100 101 /** 102 * Return the current display size in which the window is being laid out, 103 * accounting for screen decorations around it. 104 */ 105 void getDisplayFrame(IWindow window, out Rect outDisplayFrame); 106 107 void finishDrawing(IWindow window); 108 109 void finishKey(IWindow window); 110 MotionEvent getPendingPointerMove(IWindow window); 111 MotionEvent getPendingTrackballMove(IWindow window); 112 113 void setInTouchMode(boolean showFocus); 114 boolean getInTouchMode(); 115 116 boolean performHapticFeedback(IWindow window, int effectId, boolean always); 117 118 /** 119 * For windows with the wallpaper behind them, and the wallpaper is 120 * larger than the screen, set the offset within the screen. 121 * For multi screen launcher type applications, xstep and ystep indicate 122 * how big the increment is from one screen to another. 123 */ 124 void setWallpaperPosition(IBinder windowToken, float x, float y, float xstep, float ystep); 125 126 void wallpaperOffsetsComplete(IBinder window); 127 128 Bundle sendWallpaperCommand(IBinder window, String action, int x, int y, 129 int z, in Bundle extras, boolean sync); 130 131 void wallpaperCommandComplete(IBinder window, in Bundle result); 132 } 133
