content: /*
   * Copyright (C) 2016 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.text.style;
  
  import static android.view.accessibility.AccessibilityNodeInfo.ACTION_ARGUMENT_ACCESSIBLE_CLICKABLE_SPAN;
  import static android.view.accessibility.AccessibilityNodeInfo.UNDEFINED_CONNECTION_ID;
  import static android.view.accessibility.AccessibilityNodeInfo.UNDEFINED_NODE_ID;
  import static android.view.accessibility.AccessibilityWindowInfo.UNDEFINED_WINDOW_ID;
  
  import android.os.Bundle;
  import android.os.Parcel;
  import android.os.Parcelable;
  import android.text.ParcelableSpan;
  import android.text.Spanned;
  import android.text.TextUtils;
  import android.view.View;
  import android.view.accessibility.AccessibilityInteractionClient;
  import android.view.accessibility.AccessibilityNodeInfo;
  
  import com.android.internal.R;
  
  /**
   * {@link ClickableSpan} cannot be parceled, but accessibility services need to be able to cause
   * their callback handlers to be called. This class serves as a parcelable placeholder for the
   * real spans.
   *
   * This span is also passed back to an app's process when an accessibility service tries to click
   * it. It contains enough information to track down the original clickable span so it can be
   * called.
   *
   * @hide
   */
  public class AccessibilityClickableSpan extends ClickableSpan
          implements ParcelableSpan {
      // The id of the span this one replaces
      private final int mOriginalClickableSpanId;
  
      private int mWindowId = UNDEFINED_WINDOW_ID;
      private long mSourceNodeId = UNDEFINED_NODE_ID;
      private int mConnectionId = UNDEFINED_CONNECTION_ID;
  
      /**
       * @param originalClickableSpanId The id of the span this one replaces
       */
      public AccessibilityClickableSpan(int originalClickableSpanId) {
          mOriginalClickableSpanId = originalClickableSpanId;
      }
  
      public AccessibilityClickableSpan(Parcel p) {
          mOriginalClickableSpanId = p.readInt();
      }
  
      @Override
      public int getSpanTypeId() {
          return getSpanTypeIdInternal();
      }
  
      @Override
      public int getSpanTypeIdInternal() {
          return TextUtils.ACCESSIBILITY_CLICKABLE_SPAN;
      }
  
      @Override
      public int describeContents() {
          return 0;
      }
  
      @Override
      public void writeToParcel(Parcel dest, int flags) {
          writeToParcelInternal(dest, flags);
      }
  
      @Override
      public void writeToParcelInternal(Parcel dest, int flags) {
          dest.writeInt(mOriginalClickableSpanId);
      }
  
      /**
       * Find the ClickableSpan that matches the one used to create this object.
       *
       * @param text The text that contains the original ClickableSpan.
       * @return The ClickableSpan that matches this object, or {@code null} if no such object
       * can be found.
       */
      public ClickableSpan findClickableSpan(CharSequence text) {
          if (!(text instanceof Spanned)) {
              return null;
          }
          Spanned sp = (Spanned) text;
          ClickableSpan[] os = sp.getSpans(0, text.length(), ClickableSpan.class);
          for (int i = 0; i < os.length; i++) {
              if (os[i].getId() == mOriginalClickableSpanId) {
                  return os[i];
              }
          }
          return null;
      }
  
      /**
       * Configure this object to perform clicks on the view that contains the original span.
       *
       * @param accessibilityNodeInfo The info corresponding to the view containing the original
       *                              span.
       */
      public void copyConnectionDataFrom(AccessibilityNodeInfo accessibilityNodeInfo) {
          mConnectionId = accessibilityNodeInfo.getConnectionId();
          mWindowId = accessibilityNodeInfo.getWindowId();
          mSourceNodeId = accessibilityNodeInfo.getSourceNodeId();
      }
  
      /**
       * Perform the click from an accessibility service. Will not work unless
       * setAccessibilityNodeInfo is called with a properly initialized node.
       *
       * @param unused This argument is required by the superclass but is unused. The real view will
       * be determined by the AccessibilityNodeInfo.
       */
      @Override
      public void onClick(View unused) {
          Bundle arguments = new Bundle();
          arguments.putParcelable(ACTION_ARGUMENT_ACCESSIBLE_CLICKABLE_SPAN, this);
  
          if ((mWindowId == UNDEFINED_WINDOW_ID) || (mSourceNodeId == UNDEFINED_NODE_ID)
                  || (mConnectionId == UNDEFINED_CONNECTION_ID)) {
              throw new RuntimeException(
                      "ClickableSpan for accessibility service not properly initialized");
          }
  
          AccessibilityInteractionClient client = AccessibilityInteractionClient.getInstance();
          client.performAccessibilityAction(mConnectionId, mWindowId, mSourceNodeId,
                  R.id.accessibilityActionClickOnClickableSpan, arguments);
      }
  
      public static final @android.annotation.NonNull Parcelable.Creator<AccessibilityClickableSpan> CREATOR =
              new Parcelable.Creator<AccessibilityClickableSpan>() {
                  @Override
                  public AccessibilityClickableSpan createFromParcel(Parcel parcel) {
                      return new AccessibilityClickableSpan(parcel);
                  }
  
                  @Override
                  public AccessibilityClickableSpan[] newArray(int size) {
                      return new AccessibilityClickableSpan[size];
                  }
              };
  }
  