Build 1.0_r1(from source)

android.text
Interface Editable

All Superinterfaces:
Appendable, CharSequence, GetChars, Spannable, Spanned
All Known Implementing Classes:
SpannableStringBuilder

public interface Editable
extends CharSequence, GetChars, Spannable, Appendable

This is the interface for text whose content and markup can be changed (as opposed to immutable text like Strings). If you make a DynamicLayout of an Editable, the layout will be reflowed as the text is changed.


Nested Class Summary
static class Editable.Factory
          Factory used by TextView to create new Editables.
 
Field Summary
 
Fields inherited from interface android.text.Spanned
SPAN_EXCLUSIVE_EXCLUSIVE, SPAN_EXCLUSIVE_INCLUSIVE, SPAN_INCLUSIVE_EXCLUSIVE, SPAN_INCLUSIVE_INCLUSIVE, SPAN_MARK_MARK, SPAN_MARK_POINT, SPAN_PARAGRAPH, SPAN_POINT_MARK, SPAN_POINT_POINT, SPAN_PRIORITY, SPAN_PRIORITY_SHIFT, SPAN_USER, SPAN_USER_SHIFT
 
Method Summary
 Editable append(char text)
          Convenience for append(String.valueOf(text)).
 Editable append(CharSequence text)
          Convenience for replace(length(), length(), text, 0, text.length())
 Editable append(CharSequence text, int start, int end)
          Convenience for replace(length(), length(), text, start, end)
 void clear()
          Convenience for replace(0, length(), "", 0, 0)
 void clearSpans()
          Removes all spans from the Editable, as if by calling Spannable.removeSpan(java.lang.Object) on each of them.
 Editable delete(int st, int en)
          Convenience for replace(st, en, "", 0, 0)
 InputFilter[] getFilters()
          Returns the array of input filters that are currently applied to changes to this Editable.
 Editable insert(int where, CharSequence text)
          Convenience for replace(where, where, text, 0, text.length());
 Editable insert(int where, CharSequence text, int start, int end)
          Convenience for replace(where, where, text, start, end)
 Editable replace(int st, int en, CharSequence text)
          Convenience for replace(st, en, text, 0, text.length())
 Editable replace(int st, int en, CharSequence source, int start, int end)
          Replaces the specified range (st…en) of text in this Editable with a copy of the slice start…end from source.
 void setFilters(InputFilter[] filters)
          Sets the series of filters that will be called in succession whenever the text of this Editable is changed, each of which has the opportunity to limit or transform the text that is being inserted.
 
Methods inherited from interface android.text.GetChars
getChars
 
Methods inherited from interface android.text.Spannable
removeSpan, setSpan
 
Methods inherited from interface android.text.Spanned
getSpanEnd, getSpanFlags, getSpans, getSpanStart, nextSpanTransition
 
Methods inherited from interface java.lang.CharSequence
charAt, length, subSequence, toString
 

Method Detail

replace

Editable replace(int st,
                 int en,
                 CharSequence source,
                 int start,
                 int end)
Replaces the specified range (st…en) of text in this Editable with a copy of the slice start…end from source. The destination slice may be empty, in which case the operation is an insertion, or the source slice may be empty, in which case the operation is a deletion.

Before the change is committed, each filter that was set with setFilters(android.text.InputFilter[]) is given the opportunity to modify the source text.

If source is Spanned, the spans from it are preserved into the Editable. Existing spans within the Editable that entirely cover the replaced range are retained, but any that were strictly within the range that was replaced are removed. As a special case, the cursor position is preserved even when the entire range where it is located is replaced.

Returns:
a reference to this object.

replace

Editable replace(int st,
                 int en,
                 CharSequence text)
Convenience for replace(st, en, text, 0, text.length())

See Also:
replace(int, int, CharSequence, int, int)

insert

Editable insert(int where,
                CharSequence text,
                int start,
                int end)
Convenience for replace(where, where, text, start, end)

See Also:
replace(int, int, CharSequence, int, int)

insert

Editable insert(int where,
                CharSequence text)
Convenience for replace(where, where, text, 0, text.length());

See Also:
replace(int, int, CharSequence, int, int)

delete

Editable delete(int st,
                int en)
Convenience for replace(st, en, "", 0, 0)

See Also:
replace(int, int, CharSequence, int, int)

append

Editable append(CharSequence text)
Convenience for replace(length(), length(), text, 0, text.length())

Specified by:
append in interface Appendable
Parameters:
text - the CharSequence to be append
Returns:
this Appendable
See Also:
replace(int, int, CharSequence, int, int)

append

Editable append(CharSequence text,
                int start,
                int end)
Convenience for replace(length(), length(), text, start, end)

Specified by:
append in interface Appendable
Parameters:
text - the CharSequence to be append
start - the index to spicify the start position of CharSequence to be append, must be non-negative, and not larger than the end
end - the index to speicify the end position of CharSequence to be append, must be non-negative, and not larger than the size of csq
Returns:
this Appendable
See Also:
replace(int, int, CharSequence, int, int)

append

Editable append(char text)
Convenience for append(String.valueOf(text)).

Specified by:
append in interface Appendable
Parameters:
text - the character to append
Returns:
this Appendable
See Also:
replace(int, int, CharSequence, int, int)

clear

void clear()
Convenience for replace(0, length(), "", 0, 0)

See Also:
Note that this clears the text, not the spans; use {@link #clearSpans} if you need that.

clearSpans

void clearSpans()
Removes all spans from the Editable, as if by calling Spannable.removeSpan(java.lang.Object) on each of them.


setFilters

void setFilters(InputFilter[] filters)
Sets the series of filters that will be called in succession whenever the text of this Editable is changed, each of which has the opportunity to limit or transform the text that is being inserted.


getFilters

InputFilter[] getFilters()
Returns the array of input filters that are currently applied to changes to this Editable.


Build 1.0_r1(from source)

Please submit a feedback, bug or feature