a_vcard.android.text
Interface Editable

All Superinterfaces:
java.lang.Appendable, java.lang.CharSequence, GetChars
All Known Implementing Classes:
SpannableStringBuilder

public interface Editable
extends java.lang.CharSequence, GetChars, java.lang.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.
 
Method Summary
 Editable append(char text)
          Convenience for append(String.valueOf(text)).
 Editable append(java.lang.CharSequence text)
          Convenience for replace(length(), length(), text, 0, text.length())
 Editable append(java.lang.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 #removeSpan 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, java.lang.CharSequence text)
          Convenience for replace(where, where, text, 0, text.length());
 Editable insert(int where, java.lang.CharSequence text, int start, int end)
          Convenience for replace(where, where, text, start, end)
 Editable replace(int st, int en, java.lang.CharSequence text)
          Convenience for replace(st, en, text, 0, text.length())
 Editable replace(int st, int en, java.lang.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 a_vcard.android.text.GetChars
getChars
 
Methods inherited from interface java.lang.CharSequence
charAt, length, subSequence, toString
 

Method Detail

replace

Editable replace(int st,
                 int en,
                 java.lang.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(a_vcard.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,
                 java.lang.CharSequence text)
Convenience for replace(st, en, text, 0, text.length())

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

insert

Editable insert(int where,
                java.lang.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,
                java.lang.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(java.lang.CharSequence text)
Convenience for replace(length(), length(), text, 0, text.length())

Specified by:
append in interface java.lang.Appendable
See Also:
replace(int, int, CharSequence, int, int)

append

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

Specified by:
append in interface java.lang.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 java.lang.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 #removeSpan 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.