| /* //device/java/android/android/view/IWindowSession.aidl |
| ** |
| ** Copyright 2006, The Android Open Source Project |
| ** |
| ** Licensed under the Apache License, Version 2.0 (the "License"); |
| ** you may not use this file except in compliance with the License. |
| ** You may obtain a copy of the License at |
| ** |
| ** http://www.apache.org/licenses/LICENSE-2.0 |
| ** |
| ** Unless required by applicable law or agreed to in writing, software |
| ** distributed under the License is distributed on an "AS IS" BASIS, |
| ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| ** See the License for the specific language governing permissions and |
| ** limitations under the License. |
| */ |
| |
| package android.view; |
| |
| import android.content.ClipData; |
| import android.content.res.Configuration; |
| import android.graphics.Rect; |
| import android.graphics.Region; |
| import android.os.Bundle; |
| import android.view.InputChannel; |
| import android.view.IWindow; |
| import android.view.MotionEvent; |
| import android.view.WindowManager; |
| import android.view.Surface; |
| |
| /** |
| * System private per-application interface to the window manager. |
| * |
| * {@hide} |
| */ |
| interface IWindowSession { |
| int add(IWindow window, int seq, in WindowManager.LayoutParams attrs, |
| in int viewVisibility, out Rect outContentInsets, |
| out InputChannel outInputChannel); |
| int addWithoutInputChannel(IWindow window, int seq, in WindowManager.LayoutParams attrs, |
| in int viewVisibility, out Rect outContentInsets); |
| void remove(IWindow window); |
| |
| /** |
| * Change the parameters of a window. You supply the |
| * new parameters, it returns the new frame of the window on screen (the |
| * position should be ignored) and surface of the window. The surface |
| * will be invalid if the window is currently hidden, else you can use it |
| * to draw the window's contents. |
| * |
| * @param window The window being modified. |
| * @param seq Ordering sequence number. |
| * @param attrs If non-null, new attributes to apply to the window. |
| * @param requestedWidth The width the window wants to be. |
| * @param requestedHeight The height the window wants to be. |
| * @param viewVisibility Window root view's visibility. |
| * @param flags Request flags: {@link WindowManagerImpl#RELAYOUT_INSETS_PENDING}, |
| * {@link WindowManagerImpl#RELAYOUT_DEFER_SURFACE_DESTROY}. |
| * @param outFrame Rect in which is placed the new position/size on |
| * screen. |
| * @param outContentInsets Rect in which is placed the offsets from |
| * <var>outFrame</var> in which the content of the window should be |
| * placed. This can be used to modify the window layout to ensure its |
| * contents are visible to the user, taking into account system windows |
| * like the status bar or a soft keyboard. |
| * @param outVisibleInsets Rect in which is placed the offsets from |
| * <var>outFrame</var> in which the window is actually completely visible |
| * to the user. This can be used to temporarily scroll the window's |
| * contents to make sure the user can see it. This is different than |
| * <var>outContentInsets</var> in that these insets change transiently, |
| * so complex relayout of the window should not happen based on them. |
| * @param outConfiguration New configuration of window, if it is now |
| * becoming visible and the global configuration has changed since it |
| * was last displayed. |
| * @param outSurface Object in which is placed the new display surface. |
| * |
| * @return int Result flags: {@link WindowManagerImpl#RELAYOUT_SHOW_FOCUS}, |
| * {@link WindowManagerImpl#RELAYOUT_FIRST_TIME}. |
| */ |
| int relayout(IWindow window, int seq, in WindowManager.LayoutParams attrs, |
| int requestedWidth, int requestedHeight, int viewVisibility, |
| int flags, out Rect outFrame, out Rect outContentInsets, |
| out Rect outVisibleInsets, out Configuration outConfig, |
| out Surface outSurface); |
| |
| /** |
| * If a call to relayout() asked to have the surface destroy deferred, |
| * it must call this once it is okay to destroy that surface. |
| */ |
| void performDeferredDestroy(IWindow window); |
| |
| /** |
| * Called by a client to report that it ran out of graphics memory. |
| */ |
| boolean outOfMemory(IWindow window); |
| |
| /** |
| * Give the window manager a hint of the part of the window that is |
| * completely transparent, allowing it to work with the surface flinger |
| * to optimize compositing of this part of the window. |
| */ |
| void setTransparentRegion(IWindow window, in Region region); |
| |
| /** |
| * Tell the window manager about the content and visible insets of the |
| * given window, which can be used to adjust the <var>outContentInsets</var> |
| * and <var>outVisibleInsets</var> values returned by |
| * {@link #relayout relayout()} for windows behind this one. |
| * |
| * @param touchableInsets Controls which part of the window inside of its |
| * frame can receive pointer events, as defined by |
| * {@link android.view.ViewTreeObserver.InternalInsetsInfo}. |
| */ |
| void setInsets(IWindow window, int touchableInsets, in Rect contentInsets, |
| in Rect visibleInsets, in Region touchableRegion); |
| |
| /** |
| * Return the current display size in which the window is being laid out, |
| * accounting for screen decorations around it. |
| */ |
| void getDisplayFrame(IWindow window, out Rect outDisplayFrame); |
| |
| void finishDrawing(IWindow window); |
| |
| void setInTouchMode(boolean showFocus); |
| boolean getInTouchMode(); |
| |
| boolean performHapticFeedback(IWindow window, int effectId, boolean always); |
| |
| /** |
| * Allocate the drag's thumbnail surface. Also assigns a token that identifies |
| * the drag to the OS and passes that as the return value. A return value of |
| * null indicates failure. |
| */ |
| IBinder prepareDrag(IWindow window, int flags, |
| int thumbnailWidth, int thumbnailHeight, out Surface outSurface); |
| |
| /** |
| * Initiate the drag operation itself |
| */ |
| boolean performDrag(IWindow window, IBinder dragToken, float touchX, float touchY, |
| float thumbCenterX, float thumbCenterY, in ClipData data); |
| |
| /** |
| * Report the result of a drop action targeted to the given window. |
| * consumed is 'true' when the drop was accepted by a valid recipient, |
| * 'false' otherwise. |
| */ |
| void reportDropResult(IWindow window, boolean consumed); |
| |
| /** |
| * Tell the OS that we've just dragged into a View that is willing to accept the drop |
| */ |
| void dragRecipientEntered(IWindow window); |
| |
| /** |
| * Tell the OS that we've just dragged *off* of a View that was willing to accept the drop |
| */ |
| void dragRecipientExited(IWindow window); |
| |
| /** |
| * For windows with the wallpaper behind them, and the wallpaper is |
| * larger than the screen, set the offset within the screen. |
| * For multi screen launcher type applications, xstep and ystep indicate |
| * how big the increment is from one screen to another. |
| */ |
| void setWallpaperPosition(IBinder windowToken, float x, float y, float xstep, float ystep); |
| |
| void wallpaperOffsetsComplete(IBinder window); |
| |
| Bundle sendWallpaperCommand(IBinder window, String action, int x, int y, |
| int z, in Bundle extras, boolean sync); |
| |
| void wallpaperCommandComplete(IBinder window, in Bundle result); |
| } |