|
24 | 24 | * <p> |
25 | 25 | * This annotation is intended to be used on methods to receive events defined |
26 | 26 | * by |
27 | | - * {@link android.preference.Preference.OnPreferenceChangeListener#onPreferenceChange(android.preference.Preference, Object) |
28 | | - * OnPreferenceChangeListener#onPreferenceChange} when the value of a |
29 | | - * {@link android.preference.Preference Preference} has been changed by the user |
30 | | - * and is about to be set and/or persisted. |
| 27 | + * <code>OnPreferenceChangeListener#onPreferenceChange(Preference, Object)</code> |
| 28 | + * when the value of a <code>Preference</code> has been changed by the user and |
| 29 | + * is about to be set and/or persisted. |
31 | 30 | * </p> |
32 | 31 | * <p> |
33 | 32 | * The annotation value should be one or several R.string.* fields that refers |
34 | 33 | * to {@link android.preference.Preference Preference} or subclasses of |
35 | | - * {@link android.preference.Preference Preference}. If not set, the method name |
36 | | - * will be used as the R.string.* field name. |
| 34 | + * {@link android.preference.Preference Preference} or |
| 35 | + * <code>android.support.v7.preference.Preference</code> or subclasses of |
| 36 | + * <code>android.support.v7.preference.Preference</code>. If not set, the method |
| 37 | + * name will be used as the R.string.* field name. This annotation only can be |
| 38 | + * used inside {@link org.androidannotations.annotations.EActivity EActivity} or |
| 39 | + * {@link org.androidannotations.annotations.EFragment EFragment} annotated |
| 40 | + * class, which is a subclass of {@link android.preference.PreferenceActivity |
| 41 | + * PreferenceActivity} or <code>PreferenceFragment(Compat)</code>, respectively. |
37 | 42 | * </p> |
38 | 43 | * <p> |
39 | 44 | * The method MAY have multiple parameter: |
40 | 45 | * </p> |
41 | 46 | * <ul> |
42 | | - * <li>A {@link android.preference.Preference Preference} (or a sublcass) |
| 47 | + * <li>A {@link android.preference.Preference Preference} (or a subclass) or |
| 48 | + * <code>android.support.v7.preference.Preference</code> (or a subclass) |
43 | 49 | * parameter to know which preference was targeted by this event</li> |
44 | 50 | * <li>An {@link Object}, {@link String}, {@link java.util.Set Set of strings} |
45 | 51 | * and also a {@link Boolean}, {@link Float}, {@link Integer}, {@link Long} or |
46 | 52 | * their corresponding primitive types to obtain the new value of the |
47 | | - * {@link android.preference.Preference Preference}. Please note with number |
48 | | - * types, we assume that the <code>newValue</code> parameter coming from the |
49 | | - * {@link android.preference.Preference Preference} is a {@link String}, so we |
50 | | - * parse it to a number object (Android {@link android.preference.Preference |
51 | | - * Preference} classes use {@link String}s instead of number objects).</li> |
| 53 | + * <code>Preference</code>. Please note with number types, we assume that the |
| 54 | + * <code>newValue</code> parameter coming from the <code>Preference</code> is a |
| 55 | + * {@link String}, so we parse it to a number object (Android |
| 56 | + * <code>Preference</code> classes use {@link String}s instead of number |
| 57 | + * objects).</li> |
52 | 58 | * </ul> |
53 | 59 | * <blockquote> |
54 | 60 | * |
|
0 commit comments