summaryrefslogtreecommitdiffstats
path: root/location/java/android/location/SettingInjectorService.java
diff options
context:
space:
mode:
Diffstat (limited to 'location/java/android/location/SettingInjectorService.java')
-rw-r--r--location/java/android/location/SettingInjectorService.java9
1 files changed, 8 insertions, 1 deletions
diff --git a/location/java/android/location/SettingInjectorService.java b/location/java/android/location/SettingInjectorService.java
index 4bfa150..dbc3f27 100644
--- a/location/java/android/location/SettingInjectorService.java
+++ b/location/java/android/location/SettingInjectorService.java
@@ -176,8 +176,15 @@ public abstract class SettingInjectorService extends IntentService {
/**
* Constructor.
+ * <p/>
+ * Note that to prevent churn in the settings list, there is no support for dynamically
+ * choosing to hide a setting. Instead you should provide a {@code enabled} value of false,
+ * which will gray the setting out and disable the link from "Settings > Location"
+ * to your setting activity. One reason why you might choose to do this is if
+ * {@link android.provider.Settings.Secure#getLocationMode(android.content.ContentResolver)}
+ * is {@link android.provider.Settings.Secure#LOCATION_MODE_OFF}.
*
- * @param summary the {@link Preference#getSummary()} value
+ * @param summary the {@link Preference#getSummary()} value (allowed to be null or empty)
* @param enabled the {@link Preference#isEnabled()} value
*/
public Status(String summary, boolean enabled) {