]> git.ktnx.net Git - mobile-ledger.git/blob - app/src/main/java/net/ktnx/mobileledger/SettingsActivity.java
replace add account floating action button with a menu item
[mobile-ledger.git] / app / src / main / java / net / ktnx / mobileledger / SettingsActivity.java
1 package net.ktnx.mobileledger;
2
3 import android.annotation.TargetApi;
4 import android.content.Context;
5 import android.content.Intent;
6 import android.content.res.Configuration;
7 import android.media.Ringtone;
8 import android.media.RingtoneManager;
9 import android.net.Uri;
10 import android.os.Build;
11 import android.os.Bundle;
12 import android.preference.ListPreference;
13 import android.preference.Preference;
14 import android.preference.PreferenceActivity;
15 import android.preference.PreferenceFragment;
16 import android.preference.PreferenceManager;
17 import android.preference.RingtonePreference;
18 import android.support.v4.app.NavUtils;
19 import android.support.v7.app.ActionBar;
20 import android.text.TextUtils;
21 import android.view.MenuItem;
22
23 import java.util.List;
24
25 /**
26  * A {@link PreferenceActivity} that presents a set of application settings. On
27  * handset devices, settings are presented as a single list. On tablets,
28  * settings are split by category, with category headers shown to the left of
29  * the list of settings.
30  * <p>
31  * See <a href="http://developer.android.com/design/patterns/settings.html">
32  * Android Design: Settings</a> for design guidelines and the <a
33  * href="http://developer.android.com/guide/topics/ui/settings.html">Settings
34  * API Guide</a> for more information on developing a Settings UI.
35  */
36 public class SettingsActivity extends AppCompatPreferenceActivity {
37
38     /**
39      * A preference value change listener that updates the preference's summary
40      * to reflect its new value.
41      */
42     private static Preference.OnPreferenceChangeListener sBindPreferenceSummaryToValueListener = new Preference.OnPreferenceChangeListener() {
43         @Override
44         public boolean onPreferenceChange(Preference preference, Object value) {
45             String stringValue = value.toString();
46
47             if (preference instanceof ListPreference) {
48                 // For list preferences, look up the correct display value in
49                 // the preference's 'entries' list.
50                 ListPreference listPreference = (ListPreference) preference;
51                 int index = listPreference.findIndexOfValue(stringValue);
52
53                 // Set the summary to reflect the new value.
54                 preference.setSummary(
55                         index >= 0
56                                 ? listPreference.getEntries()[index]
57                                 : null);
58
59             } else if (preference instanceof RingtonePreference) {
60                 // For ringtone preferences, look up the correct display value
61                 // using RingtoneManager.
62                 if (TextUtils.isEmpty(stringValue)) {
63                     // Empty values correspond to 'silent' (no ringtone).
64                     preference.setSummary(R.string.pref_ringtone_silent);
65
66                 } else {
67                     Ringtone ringtone = RingtoneManager.getRingtone(
68                             preference.getContext(), Uri.parse(stringValue));
69
70                     if (ringtone == null) {
71                         // Clear the summary if there was a lookup error.
72                         preference.setSummary(null);
73                     } else {
74                         // Set the summary to reflect the new ringtone display
75                         // name.
76                         String name = ringtone.getTitle(preference.getContext());
77                         preference.setSummary(name);
78                     }
79                 }
80             } else {
81                 // For all other preferences, set the summary to the value's
82                 // simple string representation.
83                 preference.setSummary(stringValue);
84             }
85             return true;
86         }
87     };
88
89     /**
90      * Helper method to determine if the device has an extra-large screen. For
91      * example, 10" tablets are extra-large.
92      */
93     private static boolean isXLargeTablet(Context context) {
94         return (context.getResources().getConfiguration().screenLayout
95                 & Configuration.SCREENLAYOUT_SIZE_MASK) >= Configuration.SCREENLAYOUT_SIZE_XLARGE;
96     }
97
98     /**
99      * Binds a preference's summary to its value. More specifically, when the
100      * preference's value is changed, its summary (line of text below the
101      * preference title) is updated to reflect the value. The summary is also
102      * immediately updated upon calling this method. The exact display format is
103      * dependent on the type of preference.
104      *
105      * @see #sBindPreferenceSummaryToValueListener
106      */
107     private static void bindPreferenceSummaryToValue(Preference preference) {
108         // Set the listener to watch for value changes.
109         preference.setOnPreferenceChangeListener(sBindPreferenceSummaryToValueListener);
110
111         // Trigger the listener immediately with the preference's
112         // current value.
113         sBindPreferenceSummaryToValueListener.onPreferenceChange(preference,
114                 PreferenceManager
115                         .getDefaultSharedPreferences(preference.getContext())
116                         .getString(preference.getKey(), ""));
117     }
118
119     @Override
120     protected void onCreate(Bundle savedInstanceState) {
121         super.onCreate(savedInstanceState);
122         setupActionBar();
123     }
124
125     /**
126      * Set up the {@link android.app.ActionBar}, if the API is available.
127      */
128     private void setupActionBar() {
129         ActionBar actionBar = getSupportActionBar();
130         if (actionBar != null) {
131             // Show the Up button in the action bar.
132             actionBar.setDisplayHomeAsUpEnabled(true);
133         }
134     }
135
136     @Override
137     public boolean onMenuItemSelected(int featureId, MenuItem item) {
138         int id = item.getItemId();
139         if (id == android.R.id.home) {
140             if (!super.onMenuItemSelected(featureId, item)) {
141                 NavUtils.navigateUpFromSameTask(this);
142             }
143             return true;
144         }
145         return super.onMenuItemSelected(featureId, item);
146     }
147
148     /**
149      * {@inheritDoc}
150      */
151     @Override
152     public boolean onIsMultiPane() {
153         return isXLargeTablet(this);
154     }
155
156     /**
157      * {@inheritDoc}
158      */
159     @Override
160     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
161     public void onBuildHeaders(List<Header> target) {
162         loadHeadersFromResource(R.xml.pref_headers, target);
163     }
164
165     /**
166      * This method stops fragment injection in malicious applications.
167      * Make sure to deny any unknown fragments here.
168      */
169     protected boolean isValidFragment(String fragmentName) {
170         return PreferenceFragment.class.getName().equals(fragmentName)
171                 || BackendPreferenceFragment.class.getName().equals(fragmentName)
172                 || DataSyncPreferenceFragment.class.getName().equals(fragmentName)
173                 || NotificationPreferenceFragment.class.getName().equals(fragmentName);
174     }
175
176     /**
177      * This fragment shows general preferences only. It is used when the
178      * activity is showing a two-pane settings UI.
179      */
180     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
181     public static class BackendPreferenceFragment extends PreferenceFragment {
182         @Override
183         public void onCreate(Bundle savedInstanceState) {
184             super.onCreate(savedInstanceState);
185             addPreferencesFromResource(R.xml.pref_backend);
186             setHasOptionsMenu(true);
187
188             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
189             // to their values. When their values change, their summaries are
190             // updated to reflect the new value, per the Android Design
191             // guidelines.
192             bindPreferenceSummaryToValue(findPreference("backend_url"));
193             bindPreferenceSummaryToValue(findPreference("backend_auth_user"));
194
195         }
196
197         @Override
198         public boolean onOptionsItemSelected(MenuItem item) {
199             int id = item.getItemId();
200             if (id == android.R.id.home) {
201                 startActivity(new Intent(getActivity(), SettingsActivity.class));
202                 return true;
203             }
204             return super.onOptionsItemSelected(item);
205         }
206     }
207
208     /**
209      * This fragment shows notification preferences only. It is used when the
210      * activity is showing a two-pane settings UI.
211      */
212     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
213     public static class NotificationPreferenceFragment extends PreferenceFragment {
214         @Override
215         public void onCreate(Bundle savedInstanceState) {
216             super.onCreate(savedInstanceState);
217             addPreferencesFromResource(R.xml.pref_notification);
218             setHasOptionsMenu(true);
219
220             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
221             // to their values. When their values change, their summaries are
222             // updated to reflect the new value, per the Android Design
223             // guidelines.
224             bindPreferenceSummaryToValue(findPreference("notifications_new_message_ringtone"));
225         }
226
227         @Override
228         public boolean onOptionsItemSelected(MenuItem item) {
229             int id = item.getItemId();
230             if (id == android.R.id.home) {
231                 startActivity(new Intent(getActivity(), SettingsActivity.class));
232                 return true;
233             }
234             return super.onOptionsItemSelected(item);
235         }
236     }
237
238     /**
239      * This fragment shows data and sync preferences only. It is used when the
240      * activity is showing a two-pane settings UI.
241      */
242     @TargetApi(Build.VERSION_CODES.HONEYCOMB)
243     public static class DataSyncPreferenceFragment extends PreferenceFragment {
244         @Override
245         public void onCreate(Bundle savedInstanceState) {
246             super.onCreate(savedInstanceState);
247             addPreferencesFromResource(R.xml.pref_data_sync);
248             setHasOptionsMenu(true);
249
250             // Bind the summaries of EditText/List/Dialog/Ringtone preferences
251             // to their values. When their values change, their summaries are
252             // updated to reflect the new value, per the Android Design
253             // guidelines.
254             bindPreferenceSummaryToValue(findPreference("sync_frequency"));
255         }
256
257         @Override
258         public boolean onOptionsItemSelected(MenuItem item) {
259             int id = item.getItemId();
260             if (id == android.R.id.home) {
261                 startActivity(new Intent(getActivity(), SettingsActivity.class));
262                 return true;
263             }
264             return super.onOptionsItemSelected(item);
265         }
266     }
267 }