diff options
author | Tom O'Neill <tomo@google.com> | 2013-08-22 14:28:12 -0700 |
---|---|---|
committer | Tom O'Neill <tomo@google.com> | 2013-08-22 14:28:12 -0700 |
commit | c8211ea1cc65560938c31263edce6fcb87016acb (patch) | |
tree | 75a6222f9d839bfa72292e85a051707baed27bc4 /location/java | |
parent | 83208e34f6a0381d5627886dbf98ff8f313e590f (diff) | |
download | frameworks_base-c8211ea1cc65560938c31263edce6fcb87016acb.zip frameworks_base-c8211ea1cc65560938c31263edce6fcb87016acb.tar.gz frameworks_base-c8211ea1cc65560938c31263edce6fcb87016acb.tar.bz2 |
Add a little comment about the enabled value
Change-Id: I4ac0b864f55992242b6a3b0d8ffb328f23f6b645
Diffstat (limited to 'location/java')
-rw-r--r-- | location/java/android/location/SettingInjectorService.java | 9 |
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) { |