The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 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.Rect; |
Dianne Hackborn | 7580493 | 2009-10-20 20:15:20 -0700 | [diff] [blame] | 21 | import android.os.Bundle; |
| 22 | import android.os.ParcelFileDescriptor; |
Christopher Tate | a53146c | 2010-09-07 11:57:52 -0700 | [diff] [blame] | 23 | import android.view.DragEvent; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 24 | import android.view.KeyEvent; |
| 25 | import android.view.MotionEvent; |
Adrian Roos | 5c6b622 | 2017-11-07 17:36:10 +0100 | [diff] [blame] | 26 | import android.view.DisplayCutout; |
Jorim Jaggi | f96c90a | 2018-09-26 16:55:15 +0200 | [diff] [blame] | 27 | import android.view.InsetsState; |
Jorim Jaggi | b603095 | 2018-10-23 18:31:52 +0200 | [diff] [blame] | 28 | import android.view.InsetsSourceControl; |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 29 | |
Clara Bayarri | 75e0979 | 2015-07-29 16:20:40 +0100 | [diff] [blame] | 30 | import com.android.internal.os.IResultReceiver; |
Andrii Kulian | 4460796 | 2017-03-16 11:06:24 -0700 | [diff] [blame] | 31 | import android.util.MergedConfiguration; |
Clara Bayarri | 75e0979 | 2015-07-29 16:20:40 +0100 | [diff] [blame] | 32 | |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 33 | /** |
| 34 | * API back to a client window that the Window Manager uses to inform it of |
| 35 | * interesting things happening. |
| 36 | * |
| 37 | * {@hide} |
| 38 | */ |
| 39 | oneway interface IWindow { |
| 40 | /** |
| 41 | * ===== NOTICE ===== |
| 42 | * The first method must remain the first method. Scripts |
| 43 | * and tools rely on their transaction number to work properly. |
| 44 | */ |
| 45 | |
| 46 | /** |
| 47 | * Invoked by the view server to tell a window to execute the specified |
| 48 | * command. Any response from the receiver must be sent through the |
| 49 | * specified file descriptor. |
| 50 | */ |
| 51 | void executeCommand(String command, String parameters, in ParcelFileDescriptor descriptor); |
| 52 | |
Dianne Hackborn | c4aad01 | 2013-02-22 15:05:25 -0800 | [diff] [blame] | 53 | void resized(in Rect frame, in Rect overscanInsets, in Rect contentInsets, |
Filip Gruszczynski | 2217f61 | 2015-05-26 11:32:08 -0700 | [diff] [blame] | 54 | in Rect visibleInsets, in Rect stableInsets, in Rect outsets, boolean reportDraw, |
Andrii Kulian | 4460796 | 2017-03-16 11:06:24 -0700 | [diff] [blame] | 55 | in MergedConfiguration newMergedConfiguration, in Rect backDropFrame, |
Adrian Roos | 5c6b622 | 2017-11-07 17:36:10 +0100 | [diff] [blame] | 56 | boolean forceLayout, boolean alwaysConsumeNavBar, int displayId, |
| 57 | in DisplayCutout.ParcelableWrapper displayCutout); |
Jorim Jaggi | f96c90a | 2018-09-26 16:55:15 +0200 | [diff] [blame] | 58 | |
| 59 | /** |
| 60 | * Called when the window insets configuration has changed. |
| 61 | */ |
| 62 | void insetsChanged(in InsetsState insetsState); |
| 63 | |
Jorim Jaggi | b603095 | 2018-10-23 18:31:52 +0200 | [diff] [blame] | 64 | /** |
| 65 | * Called when this window retrieved control over a specified set of inset sources. |
| 66 | */ |
| 67 | void insetsControlChanged(in InsetsState insetsState, in InsetsSourceControl[] activeControls); |
| 68 | |
Craig Mautner | 5702d4d | 2012-06-30 14:10:16 -0700 | [diff] [blame] | 69 | void moved(int newX, int newY); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 70 | void dispatchAppVisibility(boolean visible); |
| 71 | void dispatchGetNewSurface(); |
| 72 | |
| 73 | /** |
Tiger Huang | 51c5a1d | 2018-12-11 20:24:51 +0800 | [diff] [blame] | 74 | * Tell the window that it is either gaining or losing focus. Keep it up |
| 75 | * to date on the current state showing navigational focus (touch mode) too. |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 76 | */ |
Tiger Huang | 51c5a1d | 2018-12-11 20:24:51 +0800 | [diff] [blame] | 77 | void windowFocusChanged(boolean hasFocus, boolean inTouchMode); |
| 78 | |
Dianne Hackborn | ffa4248 | 2009-09-23 22:20:11 -0700 | [diff] [blame] | 79 | void closeSystemDialogs(String reason); |
Tiger Huang | 51c5a1d | 2018-12-11 20:24:51 +0800 | [diff] [blame] | 80 | |
Dianne Hackborn | 72c82ab | 2009-08-11 21:13:54 -0700 | [diff] [blame] | 81 | /** |
| 82 | * Called for wallpaper windows when their offsets change. |
| 83 | */ |
Marco Nelissen | bf6956b | 2009-11-09 15:21:13 -0800 | [diff] [blame] | 84 | void dispatchWallpaperOffsets(float x, float y, float xStep, float yStep, boolean sync); |
Tiger Huang | 51c5a1d | 2018-12-11 20:24:51 +0800 | [diff] [blame] | 85 | |
Dianne Hackborn | 7580493 | 2009-10-20 20:15:20 -0700 | [diff] [blame] | 86 | void dispatchWallpaperCommand(String action, int x, int y, |
| 87 | int z, in Bundle extras, boolean sync); |
Christopher Tate | a53146c | 2010-09-07 11:57:52 -0700 | [diff] [blame] | 88 | |
| 89 | /** |
| 90 | * Drag/drop events |
| 91 | */ |
Dianne Hackborn | 12d3a94 | 2012-04-27 14:16:30 -0700 | [diff] [blame] | 92 | void dispatchDragEvent(in DragEvent event); |
Joe Onorato | 664644d | 2011-01-23 17:53:23 -0800 | [diff] [blame] | 93 | |
| 94 | /** |
Vladislav Kaznacheev | ec6a447 | 2016-01-22 12:21:52 -0800 | [diff] [blame] | 95 | * Pointer icon events |
| 96 | */ |
| 97 | void updatePointerIcon(float x, float y); |
| 98 | |
| 99 | /** |
Joe Onorato | 664644d | 2011-01-23 17:53:23 -0800 | [diff] [blame] | 100 | * System chrome visibility changes |
| 101 | */ |
Dianne Hackborn | 12d3a94 | 2012-04-27 14:16:30 -0700 | [diff] [blame] | 102 | void dispatchSystemUiVisibilityChanged(int seq, int globalVisibility, |
Dianne Hackborn | 9a230e0 | 2011-10-06 11:51:27 -0700 | [diff] [blame] | 103 | int localValue, int localChanges); |
Dianne Hackborn | 12d3a94 | 2012-04-27 14:16:30 -0700 | [diff] [blame] | 104 | |
| 105 | /** |
Craig Mautner | 9c79504 | 2014-10-28 19:59:59 -0700 | [diff] [blame] | 106 | * Called for non-application windows when the enter animation has completed. |
| 107 | */ |
| 108 | void dispatchWindowShown(); |
Clara Bayarri | 75e0979 | 2015-07-29 16:20:40 +0100 | [diff] [blame] | 109 | |
| 110 | /** |
| 111 | * Called when Keyboard Shortcuts are requested for the window. |
| 112 | */ |
Clara Bayarri | fcd7e80 | 2016-03-10 12:58:18 +0000 | [diff] [blame] | 113 | void requestAppKeyboardShortcuts(IResultReceiver receiver, int deviceId); |
Vladislav Kaznacheev | 3787de1 | 2016-12-21 10:36:35 -0800 | [diff] [blame] | 114 | |
| 115 | /** |
| 116 | * Tell the window that it is either gaining or losing pointer capture. |
| 117 | */ |
| 118 | void dispatchPointerCaptureChanged(boolean hasCapture); |
The Android Open Source Project | 9066cfe | 2009-03-03 19:31:44 -0800 | [diff] [blame] | 119 | } |