1 /* //device/java/android/android/view/IWindow.aidl 2 ** 3 ** Copyright 2007, 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.graphics.Point; 21 import android.graphics.Rect; 22 import android.os.Bundle; 23 import android.os.ParcelFileDescriptor; 24 import android.util.MergedConfiguration; 25 import android.view.DisplayCutout; 26 import android.view.DragEvent; 27 import android.view.InsetsSourceControl; 28 import android.view.InsetsState; 29 import android.view.IScrollCaptureResponseListener; 30 import android.view.KeyEvent; 31 import android.view.MotionEvent; 32 import android.window.ClientWindowFrames; 33 34 import com.android.internal.os.IResultReceiver; 35 36 /** 37 * API back to a client window that the Window Manager uses to inform it of 38 * interesting things happening. 39 * 40 * {@hide} 41 */ 42 oneway interface IWindow { 43 /** 44 * ===== NOTICE ===== 45 * The first method must remain the first method. Scripts 46 * and tools rely on their transaction number to work properly. 47 */ 48 49 /** 50 * Invoked by the view server to tell a window to execute the specified 51 * command. Any response from the receiver must be sent through the 52 * specified file descriptor. 53 */ executeCommand(String command, String parameters, in ParcelFileDescriptor descriptor)54 void executeCommand(String command, String parameters, in ParcelFileDescriptor descriptor); 55 resized(in ClientWindowFrames frames, boolean reportDraw, in MergedConfiguration newMergedConfiguration, in InsetsState insetsState, boolean forceLayout, boolean alwaysConsumeSystemBars, int displayId, int syncSeqId, int resizeMode)56 void resized(in ClientWindowFrames frames, boolean reportDraw, 57 in MergedConfiguration newMergedConfiguration, in InsetsState insetsState, 58 boolean forceLayout, boolean alwaysConsumeSystemBars, int displayId, 59 int syncSeqId, int resizeMode); 60 61 /** 62 * Called when this window retrieved control over a specified set of insets sources. 63 */ insetsControlChanged(in InsetsState insetsState, in InsetsSourceControl[] activeControls)64 void insetsControlChanged(in InsetsState insetsState, in InsetsSourceControl[] activeControls); 65 66 /** 67 * Called when a set of insets source window should be shown by policy. 68 * 69 * @param types internal insets types (WindowInsets.Type.InsetsType) to show 70 * @param fromIme true if this request originated from IME (InputMethodService). 71 */ showInsets(int types, boolean fromIme)72 void showInsets(int types, boolean fromIme); 73 74 /** 75 * Called when a set of insets source window should be hidden by policy. 76 * 77 * @param types internal insets types (WindowInsets.Type.InsetsType) to hide 78 * @param fromIme true if this request originated from IME (InputMethodService). 79 */ hideInsets(int types, boolean fromIme)80 void hideInsets(int types, boolean fromIme); 81 moved(int newX, int newY)82 void moved(int newX, int newY); dispatchAppVisibility(boolean visible)83 void dispatchAppVisibility(boolean visible); dispatchGetNewSurface()84 void dispatchGetNewSurface(); 85 closeSystemDialogs(String reason)86 void closeSystemDialogs(String reason); 87 88 /** 89 * Called for wallpaper windows when their offsets or zoom level change. 90 */ dispatchWallpaperOffsets(float x, float y, float xStep, float yStep, float zoom, boolean sync)91 void dispatchWallpaperOffsets(float x, float y, float xStep, float yStep, float zoom, boolean sync); 92 dispatchWallpaperCommand(String action, int x, int y, int z, in Bundle extras, boolean sync)93 void dispatchWallpaperCommand(String action, int x, int y, 94 int z, in Bundle extras, boolean sync); 95 96 /** 97 * Drag/drop events 98 */ dispatchDragEvent(in DragEvent event)99 void dispatchDragEvent(in DragEvent event); 100 101 /** 102 * Pointer icon events 103 */ updatePointerIcon(float x, float y)104 void updatePointerIcon(float x, float y); 105 106 /** 107 * Called for non-application windows when the enter animation has completed. 108 */ dispatchWindowShown()109 void dispatchWindowShown(); 110 111 /** 112 * Called when Keyboard Shortcuts are requested for the window. 113 */ requestAppKeyboardShortcuts(IResultReceiver receiver, int deviceId)114 void requestAppKeyboardShortcuts(IResultReceiver receiver, int deviceId); 115 116 /** 117 * Called when Scroll Capture support is requested for a window. 118 * 119 * @param callbacks to receive responses 120 */ requestScrollCapture(in IScrollCaptureResponseListener callbacks)121 void requestScrollCapture(in IScrollCaptureResponseListener callbacks); 122 } 123