1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/*
* 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 whose content and markup
* can be changed (as opposed
* to immutable text like Strings). If you make a {@link DynamicLayout}
* of an Editable, the layout will be reflowed as the text is changed.
*/
public interface Editable
extends CharSequence, GetChars, Spannable, Appendable
{
/**
* Replaces the specified range (<code>st…en</code>) of text in this
* Editable with a copy of the slice <code>start…end</code> from
* <code>source</code>. 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.
* <p>
* Before the change is committed, each filter that was set with
* {@link #setFilters} is given the opportunity to modify the
* <code>source</code> text.
* <p>
* If <code>source</code>
* 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.
* @return a reference to this object.
*/
public Editable replace(int st, int en, CharSequence source, int start, int end);
/**
* Convenience for replace(st, en, text, 0, text.length())
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable replace(int st, int en, CharSequence text);
/**
* Convenience for replace(where, where, text, start, end)
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable insert(int where, CharSequence text, int start, int end);
/**
* Convenience for replace(where, where, text, 0, text.length());
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable insert(int where, CharSequence text);
/**
* Convenience for replace(st, en, "", 0, 0)
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable delete(int st, int en);
/**
* Convenience for replace(length(), length(), text, 0, text.length())
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable append(CharSequence text);
/**
* Convenience for replace(length(), length(), text, start, end)
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable append(CharSequence text, int start, int end);
/**
* Convenience for append(String.valueOf(text)).
* @see #replace(int, int, CharSequence, int, int)
*/
public Editable append(char text);
/**
* Convenience for replace(0, length(), "", 0, 0)
* @see #replace(int, int, CharSequence, int, int)
* Note that this clears the text, not the spans;
* use {@link #clearSpans} if you need that.
*/
public void clear();
/**
* Removes all spans from the Editable, as if by calling
* {@link #removeSpan} on each of them.
*/
public void clearSpans();
/**
* 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.
*/
public void setFilters(InputFilter[] filters);
/**
* Returns the array of input filters that are currently applied
* to changes to this Editable.
*/
public InputFilter[] getFilters();
/**
* Factory used by TextView to create new Editables. You can subclass
* it to provide something other than SpannableStringBuilder.
*/
public static class Factory {
private static Editable.Factory sInstance = new Editable.Factory();
/**
* Returns the standard Editable Factory.
*/
public static Editable.Factory getInstance() {
return sInstance;
}
/**
* Returns a new SpannedStringBuilder from the specified
* CharSequence. You can override this to provide
* a different kind of Spanned.
*/
public Editable newEditable(CharSequence source) {
return new SpannableStringBuilder(source);
}
}
}
|
