1 /*
2  * Copyright (C) 2014 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 package android.view;
18 
19 import android.graphics.Rect;
20 import android.os.IBinder;
21 import android.os.Parcel;
22 import android.os.Parcelable;
23 import android.util.Pools;
24 
25 import java.util.ArrayList;
26 import java.util.List;
27 
28 /**
29  * This class represents information about a window from the
30  * window manager to another part of the system.
31  *
32  * @hide
33  */
34 public class WindowInfo implements Parcelable {
35     private static final int MAX_POOL_SIZE = 10;
36 
37     private static final Pools.SynchronizedPool<WindowInfo> sPool =
38             new Pools.SynchronizedPool<WindowInfo>(MAX_POOL_SIZE);
39 
40     public int type;
41     public int layer;
42     public IBinder token;
43     public IBinder parentToken;
44     public boolean focused;
45     public final Rect boundsInScreen = new Rect();
46     public List<IBinder> childTokens;
47     public CharSequence title;
48     public int accessibilityIdOfAnchor = View.NO_ID;
49 
WindowInfo()50     private WindowInfo() {
51         /* do nothing - hide constructor */
52     }
53 
obtain()54     public static WindowInfo obtain() {
55         WindowInfo window = sPool.acquire();
56         if (window == null) {
57             window = new WindowInfo();
58         }
59         return window;
60     }
61 
obtain(WindowInfo other)62     public static WindowInfo obtain(WindowInfo other) {
63         WindowInfo window = obtain();
64         window.type = other.type;
65         window.layer = other.layer;
66         window.token = other.token;
67         window.parentToken = other.parentToken;
68         window.focused = other.focused;
69         window.boundsInScreen.set(other.boundsInScreen);
70         window.title = other.title;
71         window.accessibilityIdOfAnchor = other.accessibilityIdOfAnchor;
72 
73         if (other.childTokens != null && !other.childTokens.isEmpty()) {
74             if (window.childTokens == null) {
75                 window.childTokens = new ArrayList<IBinder>(other.childTokens);
76             } else {
77                 window.childTokens.addAll(other.childTokens);
78             }
79         }
80 
81         return window;
82     }
83 
recycle()84     public void recycle() {
85         clear();
86         sPool.release(this);
87     }
88 
89     @Override
describeContents()90     public int describeContents() {
91         return 0;
92     }
93 
94     @Override
writeToParcel(Parcel parcel, int flags)95     public void writeToParcel(Parcel parcel, int flags) {
96         parcel.writeInt(type);
97         parcel.writeInt(layer);
98         parcel.writeStrongBinder(token);
99         parcel.writeStrongBinder(parentToken);
100         parcel.writeInt(focused ? 1 : 0);
101         boundsInScreen.writeToParcel(parcel, flags);
102         parcel.writeCharSequence(title);
103         parcel.writeInt(accessibilityIdOfAnchor);
104 
105         if (childTokens != null && !childTokens.isEmpty()) {
106             parcel.writeInt(1);
107             parcel.writeBinderList(childTokens);
108         } else {
109             parcel.writeInt(0);
110         }
111     }
112 
113     @Override
toString()114     public String toString() {
115         StringBuilder builder = new StringBuilder();
116         builder.append("WindowInfo[");
117         builder.append("title=").append(title);
118         builder.append(", type=").append(type);
119         builder.append(", layer=").append(layer);
120         builder.append(", token=").append(token);
121         builder.append(", bounds=").append(boundsInScreen);
122         builder.append(", parent=").append(parentToken);
123         builder.append(", focused=").append(focused);
124         builder.append(", children=").append(childTokens);
125         builder.append(", accessibility anchor=").append(accessibilityIdOfAnchor);
126         builder.append(']');
127         return builder.toString();
128     }
129 
initFromParcel(Parcel parcel)130     private void initFromParcel(Parcel parcel) {
131         type = parcel.readInt();
132         layer = parcel.readInt();
133         token = parcel.readStrongBinder();
134         parentToken = parcel.readStrongBinder();
135         focused = (parcel.readInt() == 1);
136         boundsInScreen.readFromParcel(parcel);
137         title = parcel.readCharSequence();
138         accessibilityIdOfAnchor = parcel.readInt();
139 
140         final boolean hasChildren = (parcel.readInt() == 1);
141         if (hasChildren) {
142             if (childTokens == null) {
143                 childTokens = new ArrayList<IBinder>();
144             }
145             parcel.readBinderList(childTokens);
146         }
147     }
148 
clear()149     private void clear() {
150         type = 0;
151         layer = 0;
152         token = null;
153         parentToken = null;
154         focused = false;
155         boundsInScreen.setEmpty();
156         if (childTokens != null) {
157             childTokens.clear();
158         }
159     }
160 
161     public static final Parcelable.Creator<WindowInfo> CREATOR =
162             new Creator<WindowInfo>() {
163         @Override
164         public WindowInfo createFromParcel(Parcel parcel) {
165             WindowInfo window = obtain();
166             window.initFromParcel(parcel);
167             return window;
168         }
169 
170         @Override
171         public WindowInfo[] newArray(int size) {
172             return new WindowInfo[size];
173         }
174     };
175 }
176