19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2006 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.text; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the interface for text to which markup objects can be 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached and detached. Not all Spannable classes have mutable text; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * see {@link Editable} for that. 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic interface Spannable 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectextends Spanned 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project{ 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Attach the specified markup object to the range <code>start…end</code> 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the text, or move the object to that range if it was already 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached elsewhere. See {@link Spanned} for an explanation of 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * what the flags mean. The object can be one that has meaning only 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within your application, or it can be one that the text system will 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * use to affect text display or behavior. Some noteworthy ones are 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the subclasses of {@link android.text.style.CharacterStyle} and 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.text.style.ParagraphStyle}, and 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.text.TextWatcher} and 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.text.SpanWatcher}. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setSpan(Object what, int start, int end, int flags); 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified object from the range of text to which it 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * was attached, if any. It is OK to remove an object that was never 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * attached in the first place. 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void removeSpan(Object what); 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Factory used by TextView to create new Spannables. You can subclass 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it to provide something other than SpannableString. 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static class Factory { 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static Spannable.Factory sInstance = new Spannable.Factory(); 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the standard Spannable Factory. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static Spannable.Factory getInstance() { 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sInstance; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns a new SpannableString from the specified CharSequence. 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You can override this to provide a different kind of Spannable. 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Spannable newSpannable(CharSequence source) { 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new SpannableString(source); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 71