core/java/android/view/accessibility/AccessibilityWindowInfo.java - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2014 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.accessibility;

 import android.graphics.Rect;
 import android.os.Parcel;
 import android.os.Parcelable;
 import android.util.LongArray;
 import android.util.Pools.SynchronizedPool;

 /**
  * This class represents a state snapshot of a window for accessibility
  * purposes. The screen content contains one or more windows where some
  * windows can be descendants of other windows, which is the windows are
  * hierarchically ordered. Note that there is no root window. Hence, the
  * screen content can be seen as a collection of window trees.
  */
 public final class AccessibilityWindowInfo implements Parcelable {

     private static final boolean DEBUG = false;

     /**
      * Window type: This is an application window. Such a window shows UI for
      * interacting with an application.
      */
     public static final int TYPE_APPLICATION = 1;

     /**
      * Window type: This is an input method window. Such a window shows UI for
      * inputting text such as keyboard, suggestions, etc.
      */
     public static final int TYPE_INPUT_METHOD = 2;

     /**
      * Window type: This is an system window. Such a window shows UI for
      * interacting with the system.
      */
     public static final int TYPE_SYSTEM = 3;

     /**
      * Window type: Windows that are overlaid <em>only</em> by an {@link
      * android.accessibilityservice.AccessibilityService} for interception of
      * user interactions without changing the windows an accessibility service
      * can introspect. In particular, an accessibility service can introspect
      * only windows that a sighted user can interact with which they can touch
      * these windows or can type into these windows. For example, if there
      * is a full screen accessibility overlay that is touchable, the windows
      * below it will be introspectable by an accessibility service regardless
      * they are covered by a touchable window.
      */
     public static final int TYPE_ACCESSIBILITY_OVERLAY = 4;

     private static final int UNDEFINED = -1;

     private static final int BOOLEAN_PROPERTY_ACTIVE = 1 << 0;
     private static final int BOOLEAN_PROPERTY_FOCUSED = 1 << 1;
     private static final int BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED = 1 << 2;

     // Housekeeping.
     private static final int MAX_POOL_SIZE = 10;
     private static final SynchronizedPool<AccessibilityWindowInfo> sPool =
             new SynchronizedPool<AccessibilityWindowInfo>(MAX_POOL_SIZE);

     // Data.
     private int mType = UNDEFINED;
     private int mLayer = UNDEFINED;
     private int mBooleanProperties;
     private int mId = UNDEFINED;
     private int mParentId = UNDEFINED;
     private final Rect mBoundsInScreen = new Rect();
     private LongArray mChildIds;

     private int mConnectionId = UNDEFINED;

     private AccessibilityWindowInfo() {
         /* do nothing - hide constructor */
     }

     /**
      * Gets the type of the window.
      *
      * @return The type.
      *
      * @see #TYPE_APPLICATION
      * @see #TYPE_INPUT_METHOD
      * @see #TYPE_SYSTEM
      * @see #TYPE_ACCESSIBILITY_OVERLAY
      */
     public int getType() {
         return mType;
     }

     /**
      * Sets the type of the window.
      *
      * @param type The type
      *
      * @hide
      */
     public void setType(int type) {
         mType = type;
     }

     /**
      * Gets the layer which determines the Z-order of the window. Windows
      * with greater layer appear on top of windows with lesser layer.
      *
      * @return The window layer.
      */
     public int getLayer() {
         return mLayer;
     }

     /**
      * Sets the layer which determines the Z-order of the window. Windows
      * with greater layer appear on top of windows with lesser layer.
      *
      * @param layer The window layer.
      *
      * @hide
      */
     public void setLayer(int layer) {
         mLayer = layer;
     }

     /**
      * Gets the root node in the window's hierarchy.
      *
      * @return The root node.
      */
     public AccessibilityNodeInfo getRoot() {
         if (mConnectionId == UNDEFINED) {
             return null;
         }
         AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
         return client.findAccessibilityNodeInfoByAccessibilityId(mConnectionId,
                 mId, AccessibilityNodeInfo.ROOT_NODE_ID,
                 true, AccessibilityNodeInfo.FLAG_PREFETCH_DESCENDANTS);
     }

     /**
      * Gets the parent window if such.
      *
      * @return The parent window.
      */
     public AccessibilityWindowInfo getParent() {
         if (mConnectionId == UNDEFINED || mParentId == UNDEFINED) {
             return null;
         }
         AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
         return client.getWindow(mConnectionId, mParentId);
     }

     /**
      * Sets the parent window id.
      *
      * @param parentId The parent id.
      *
      * @hide
      */
     public void setParentId(int parentId) {
         mParentId = parentId;
     }

     /**
      * Gets the unique window id.
      *
      * @return windowId The window id.
      */
     public int getId() {
         return mId;
     }

     /**
      * Sets the unique window id.
      *
      * @param id The window id.
      *
      * @hide
      */
     public void setId(int id) {
         mId = id;
     }

     /**
      * Sets the unique id of the IAccessibilityServiceConnection over which
      * this instance can send requests to the system.
      *
      * @param connectionId The connection id.
      *
      * @hide
      */
     public void setConnectionId(int connectionId) {
         mConnectionId = connectionId;
     }

     /**
      * Gets the bounds of this window in the screen.
      *
      * @param outBounds The out window bounds.
      */
     public void getBoundsInScreen(Rect outBounds) {
         outBounds.set(mBoundsInScreen);
     }

     /**
      * Sets the bounds of this window in the screen.
      *
      * @param bounds The out window bounds.
      *
      * @hide
      */
     public void setBoundsInScreen(Rect bounds) {
         mBoundsInScreen.set(bounds);
     }

     /**
      * Gets if this window is active. An active window is the one
      * the user is currently touching or the window has input focus
      * and the user is not touching any window.
      *
      * @return Whether this is the active window.
      */
     public boolean isActive() {
         return getBooleanProperty(BOOLEAN_PROPERTY_ACTIVE);
     }

     /**
      * Sets if this window is active, which is this is the window
      * the user is currently touching or the window has input focus
      * and the user is not touching any window.
      *
      * @param active Whether this is the active window.
      *
      * @hide
      */
     public void setActive(boolean active) {
         setBooleanProperty(BOOLEAN_PROPERTY_ACTIVE, active);
     }

     /**
      * Gets if this window has input focus.
      *
      * @return Whether has input focus.
      */
     public boolean isFocused() {
         return getBooleanProperty(BOOLEAN_PROPERTY_FOCUSED);
     }

     /**
      * Sets if this window has input focus.
      *
      * @param focused Whether has input focus.
      *
      * @hide
      */
     public void setFocused(boolean focused) {
         setBooleanProperty(BOOLEAN_PROPERTY_FOCUSED, focused);
     }

     /**
      * Gets if this window has accessibility focus.
      *
      * @return Whether has accessibility focus.
      */
     public boolean isAccessibilityFocused() {
         return getBooleanProperty(BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED);
     }

     /**
      * Sets if this window has accessibility focus.
      *
      * @param focused Whether has accessibility focus.
      *
      * @hide
      */
     public void setAccessibilityFocused(boolean focused) {
         setBooleanProperty(BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED, focused);
     }

     /**
      * Gets the number of child windows.
      *
      * @return The child count.
      */
     public int getChildCount() {
         return (mChildIds != null) ? mChildIds.size() : 0;
     }

     /**
      * Gets the child window at a given index.
      *
      * @param index The index.
      * @return The child.
      */
     public AccessibilityWindowInfo getChild(int index) {
         if (mChildIds == null) {
             throw new IndexOutOfBoundsException();
         }
         if (mConnectionId == UNDEFINED) {
             return null;
         }
         final int childId = (int) mChildIds.get(index);
         AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
         return client.getWindow(mConnectionId, childId);
     }

     /**
      * Adds a child window.
      *
      * @param childId The child window id.
      *
      * @hide
      */
     public void addChild(int childId) {
         if (mChildIds == null) {
             mChildIds = new LongArray();
         }
         mChildIds.add(childId);
     }

     /**
      * Returns a cached instance if such is available or a new one is
      * created.
      *
      * @return An instance.
      */
     public static AccessibilityWindowInfo obtain() {
         AccessibilityWindowInfo info = sPool.acquire();
         if (info == null) {
             info = new AccessibilityWindowInfo();
         }
         return info;
     }

     /**
      * Returns a cached instance if such is available or a new one is
      * created. The returned instance is initialized from the given
      * <code>info</code>.
      *
      * @param info The other info.
      * @return An instance.
      */
     public static AccessibilityWindowInfo obtain(AccessibilityWindowInfo info) {
         AccessibilityWindowInfo infoClone = obtain();

         infoClone.mType = info.mType;
         infoClone.mLayer = info.mLayer;
         infoClone.mBooleanProperties = info.mBooleanProperties;
         infoClone.mId = info.mId;
         infoClone.mParentId = info.mParentId;
         infoClone.mBoundsInScreen.set(info.mBoundsInScreen);

         if (info.mChildIds != null && info.mChildIds.size() > 0) {
             if (infoClone.mChildIds == null) {
                 infoClone.mChildIds = info.mChildIds.clone();
             } else {
                 infoClone.mChildIds.addAll(info.mChildIds);
             }
         }

         infoClone.mConnectionId = info.mConnectionId;

         return infoClone;
     }

     /**
      * Return an instance back to be reused.
      * <p>
      * <strong>Note:</strong> You must not touch the object after calling this function.
      * </p>
      *
      * @throws IllegalStateException If the info is already recycled.
      */
     public void recycle() {
         clear();
         sPool.release(this);
     }

     @Override
     public int describeContents() {
         return 0;
     }

     @Override
     public void writeToParcel(Parcel parcel, int flags) {
         parcel.writeInt(mType);
         parcel.writeInt(mLayer);
         parcel.writeInt(mBooleanProperties);
         parcel.writeInt(mId);
         parcel.writeInt(mParentId);
         mBoundsInScreen.writeToParcel(parcel, flags);

         final LongArray childIds = mChildIds;
         if (childIds == null) {
             parcel.writeInt(0);
         } else {
             final int childCount = childIds.size();
             parcel.writeInt(childCount);
             for (int i = 0; i < childCount; i++) {
                 parcel.writeInt((int) childIds.get(i));
             }
         }

         parcel.writeInt(mConnectionId);
     }

     private void initFromParcel(Parcel parcel) {
         mType = parcel.readInt();
         mLayer = parcel.readInt();
         mBooleanProperties = parcel.readInt();
         mId = parcel.readInt();
         mParentId = parcel.readInt();
         mBoundsInScreen.readFromParcel(parcel);

         final int childCount = parcel.readInt();
         if (childCount > 0) {
             if (mChildIds == null) {
                 mChildIds = new LongArray(childCount);
             }
             for (int i = 0; i < childCount; i++) {
                 final int childId = parcel.readInt();
                 mChildIds.add(childId);
             }
         }

         mConnectionId = parcel.readInt();
     }

     @Override
     public int hashCode() {
         return mId;
     }

     @Override
     public boolean equals(Object obj) {
         if (this == obj) {
             return true;
         }
         if (obj == null) {
             return false;
         }
         if (getClass() != obj.getClass()) {
             return false;
         }
         AccessibilityWindowInfo other = (AccessibilityWindowInfo) obj;
         return (mId == other.mId);
     }

     @Override
     public String toString() {
         StringBuilder builder = new StringBuilder();
         builder.append("AccessibilityWindowInfo[");
         builder.append("id=").append(mId);
         builder.append(", type=").append(typeToString(mType));
         builder.append(", layer=").append(mLayer);
         builder.append(", bounds=").append(mBoundsInScreen);
         builder.append(", focused=").append(isFocused());
         builder.append(", active=").append(isActive());
         if (DEBUG) {
             builder.append(", parent=").append(mParentId);
             builder.append(", children=[");
             if (mChildIds != null) {
                 final int childCount = mChildIds.size();
                 for (int i = 0; i < childCount; i++) {
                     builder.append(mChildIds.get(i));
                     if (i < childCount - 1) {
                         builder.append(',');
                     }
                 }
             } else {
                 builder.append("null");
             }
             builder.append(']');
         } else {
             builder.append(", hasParent=").append(mParentId != UNDEFINED);
             builder.append(", hasChildren=").append(mChildIds != null
                     && mChildIds.size() > 0);
         }
         builder.append(']');
         return builder.toString();
     }

     /**
      * Clears the internal state.
      */
     private void clear() {
         mType = UNDEFINED;
         mLayer = UNDEFINED;
         mBooleanProperties = 0;
         mId = UNDEFINED;
         mParentId = UNDEFINED;
         mBoundsInScreen.setEmpty();
         if (mChildIds != null) {
             mChildIds.clear();
         }
         mConnectionId = UNDEFINED;
     }

     /**
      * Gets the value of a boolean property.
      *
      * @param property The property.
      * @return The value.
      */
     private boolean getBooleanProperty(int property) {
         return (mBooleanProperties & property) != 0;
     }

     /**
      * Sets a boolean property.
      *
      * @param property The property.
      * @param value The value.
      *
      * @throws IllegalStateException If called from an AccessibilityService.
      */
     private void setBooleanProperty(int property, boolean value) {
         if (value) {
             mBooleanProperties |= property;
         } else {
             mBooleanProperties &= ~property;
         }
     }

     private static String typeToString(int type) {
         switch (type) {
             case TYPE_APPLICATION: {
                 return "TYPE_APPLICATION";
             }
             case TYPE_INPUT_METHOD: {
                 return "TYPE_INPUT_METHOD";
             }
             case TYPE_SYSTEM: {
                 return "TYPE_SYSTEM";
             }
             case TYPE_ACCESSIBILITY_OVERLAY: {
                 return "TYPE_ACCESSIBILITY_OVERLAY";
             }
             default:
                 return "<UNKNOWN>";
         }
     }

     /**
      * Checks whether this window changed. The argument should be
      * another state of the same window, which is have the same id
      * and type as they never change.
      *
      * @param other The new state.
      * @return Whether something changed.
      *
      * @hide
      */
     public boolean changed(AccessibilityWindowInfo other) {
         if (other.mId != mId) {
             throw new IllegalArgumentException("Not same window.");
         }
         if (other.mType != mType) {
             throw new IllegalArgumentException("Not same type.");
         }
         if (!mBoundsInScreen.equals(mBoundsInScreen)) {
             return true;
         }
         if (mLayer != other.mLayer) {
             return true;
         }
         if (mBooleanProperties != other.mBooleanProperties) {
             return true;
         }
         if (mParentId != other.mParentId) {
             return true;
         }
         if (mChildIds == null) {
             if (other.mChildIds != null) {
                 return true;
             }
         } else if (!mChildIds.equals(other.mChildIds)) {
             return true;
         }
         return false;
     }

     public static final Parcelable.Creator<AccessibilityWindowInfo> CREATOR =
             new Creator<AccessibilityWindowInfo>() {
         @Override
         public AccessibilityWindowInfo createFromParcel(Parcel parcel) {
             AccessibilityWindowInfo info = obtain();
             info.initFromParcel(parcel);
             return info;
         }

         @Override
         public AccessibilityWindowInfo[] newArray(int size) {
             return new AccessibilityWindowInfo[size];
         }
     };
 }
	/*
	* Copyright (C) 2014 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.accessibility;

	import android.graphics.Rect;
	import android.os.Parcel;
	import android.os.Parcelable;
	import android.util.LongArray;
	import android.util.Pools.SynchronizedPool;

	/**
	* This class represents a state snapshot of a window for accessibility
	* purposes. The screen content contains one or more windows where some
	* windows can be descendants of other windows, which is the windows are
	* hierarchically ordered. Note that there is no root window. Hence, the
	* screen content can be seen as a collection of window trees.
	*/
	public final class AccessibilityWindowInfo implements Parcelable {

	private static final boolean DEBUG = false;

	/**
	* Window type: This is an application window. Such a window shows UI for
	* interacting with an application.
	*/
	public static final int TYPE_APPLICATION = 1;

	/**
	* Window type: This is an input method window. Such a window shows UI for
	* inputting text such as keyboard, suggestions, etc.
	*/
	public static final int TYPE_INPUT_METHOD = 2;

	/**
	* Window type: This is an system window. Such a window shows UI for
	* interacting with the system.
	*/
	public static final int TYPE_SYSTEM = 3;

	/**
	* Window type: Windows that are overlaid <em>only</em> by an {@link
	* android.accessibilityservice.AccessibilityService} for interception of
	* user interactions without changing the windows an accessibility service
	* can introspect. In particular, an accessibility service can introspect
	* only windows that a sighted user can interact with which they can touch
	* these windows or can type into these windows. For example, if there
	* is a full screen accessibility overlay that is touchable, the windows
	* below it will be introspectable by an accessibility service regardless
	* they are covered by a touchable window.
	*/
	public static final int TYPE_ACCESSIBILITY_OVERLAY = 4;

	private static final int UNDEFINED = -1;

	private static final int BOOLEAN_PROPERTY_ACTIVE = 1 << 0;
	private static final int BOOLEAN_PROPERTY_FOCUSED = 1 << 1;
	private static final int BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED = 1 << 2;

	// Housekeeping.
	private static final int MAX_POOL_SIZE = 10;
	private static final SynchronizedPool<AccessibilityWindowInfo> sPool =
	new SynchronizedPool<AccessibilityWindowInfo>(MAX_POOL_SIZE);

	// Data.
	private int mType = UNDEFINED;
	private int mLayer = UNDEFINED;
	private int mBooleanProperties;
	private int mId = UNDEFINED;
	private int mParentId = UNDEFINED;
	private final Rect mBoundsInScreen = new Rect();
	private LongArray mChildIds;

	private int mConnectionId = UNDEFINED;

	private AccessibilityWindowInfo() {
	/* do nothing - hide constructor */
	}

	/**
	* Gets the type of the window.
	*
	* @return The type.
	*
	* @see #TYPE_APPLICATION
	* @see #TYPE_INPUT_METHOD
	* @see #TYPE_SYSTEM
	* @see #TYPE_ACCESSIBILITY_OVERLAY
	*/
	public int getType() {
	return mType;
	}

	/**
	* Sets the type of the window.
	*
	* @param type The type
	*
	* @hide
	*/
	public void setType(int type) {
	mType = type;
	}

	/**
	* Gets the layer which determines the Z-order of the window. Windows
	* with greater layer appear on top of windows with lesser layer.
	*
	* @return The window layer.
	*/
	public int getLayer() {
	return mLayer;
	}

	/**
	* Sets the layer which determines the Z-order of the window. Windows
	* with greater layer appear on top of windows with lesser layer.
	*
	* @param layer The window layer.
	*
	* @hide
	*/
	public void setLayer(int layer) {
	mLayer = layer;
	}

	/**
	* Gets the root node in the window's hierarchy.
	*
	* @return The root node.
	*/
	public AccessibilityNodeInfo getRoot() {
	if (mConnectionId == UNDEFINED) {
	return null;
	}
	AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
	return client.findAccessibilityNodeInfoByAccessibilityId(mConnectionId,
	mId, AccessibilityNodeInfo.ROOT_NODE_ID,
	true, AccessibilityNodeInfo.FLAG_PREFETCH_DESCENDANTS);
	}

	/**
	* Gets the parent window if such.
	*
	* @return The parent window.
	*/
	public AccessibilityWindowInfo getParent() {
	if (mConnectionId == UNDEFINED \|\| mParentId == UNDEFINED) {
	return null;
	}
	AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
	return client.getWindow(mConnectionId, mParentId);
	}

	/**
	* Sets the parent window id.
	*
	* @param parentId The parent id.
	*
	* @hide
	*/
	public void setParentId(int parentId) {
	mParentId = parentId;
	}

	/**
	* Gets the unique window id.
	*
	* @return windowId The window id.
	*/
	public int getId() {
	return mId;
	}

	/**
	* Sets the unique window id.
	*
	* @param id The window id.
	*
	* @hide
	*/
	public void setId(int id) {
	mId = id;
	}

	/**
	* Sets the unique id of the IAccessibilityServiceConnection over which
	* this instance can send requests to the system.
	*
	* @param connectionId The connection id.
	*
	* @hide
	*/
	public void setConnectionId(int connectionId) {
	mConnectionId = connectionId;
	}

	/**
	* Gets the bounds of this window in the screen.
	*
	* @param outBounds The out window bounds.
	*/
	public void getBoundsInScreen(Rect outBounds) {
	outBounds.set(mBoundsInScreen);
	}

	/**
	* Sets the bounds of this window in the screen.
	*
	* @param bounds The out window bounds.
	*
	* @hide
	*/
	public void setBoundsInScreen(Rect bounds) {
	mBoundsInScreen.set(bounds);
	}

	/**
	* Gets if this window is active. An active window is the one
	* the user is currently touching or the window has input focus
	* and the user is not touching any window.
	*
	* @return Whether this is the active window.
	*/
	public boolean isActive() {
	return getBooleanProperty(BOOLEAN_PROPERTY_ACTIVE);
	}

	/**
	* Sets if this window is active, which is this is the window
	* the user is currently touching or the window has input focus
	* and the user is not touching any window.
	*
	* @param active Whether this is the active window.
	*
	* @hide
	*/
	public void setActive(boolean active) {
	setBooleanProperty(BOOLEAN_PROPERTY_ACTIVE, active);
	}

	/**
	* Gets if this window has input focus.
	*
	* @return Whether has input focus.
	*/
	public boolean isFocused() {
	return getBooleanProperty(BOOLEAN_PROPERTY_FOCUSED);
	}

	/**
	* Sets if this window has input focus.
	*
	* @param focused Whether has input focus.
	*
	* @hide
	*/
	public void setFocused(boolean focused) {
	setBooleanProperty(BOOLEAN_PROPERTY_FOCUSED, focused);
	}

	/**
	* Gets if this window has accessibility focus.
	*
	* @return Whether has accessibility focus.
	*/
	public boolean isAccessibilityFocused() {
	return getBooleanProperty(BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED);
	}

	/**
	* Sets if this window has accessibility focus.
	*
	* @param focused Whether has accessibility focus.
	*
	* @hide
	*/
	public void setAccessibilityFocused(boolean focused) {
	setBooleanProperty(BOOLEAN_PROPERTY_ACCESSIBILITY_FOCUSED, focused);
	}

	/**
	* Gets the number of child windows.
	*
	* @return The child count.
	*/
	public int getChildCount() {
	return (mChildIds != null) ? mChildIds.size() : 0;
	}

	/**
	* Gets the child window at a given index.
	*
	* @param index The index.
	* @return The child.
	*/
	public AccessibilityWindowInfo getChild(int index) {
	if (mChildIds == null) {
	throw new IndexOutOfBoundsException();
	}
	if (mConnectionId == UNDEFINED) {
	return null;
	}
	final int childId = (int) mChildIds.get(index);
	AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
	return client.getWindow(mConnectionId, childId);
	}

	/**
	* Adds a child window.
	*
	* @param childId The child window id.
	*
	* @hide
	*/
	public void addChild(int childId) {
	if (mChildIds == null) {
	mChildIds = new LongArray();
	}
	mChildIds.add(childId);
	}

	/**
	* Returns a cached instance if such is available or a new one is
	* created.
	*
	* @return An instance.
	*/
	public static AccessibilityWindowInfo obtain() {
	AccessibilityWindowInfo info = sPool.acquire();
	if (info == null) {
	info = new AccessibilityWindowInfo();
	}
	return info;
	}

	/**
	* Returns a cached instance if such is available or a new one is
	* created. The returned instance is initialized from the given
	* <code>info</code>.
	*
	* @param info The other info.
	* @return An instance.
	*/
	public static AccessibilityWindowInfo obtain(AccessibilityWindowInfo info) {
	AccessibilityWindowInfo infoClone = obtain();

	infoClone.mType = info.mType;
	infoClone.mLayer = info.mLayer;
	infoClone.mBooleanProperties = info.mBooleanProperties;
	infoClone.mId = info.mId;
	infoClone.mParentId = info.mParentId;
	infoClone.mBoundsInScreen.set(info.mBoundsInScreen);

	if (info.mChildIds != null && info.mChildIds.size() > 0) {
	if (infoClone.mChildIds == null) {
	infoClone.mChildIds = info.mChildIds.clone();
	} else {
	infoClone.mChildIds.addAll(info.mChildIds);
	}
	}

	infoClone.mConnectionId = info.mConnectionId;

	return infoClone;
	}

	/**
	* Return an instance back to be reused.
	* <p>
	* <strong>Note:</strong> You must not touch the object after calling this function.
	* </p>
	*
	* @throws IllegalStateException If the info is already recycled.
	*/
	public void recycle() {
	clear();
	sPool.release(this);
	}

	@Override
	public int describeContents() {
	return 0;
	}

	@Override
	public void writeToParcel(Parcel parcel, int flags) {
	parcel.writeInt(mType);
	parcel.writeInt(mLayer);
	parcel.writeInt(mBooleanProperties);
	parcel.writeInt(mId);
	parcel.writeInt(mParentId);
	mBoundsInScreen.writeToParcel(parcel, flags);

	final LongArray childIds = mChildIds;
	if (childIds == null) {
	parcel.writeInt(0);
	} else {
	final int childCount = childIds.size();
	parcel.writeInt(childCount);
	for (int i = 0; i < childCount; i++) {
	parcel.writeInt((int) childIds.get(i));
	}
	}

	parcel.writeInt(mConnectionId);
	}

	private void initFromParcel(Parcel parcel) {
	mType = parcel.readInt();
	mLayer = parcel.readInt();
	mBooleanProperties = parcel.readInt();
	mId = parcel.readInt();
	mParentId = parcel.readInt();
	mBoundsInScreen.readFromParcel(parcel);

	final int childCount = parcel.readInt();
	if (childCount > 0) {
	if (mChildIds == null) {
	mChildIds = new LongArray(childCount);
	}
	for (int i = 0; i < childCount; i++) {
	final int childId = parcel.readInt();
	mChildIds.add(childId);
	}
	}

	mConnectionId = parcel.readInt();
	}

	@Override
	public int hashCode() {
	return mId;
	}

	@Override
	public boolean equals(Object obj) {
	if (this == obj) {
	return true;
	}
	if (obj == null) {
	return false;
	}
	if (getClass() != obj.getClass()) {
	return false;
	}
	AccessibilityWindowInfo other = (AccessibilityWindowInfo) obj;
	return (mId == other.mId);
	}

	@Override
	public String toString() {
	StringBuilder builder = new StringBuilder();
	builder.append("AccessibilityWindowInfo[");
	builder.append("id=").append(mId);
	builder.append(", type=").append(typeToString(mType));
	builder.append(", layer=").append(mLayer);
	builder.append(", bounds=").append(mBoundsInScreen);
	builder.append(", focused=").append(isFocused());
	builder.append(", active=").append(isActive());
	if (DEBUG) {
	builder.append(", parent=").append(mParentId);
	builder.append(", children=[");
	if (mChildIds != null) {
	final int childCount = mChildIds.size();
	for (int i = 0; i < childCount; i++) {
	builder.append(mChildIds.get(i));
	if (i < childCount - 1) {
	builder.append(',');
	}
	}
	} else {
	builder.append("null");
	}
	builder.append(']');
	} else {
	builder.append(", hasParent=").append(mParentId != UNDEFINED);
	builder.append(", hasChildren=").append(mChildIds != null
	&& mChildIds.size() > 0);
	}
	builder.append(']');
	return builder.toString();
	}

	/**
	* Clears the internal state.
	*/
	private void clear() {
	mType = UNDEFINED;
	mLayer = UNDEFINED;
	mBooleanProperties = 0;
	mId = UNDEFINED;
	mParentId = UNDEFINED;
	mBoundsInScreen.setEmpty();
	if (mChildIds != null) {
	mChildIds.clear();
	}
	mConnectionId = UNDEFINED;
	}

	/**
	* Gets the value of a boolean property.
	*
	* @param property The property.
	* @return The value.
	*/
	private boolean getBooleanProperty(int property) {
	return (mBooleanProperties & property) != 0;
	}

	/**
	* Sets a boolean property.
	*
	* @param property The property.
	* @param value The value.
	*
	* @throws IllegalStateException If called from an AccessibilityService.
	*/
	private void setBooleanProperty(int property, boolean value) {
	if (value) {
	mBooleanProperties \|= property;
	} else {
	mBooleanProperties &= ~property;
	}
	}

	private static String typeToString(int type) {
	switch (type) {
	case TYPE_APPLICATION: {
	return "TYPE_APPLICATION";
	}
	case TYPE_INPUT_METHOD: {
	return "TYPE_INPUT_METHOD";
	}
	case TYPE_SYSTEM: {
	return "TYPE_SYSTEM";
	}
	case TYPE_ACCESSIBILITY_OVERLAY: {
	return "TYPE_ACCESSIBILITY_OVERLAY";
	}
	default:
	return "<UNKNOWN>";
	}
	}

	/**
	* Checks whether this window changed. The argument should be
	* another state of the same window, which is have the same id
	* and type as they never change.
	*
	* @param other The new state.
	* @return Whether something changed.
	*
	* @hide
	*/
	public boolean changed(AccessibilityWindowInfo other) {
	if (other.mId != mId) {
	throw new IllegalArgumentException("Not same window.");
	}
	if (other.mType != mType) {
	throw new IllegalArgumentException("Not same type.");
	}
	if (!mBoundsInScreen.equals(mBoundsInScreen)) {
	return true;
	}
	if (mLayer != other.mLayer) {
	return true;
	}
	if (mBooleanProperties != other.mBooleanProperties) {
	return true;
	}
	if (mParentId != other.mParentId) {
	return true;
	}
	if (mChildIds == null) {
	if (other.mChildIds != null) {
	return true;
	}
	} else if (!mChildIds.equals(other.mChildIds)) {
	return true;
	}
	return false;
	}

	public static final Parcelable.Creator<AccessibilityWindowInfo> CREATOR =
	new Creator<AccessibilityWindowInfo>() {
	@Override
	public AccessibilityWindowInfo createFromParcel(Parcel parcel) {
	AccessibilityWindowInfo info = obtain();
	info.initFromParcel(parcel);
	return info;
	}

	@Override
	public AccessibilityWindowInfo[] newArray(int size) {
	return new AccessibilityWindowInfo[size];
	}
	};
	}