content: /*
   * Copyright (C) 2006 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;
  
  /**
   * This is the interface for text to which markup objects can be
   * attached and detached.  Not all Spannable classes have mutable text;
   * see {@link Editable} for that.
   */
  public interface Spannable
  extends Spanned
  {
      /**
       * Attach the specified markup object to the range <code>start&hellip;end</code>
       * of the text, or move the object to that range if it was already
       * attached elsewhere.  See {@link Spanned} for an explanation of
       * what the flags mean.  The object can be one that has meaning only
       * within your application, or it can be one that the text system will
       * use to affect text display or behavior.  Some noteworthy ones are
       * the subclasses of {@link android.text.style.CharacterStyle} and
       * {@link android.text.style.ParagraphStyle}, and
       * {@link android.text.TextWatcher} and
       * {@link android.text.SpanWatcher}.
       */
      public void setSpan(Object what, int start, int end, int flags);
  
      /**
       * Remove the specified object from the range of text to which it
       * was attached, if any.  It is OK to remove an object that was never
       * attached in the first place.
       */
      public void removeSpan(Object what);
  
      /**
       * Remove the specified object from the range of text to which it
       * was attached, if any.  It is OK to remove an object that was never
       * attached in the first place.
       *
       * See {@link Spanned} for an explanation of what the flags mean.
       *
       * @hide
       */
      default void removeSpan(Object what, int flags) {
          removeSpan(what);
      }
  
      /**
       * Factory used by TextView to create new {@link Spannable Spannables}. You can subclass
       * it to provide something other than {@link SpannableString}.
       *
       * @see android.widget.TextView#setSpannableFactory(Factory)
       */
      public static class Factory {
          private static Spannable.Factory sInstance = new Spannable.Factory();
  
          /**
           * Returns the standard Spannable Factory.
           */
          public static Spannable.Factory getInstance() {
              return sInstance;
          }
  
          /**
           * Returns a new SpannableString from the specified CharSequence.
           * You can override this to provide a different kind of Spannable.
           */
          public Spannable newSpannable(CharSequence source) {
              return new SpannableString(source);
          }
      }
  }
  