19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2007 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.preference; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlisimport android.animation.LayoutTransition; 203c32b620448673dd47f869e2029e12b72ee21ed1Scott Kennedyimport android.annotation.Nullable; 217b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbyeimport android.annotation.StringRes; 227b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbyeimport android.annotation.XmlRes; 23b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.app.Fragment; 24c6669ca63299219d815464129dac051ab2404286Dianne Hackbornimport android.app.FragmentBreadCrumbs; 253a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackbornimport android.app.FragmentManager; 26aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.app.FragmentTransaction; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.ListActivity; 28b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.Context; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 3050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.content.res.Resources; 31b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.TypedArray; 32b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.XmlResourceParser; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 36a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcel; 37a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcelable; 3819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.text.TextUtils; 39b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.AttributeSet; 4050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.util.TypedValue; 41b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.Xml; 42b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.view.LayoutInflater; 436af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlisimport android.view.MenuItem; 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 45405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport android.view.View.OnClickListener; 4639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport android.view.ViewGroup; 47a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.widget.AbsListView; 48b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ArrayAdapter; 4939725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport android.widget.BaseAdapter; 5019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.widget.Button; 515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackbornimport android.widget.FrameLayout; 52b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ImageView; 53b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ListView; 54b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.TextView; 55b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 5639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport com.android.internal.util.XmlUtils; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 58405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport org.xmlpull.v1.XmlPullParser; 59405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport org.xmlpull.v1.XmlPullParserException; 60405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani 6139725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.io.IOException; 6239725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.util.ArrayList; 6339725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.util.List; 6439725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 66b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * This is the base class for an activity to show a hierarchy of preferences 67b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to the user. Prior to {@link android.os.Build.VERSION_CODES#HONEYCOMB} 68b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * this class only allowed the display of a single set of preference; this 69b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * functionality should now be found in the new {@link PreferenceFragment} 70b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * class. If you are using PreferenceActivity in its old mode, the documentation 71b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * there applies to the deprecated APIs here. 72b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 7339725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * <p>This activity shows one or more headers of preferences, each of which 74b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * is associated with a {@link PreferenceFragment} to display the preferences 75b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of that header. The actual layout and display of these associations can 76b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * however vary; currently there are two major approaches it may take: 77b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 78b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 796af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis * <li>On a small screen it may display only the headers as a single list when first launched. 806af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis * Selecting one of the header items will only show the PreferenceFragment of that header (on 816af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis * Android N and lower a new Activity is launched). 826af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis * <li>On a large screen in may display both the headers and current PreferenceFragment together as 836af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis * panes. Selecting a header item switches to showing the correct PreferenceFragment for that item. 84b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 85b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 86b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Subclasses of PreferenceActivity should implement 87b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@link #onBuildHeaders} to populate the header list with the desired 88b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * items. Doing this implicitly switches the class into its new "headers 89b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * + fragments" mode rather than the old style of just showing a single 90b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preferences list. 9161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis * 92cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <div class="special reference"> 93cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <h3>Developer Guides</h3> 94cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <p>For information about using {@code PreferenceActivity}, 95cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * read the <a href="{@docRoot}guide/topics/ui/settings.html">Settings</a> 96cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * guide.</p> 97cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * </div> 98b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 99b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <a name="SampleCode"></a> 100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <h3>Sample Code</h3> 101b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 102b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The following sample code shows a simple preference activity that 103b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * has two different sets of preferences. The implementation, consisting 104b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of the activity itself as well as its two preference fragments is:</p> 105b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 106b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/preference/PreferenceWithHeaders.java 107b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity} 10819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 109b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The preference_headers resource describes the headers to be displayed 110b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and the fragments associated with them. It is: 111b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 112b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/preference_headers.xml headers} 113b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 114b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>The first header is shown by Prefs1Fragment, which populates itself 115b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * from the following XML resource:</p> 116b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 117b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/fragmented_preferences.xml preferences} 118b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 119b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>Note that this XML resource contains a preference screen holding another 120b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment, the Prefs1FragmentInner implemented here. This allows the user 121b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * to traverse down a hierarchy of preferences; pressing back will pop each 122b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment off the stack to return to the previous preferences. 123b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 124b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>See {@link PreferenceFragment} for information on implementing the 125b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * fragments themselves. 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class PreferenceActivity extends ListActivity implements 128b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceManager.OnPreferenceTreeClickListener, 129b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceFragment.OnPreferenceStartFragmentCallback { 13019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1318fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov private static final String TAG = "PreferenceActivity"; 1328fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov 133a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Constants for state save/restore 134a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String HEADERS_TAG = ":android:headers"; 135a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String CUR_HEADER_TAG = ":android:cur_header"; 136a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String PREFERENCES_TAG = ":android:preferences"; 13719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 138b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 139b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * string to specify which fragment should be initially displayed. 141364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * <p/>Starting from Key Lime Pie, when this argument is passed in, the PreferenceActivity 142364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * will call isValidFragment() to confirm that the fragment class name is valid for this 143364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * activity. 144b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 145b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT = ":android:show_fragment"; 146b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 147b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 148b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 149e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specified to supply a Bundle of arguments to pass 150b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to that fragment when it is instantiated during the initial creation 151b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * of PreferenceActivity. 152b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 153b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":android:show_fragment_args"; 154b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 155b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 156e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 157e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the title to be shown for 158e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 159e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 160e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_TITLE = ":android:show_fragment_title"; 161e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 162e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 163e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 164e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the short title to be shown for 165e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 166e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 167e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_SHORT_TITLE 168e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn = ":android:show_fragment_short_title"; 169e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 170e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 171b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 172b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * boolean that the header list should not be displayed. This is most often 173b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * used in conjunction with {@link #EXTRA_SHOW_FRAGMENT} to launch 174b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * the activity to display a specific fragment that the user has navigated 175b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to. 176b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 177b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_NO_HEADERS = ":android:no_headers"; 178b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 179b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn private static final String BACK_STACK_PREFS = ":android:prefs"; 180b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 18119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // extras that allow any preference activity to be launched as part of a wizard 18219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 18319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // show Back and Next buttons? takes boolean parameter 18419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // Back will then return RESULT_CANCELED and Next RESULT_OK 18519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SHOW_BUTTON_BAR = "extra_prefs_show_button_bar"; 18619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 18709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng // add a Skip button? 18809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng private static final String EXTRA_PREFS_SHOW_SKIP = "extra_prefs_show_skip"; 18909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng 19019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // specify custom text for the Back or Next buttons, or cause a button to not appear 19119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // at all by setting it to null 19219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_NEXT_TEXT = "extra_prefs_set_next_text"; 19319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_BACK_TEXT = "extra_prefs_set_back_text"; 19419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 195b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for new mode when showing a list of headers + prefs fragment 196b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 197b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private final ArrayList<Header> mHeaders = new ArrayList<Header>(); 198b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1995c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn private FrameLayout mListFooter; 2005c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 2013c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani private ViewGroup mPrefsContainer; 202b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 203b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis // Backup of the original activity title. This is used when navigating back to the headers list 204b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis // in onBackPress to restore the title. 205b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis private CharSequence mActivityTitle; 206b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis 20761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // Null if in legacy mode. 20861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis private ViewGroup mHeadersContainer; 20961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 210c6669ca63299219d815464129dac051ab2404286Dianne Hackborn private FragmentBreadCrumbs mFragmentBreadCrumbs; 211c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 212b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private boolean mSinglePane; 213b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 214a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private Header mCurHeader; 215a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 216b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for old mode when showing a single preference list 21719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreferenceManager mPreferenceManager; 21919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 220e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell private Bundle mSavedInstanceState; 221e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 222b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- Common state 223b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 224b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private Button mNextButton; 225b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 226b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio private int mPreferenceHeaderItemResId = 0; 227b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio private boolean mPreferenceHeaderRemoveEmptyIcon = false; 228b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The starting request code given out to preference framework. 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int FIRST_REQUEST_CODE = 100; 23319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 2343e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BIND_PREFERENCES = 1; 2353e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BUILD_HEADERS = 2; 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Handler mHandler = new Handler() { 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 240a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BIND_PREFERENCES: { 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindPreferences(); 242a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 243a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BUILD_HEADERS: { 244a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> oldHeaders = new ArrayList<Header>(mHeaders); 245a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.clear(); 246b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn onBuildHeaders(mHeaders); 24739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne if (mAdapter instanceof BaseAdapter) { 24839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne ((BaseAdapter) mAdapter).notifyDataSetChanged(); 24983681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler } 2505c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn Header header = onGetNewHeader(); 2515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header != null && header.fragment != null) { 252a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(header, oldHeaders); 253a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader == null || mCurHeader != mappedHeader) { 254a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 255a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 256a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mCurHeader != null) { 257a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(mCurHeader, mHeaders); 258a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader != null) { 259a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mappedHeader); 260a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 2615c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 262a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 267468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderAdapter extends ArrayAdapter<Header> { 268468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderViewHolder { 269468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler ImageView icon; 270468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView title; 271468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView summary; 272468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private LayoutInflater mInflater; 275b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio private int mLayoutResId; 276b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio private boolean mRemoveIconIfEmpty; 277b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 278b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio public HeaderAdapter(Context context, List<Header> objects, int layoutResId, 279b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio boolean removeIconBehavior) { 280b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super(context, 0, objects); 281b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 282b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio mLayoutResId = layoutResId; 283b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio mRemoveIconIfEmpty = removeIconBehavior; 284b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 285b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 286b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 287b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public View getView(int position, View convertView, ViewGroup parent) { 288b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn HeaderViewHolder holder; 289b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn View view; 290b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 291b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (convertView == null) { 292b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio view = mInflater.inflate(mLayoutResId, parent, false); 293b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn holder = new HeaderViewHolder(); 294468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon); 295468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title = (TextView) view.findViewById(com.android.internal.R.id.title); 296468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary); 297b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view.setTag(holder); 298b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 299b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view = convertView; 300468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder = (HeaderViewHolder) view.getTag(); 301b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 302b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 30361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // All view fields must be updated every time, because the view may be recycled 304b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = getItem(position); 305b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio if (mRemoveIconIfEmpty) { 306b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio if (header.iconRes == 0) { 307b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio holder.icon.setVisibility(View.GONE); 308b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio } else { 309b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio holder.icon.setVisibility(View.VISIBLE); 310b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio holder.icon.setImageResource(header.iconRes); 311b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio } 312b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio } else { 313b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio holder.icon.setImageResource(header.iconRes); 314b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio } 31550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.title.setText(header.getTitle(getContext().getResources())); 31650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence summary = header.getSummary(getContext().getResources()); 31750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (!TextUtils.isEmpty(summary)) { 318468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.VISIBLE); 31950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setText(summary); 32050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 32150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setVisibility(View.GONE); 322468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 323b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 324b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return view; 325b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 326b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 327b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 328b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 329a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Default value for {@link Header#id Header.id} indicating that no 330a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * identifier value is set. All other values (including those below -1) 331a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * are valid. 332a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 333a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final long HEADER_ID_UNDEFINED = -1; 334364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani 335a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 336b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Description of a single Header item that the user can select. 337b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 338a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final class Header implements Parcelable { 339a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 340a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Identifier for this header, to correlate with a new list when 341a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * it is updated. The default value is 342a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * {@link PreferenceActivity#HEADER_ID_UNDEFINED}, meaning no id. 343a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_id 344a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 345a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public long id = HEADER_ID_UNDEFINED; 346a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 347b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 34850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of title of the header that is shown to the user. 34950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 35050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 3517b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes 35250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int titleRes; 35350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 35450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 355b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Title of the header that is shown to the user. 356b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 357b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 358468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence title; 359b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 360b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 36150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional summary describing what this header controls. 36250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 36350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 3647b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes 36550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int summaryRes; 36650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 36750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 368b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional summary describing what this header controls. 369b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 370b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 371468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence summary; 372b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 373b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 37450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the title in the bread crumb. 37550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 37650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 3777b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes 37850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbTitleRes; 37950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 38050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 381c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the title in the bread crumb. 382c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 383c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 384c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbTitle; 385c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 386c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 38750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the short title in the bread crumb. 38850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 38950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 3907b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes 39150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbShortTitleRes; 39250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 39350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 394c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the short title in the bread crumb. 395c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 396c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 397c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbShortTitle; 398c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 399c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 400b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional icon resource to show for this header. 401b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_icon 402b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 403468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public int iconRes; 404b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 405b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 406b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Full class name of the fragment to display when this header is 407b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * selected. 408b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_fragment 409b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 410468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public String fragment; 411b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 412b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 413b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Optional arguments to supply to the fragment when it is 414b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * instantiated. 415b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 416468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public Bundle fragmentArguments; 4175c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 4185c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 4195c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Intent to launch when the preference is selected. 4205c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 4215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Intent intent; 422a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 423a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 424a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Optional additional data for use by subclasses of PreferenceActivity. 425a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 426a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Bundle extras; 427a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 428a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header() { 42939725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Empty 430a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 431a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 43250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 43350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set title. If {@link #titleRes} is set, 43450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 43550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #title} is returned. 43650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 43750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getTitle(Resources res) { 43850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (titleRes != 0) { 43950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(titleRes); 44050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 44150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return title; 44250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 44350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 44450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 44550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set summary. If {@link #summaryRes} is set, 44650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 44750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #summary} is returned. 44850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 44950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getSummary(Resources res) { 45050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (summaryRes != 0) { 45150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(summaryRes); 45250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 4539d0718042f7c0a50d825c621f82ce9a92071f07aDianne Hackborn return summary; 45450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 45550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 45650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 45750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb title. If {@link #breadCrumbTitleRes} is set, 45850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 45950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbTitle} is returned. 46050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 46150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbTitle(Resources res) { 46250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbTitleRes != 0) { 46350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbTitleRes); 46450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 46550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbTitle; 46650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 46750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 46850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 46950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb short title. If 47050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitleRes} is set, 47150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 47250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitle} is returned. 47350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 47450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbShortTitle(Resources res) { 47550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbShortTitleRes != 0) { 47650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbShortTitleRes); 47750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 47850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbShortTitle; 47950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 48061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 481a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 482a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public int describeContents() { 483a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return 0; 484a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 485a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 486a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 487a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 488a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeLong(id); 48950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(titleRes); 490a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(title, dest, flags); 49150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(summaryRes); 492a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(summary, dest, flags); 49350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbTitleRes); 494c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbTitle, dest, flags); 49550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbShortTitleRes); 496c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbShortTitle, dest, flags); 497a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(iconRes); 498a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeString(fragment); 499a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(fragmentArguments); 500a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (intent != null) { 501a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(1); 502a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent.writeToParcel(dest, flags); 503a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 504a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(0); 505a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 506a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(extras); 507a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 508a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 509a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void readFromParcel(Parcel in) { 510a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn id = in.readLong(); 51150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn titleRes = in.readInt(); 512a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn title = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 51350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn summaryRes = in.readInt(); 514a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn summary = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 51550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbTitleRes = in.readInt(); 516c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 51750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbShortTitleRes = in.readInt(); 518c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbShortTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 519a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn iconRes = in.readInt(); 520a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragment = in.readString(); 521a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragmentArguments = in.readBundle(); 522a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (in.readInt() != 0) { 523a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent = Intent.CREATOR.createFromParcel(in); 524a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 525a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn extras = in.readBundle(); 526a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 527a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 528a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header(Parcel in) { 529a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn readFromParcel(in); 530a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 531a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 532a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final Creator<Header> CREATOR = new Creator<Header>() { 533a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header createFromParcel(Parcel source) { 534a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header(source); 535a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 536a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header[] newArray(int size) { 537a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header[size]; 538a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 539a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn }; 540b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 541b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5436af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis public boolean onOptionsItemSelected(MenuItem item) { 5446af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis if (item.getItemId() == android.R.id.home) { 5456af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis // Override home navigation button to call onBackPressed (b/35152749). 5466af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis onBackPressed(); 5476af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis return true; 5486af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis } 5496af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis return super.onOptionsItemSelected(item); 5506af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis } 5516af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis 5526af15ebcfec64d0cc6879a0af9cfffd3e084ee73Filip Pavlis @Override 5533c32b620448673dd47f869e2029e12b72ee21ed1Scott Kennedy protected void onCreate(@Nullable Bundle savedInstanceState) { 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 556b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio // Theming for the PreferenceActivity layout and for the Preference Header(s) layout 557b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio TypedArray sa = obtainStyledAttributes(null, 558b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.styleable.PreferenceActivity, 559b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.attr.preferenceActivityStyle, 560b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 0); 561b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 562b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio final int layoutResId = sa.getResourceId( 563b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.styleable.PreferenceActivity_layout, 564b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.layout.preference_list_content); 565b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 566b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio mPreferenceHeaderItemResId = sa.getResourceId( 567b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.styleable.PreferenceActivity_headerLayout, 568b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.layout.preference_header_item); 569b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio mPreferenceHeaderRemoveEmptyIcon = sa.getBoolean( 570b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio com.android.internal.R.styleable.PreferenceActivity_headerRemoveIconIfEmpty, 571b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio false); 572b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 573b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio sa.recycle(); 574b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio 575b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio setContentView(layoutResId); 57619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 5775c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter = (FrameLayout)findViewById(com.android.internal.R.id.list_footer); 5783c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs_frame); 57961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mHeadersContainer = (ViewGroup) findViewById(com.android.internal.R.id.headers); 580b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn boolean hidingHeaders = onIsHidingHeaders(); 581b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSinglePane = hidingHeaders || !onIsMultiPane(); 582b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn String initialFragment = getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT); 583b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn Bundle initialArguments = getIntent().getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS); 584e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_TITLE, 0); 585e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialShortTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, 0); 586b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis mActivityTitle = getTitle(); 587b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 588a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (savedInstanceState != null) { 589a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We are restarting from a previous saved state; used that to 590a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // initialize, instead of starting fresh. 591a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> headers = savedInstanceState.getParcelableArrayList(HEADERS_TAG); 592a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (headers != null) { 593a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.addAll(headers); 594a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int curHeader = savedInstanceState.getInt(CUR_HEADER_TAG, 59539725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne (int) HEADER_ID_UNDEFINED); 596a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (curHeader >= 0 && curHeader < mHeaders.size()) { 597a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mHeaders.get(curHeader)); 59861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else if (!mSinglePane && initialFragment == null) { 59961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis switchToHeader(onGetInitialHeader()); 600a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 60161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else { 60261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // This will for instance hide breadcrumbs for single pane. 60361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis showBreadCrumbs(getTitle(), null); 604a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 605b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 60661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (!onIsHidingHeaders()) { 607a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn onBuildHeaders(mHeaders); 60861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 609a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 61061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (initialFragment != null) { 61161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis switchToHeader(initialFragment, initialArguments); 61261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else if (!mSinglePane && mHeaders.size() > 0) { 61361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis switchToHeader(onGetInitialHeader()); 614a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 615a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 616b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 61761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mHeaders.size() > 0) { 618b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio setListAdapter(new HeaderAdapter(this, mHeaders, mPreferenceHeaderItemResId, 619b22be6fcf2689a7de3795f406678caf73180a990Fabrice Di Meglio mPreferenceHeaderRemoveEmptyIcon)); 620eadd5a90843c5fda9b1f973b6f133a9d2e9d984bFilip Pavlis if (!mSinglePane) { 621eadd5a90843c5fda9b1f973b6f133a9d2e9d984bFilip Pavlis getListView().setChoiceMode(AbsListView.CHOICE_MODE_SINGLE); 622eadd5a90843c5fda9b1f973b6f133a9d2e9d984bFilip Pavlis } 62361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 62461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 62561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mSinglePane && initialFragment != null && initialTitle != 0) { 62661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis CharSequence initialTitleStr = getText(initialTitle); 62761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis CharSequence initialShortTitleStr = initialShortTitle != 0 62861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis ? getText(initialShortTitle) : null; 62961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis showBreadCrumbs(initialTitleStr, initialShortTitleStr); 63061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 63161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 63261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mHeaders.size() == 0 && initialFragment == null) { 633b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // If there are no headers, we are in the old "just show a screen 634b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // of preferences" mode. 635405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani setContentView(com.android.internal.R.layout.preference_list_content_single); 6368da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mListFooter = (FrameLayout) findViewById(com.android.internal.R.id.list_footer); 6373c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs); 638a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager = new PreferenceManager(this, FIRST_REQUEST_CODE); 639a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager.setOnPreferenceTreeClickListener(this); 64061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mHeadersContainer = null; 64161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else if (mSinglePane) { 64261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // Single-pane so one of the header or prefs containers must be hidden. 64361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (initialFragment != null || mCurHeader != null) { 64461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mHeadersContainer.setVisibility(View.GONE); 64561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else { 64661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mPrefsContainer.setVisibility(View.GONE); 64761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 64861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 64961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // This animates our manual transitions between headers and prefs panel in single-pane. 65061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // It also comes last so we don't animate any initial layout changes done above. 65161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis ViewGroup container = (ViewGroup) findViewById( 65261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis com.android.internal.R.id.prefs_container); 65361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis container.setLayoutTransition(new LayoutTransition()); 65461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else { 65561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // Multi-pane 65661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mHeaders.size() > 0 && mCurHeader != null) { 65761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis setSelectedHeader(mCurHeader); 65861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 659b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 660b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 66119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // see if we should show Back/Next buttons 66219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Intent intent = getIntent(); 66319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_BUTTON_BAR, false)) { 66419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 66519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng findViewById(com.android.internal.R.id.button_bar).setVisibility(View.VISIBLE); 66619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 66719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Button backButton = (Button)findViewById(com.android.internal.R.id.back_button); 66819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setOnClickListener(new OnClickListener() { 66919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 67019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_CANCELED); 67119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 67219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 67319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 67409dbf1844016682ed461d080e32a43d0086e767dFreeman Ng Button skipButton = (Button)findViewById(com.android.internal.R.id.skip_button); 67509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setOnClickListener(new OnClickListener() { 67609dbf1844016682ed461d080e32a43d0086e767dFreeman Ng public void onClick(View v) { 67709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng setResult(RESULT_OK); 67809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng finish(); 67909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 68009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng }); 68119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton = (Button)findViewById(com.android.internal.R.id.next_button); 68219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setOnClickListener(new OnClickListener() { 68319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 68419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_OK); 68519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 68619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 68719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 68819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 68919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // set our various button parameters 69019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_NEXT_TEXT)) { 69119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_NEXT_TEXT); 69219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 69319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setVisibility(View.GONE); 69419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 69519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 69619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setText(buttonText); 69719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 69819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 69919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_BACK_TEXT)) { 70019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_BACK_TEXT); 70119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 70219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setVisibility(View.GONE); 70319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 70419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 70519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setText(buttonText); 70619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 70719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 70809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_SKIP, false)) { 70909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setVisibility(View.VISIBLE); 71009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 71119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 712b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 713b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 71461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis @Override 71561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis public void onBackPressed() { 71661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mCurHeader != null && mSinglePane && getFragmentManager().getBackStackEntryCount() == 0 71761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis && getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT) == null) { 71861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mCurHeader = null; 71961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 72061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mPrefsContainer.setVisibility(View.GONE); 72161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mHeadersContainer.setVisibility(View.VISIBLE); 722b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis if (mActivityTitle != null) { 723b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis showBreadCrumbs(mActivityTitle, null); 724b07c6f621aacc0141da0c4d24709f41197950d3bFilip Pavlis } 72561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis getListView().clearChoices(); 72661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else { 72761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis super.onBackPressed(); 72861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 72961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 73061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 731b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 732291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is currently showing the header list. 733291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 734291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean hasHeaders() { 73561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis return mHeadersContainer != null && mHeadersContainer.getVisibility() == View.VISIBLE; 736291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 737291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 738291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 739423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani * Returns the Header list 740423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani * @hide 741423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani */ 742423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani public List<Header> getHeaders() { 743423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani return mHeaders; 744423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani } 745423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani 746423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani /** 747291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is showing multiple panes -- the headers 748291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * and a preference fragment. 749291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 750291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean isMultiPane() { 75161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis return !mSinglePane; 752291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 753291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 754291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 755b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called to determine if the activity should run in multi-pane mode. 756b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * The default implementation returns true if the screen is large 757b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * enough. 758b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 759b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsMultiPane() { 760405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani boolean preferMultiPane = getResources().getBoolean( 761405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani com.android.internal.R.bool.preferences_prefer_dual_pane); 762405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani return preferMultiPane; 763b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 764b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 765b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 766291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Called to determine whether the header list should be hidden. 767291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * The default implementation returns the 768291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * value given in {@link #EXTRA_NO_HEADERS} or false if it is not supplied. 769291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * This is set to false, for example, when the activity is being re-launched 770291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * to show a particular preference activity. 771b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 772b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsHidingHeaders() { 773b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return getIntent().getBooleanExtra(EXTRA_NO_HEADERS, false); 774b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 775b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 776b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 777b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Called to determine the initial header to be shown. The default 778b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * implementation simply returns the fragment of the first header. Note 779b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * that the returned Header object does not actually need to exist in 780b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * your header list -- whatever its fragment is will simply be used to 781b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * show for the initial UI. 782b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 783b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public Header onGetInitialHeader() { 78419470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn for (int i=0; i<mHeaders.size(); i++) { 78519470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn Header h = mHeaders.get(i); 78619470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn if (h.fragment != null) { 78719470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn return h; 78819470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 78919470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 79019470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn throw new IllegalStateException("Must have at least one header with a fragment"); 791b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 792b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 793b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 7945c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Called after the header list has been updated ({@link #onBuildHeaders} 7955c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * has been called and returned due to {@link #invalidateHeaders()}) to 7965c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * specify the header that should now be selected. The default implementation 7975c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * returns null to keep whatever header is currently selected. 7985c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 7995c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Header onGetNewHeader() { 8005c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn return null; 8015c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8025c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8035c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 804b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the activity needs its list of headers build. By 805b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * implementing this and adding at least one item to the list, you 806b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will cause the activity to run in its modern fragment mode. Note 807b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * that this function may not always be called; for example, if the 808b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity has been asked to display a particular fragment without 809b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the header list, there is no need to build the headers. 810b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 811b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Typical implementations will use {@link #loadHeadersFromResource} 812b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to fill in the list from a resource. 813b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 814b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which to place the headers. 815b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 816b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onBuildHeaders(List<Header> target) { 81739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Should be overloaded by subclasses 818b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 819b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 820b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 821b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Call when you need to change the headers being displayed. Will result 822b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * in onBuildHeaders() later being called to retrieve the new list. 823b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 824b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void invalidateHeaders() { 825b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn if (!mHandler.hasMessages(MSG_BUILD_HEADERS)) { 826b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn mHandler.sendEmptyMessage(MSG_BUILD_HEADERS); 827b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 828b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 829b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 830b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 831b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Parse the given XML file as a header description, adding each 832b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * parsed Header into the target list. 833b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 834b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param resid The XML resource to load and parse. 835b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which the parsed headers should be placed. 836b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 8377b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye public void loadHeadersFromResource(@XmlRes int resid, List<Header> target) { 838b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlResourceParser parser = null; 839b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn try { 840b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parser = getResources().getXml(resid); 841b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn AttributeSet attrs = Xml.asAttributeSet(parser); 842b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 843b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn int type; 844b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 845b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && type != XmlPullParser.START_TAG) { 84639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Parse next until start tag is found 847b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 848b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 849b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn String nodeName = parser.getName(); 850def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (!"preference-headers".equals(nodeName)) { 851b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 852def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn "XML document must start with <preference-headers> tag; found" 85361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis + nodeName + " at " + parser.getPositionDescription()); 854b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 855b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 856def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn Bundle curBundle = null; 857def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn 8585c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int outerDepth = parser.getDepth(); 859b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 86061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) { 861b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 862b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn continue; 863b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 864b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 865b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn nodeName = parser.getName(); 866def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if ("header".equals(nodeName)) { 867b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = new Header(); 868b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 869f878c298e157ba81a378ba5ae3b4f23df8b1d85aAlan Viverette TypedArray sa = obtainStyledAttributes( 870f878c298e157ba81a378ba5ae3b4f23df8b1d85aAlan Viverette attrs, com.android.internal.R.styleable.PreferenceHeader); 871ed13cde1de86933f64285fa34e3a3aca80994859Amith Yamasani header.id = sa.getResourceId( 872a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn com.android.internal.R.styleable.PreferenceHeader_id, 873a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 87450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn TypedValue tv = sa.peekValue( 875b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_title); 87650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 87750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 87850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.titleRes = tv.resourceId; 87950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 88050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.title = tv.string; 88150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 88250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 88350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 884b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_summary); 88550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 88650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 88750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summaryRes = tv.resourceId; 88850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 88950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summary = tv.string; 89050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 89150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 89250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 893c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle); 89450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 89550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 89650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitleRes = tv.resourceId; 89750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 89850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitle = tv.string; 89950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 90050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 90150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 902c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle); 90350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 90450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 90550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitleRes = tv.resourceId; 90650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 90750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitle = tv.string; 90850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 90950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 910b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.iconRes = sa.getResourceId( 911b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_icon, 0); 912b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.fragment = sa.getString( 913b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_fragment); 914b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn sa.recycle(); 915b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 916def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle == null) { 917def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = new Bundle(); 918def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 9195c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9205c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int innerDepth = parser.getDepth(); 9215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 92261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) { 9235c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 9245c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn continue; 9255c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9265c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9275c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn String innerNodeName = parser.getName(); 9285c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (innerNodeName.equals("extra")) { 9295c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn getResources().parseBundleExtra("extra", attrs, curBundle); 9305c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 9315c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9325c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (innerNodeName.equals("intent")) { 9335c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn header.intent = Intent.parseIntent(getResources(), parser, attrs); 9345c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9355c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 9365c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 9375c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9385c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 940def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle.size() > 0) { 941def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn header.fragmentArguments = curBundle; 942def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = null; 943def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 944b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 945def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn target.add(header); 946b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 947b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlUtils.skipCurrentTag(parser); 948b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 949b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 950b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 951b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (XmlPullParserException e) { 952b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 953b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (IOException e) { 954b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 955b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } finally { 956b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (parser != null) parser.close(); 957b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 958364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 95919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 960364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani /** 961364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * Subclasses should override this method and verify that the given fragment is a valid type 962c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * to be attached to this activity. The default implementation returns <code>true</code> for 963c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * apps built for <code>android:targetSdkVersion</code> older than 964c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * {@link android.os.Build.VERSION_CODES#KITKAT}. For later versions, it will throw an exception. 96520915daf064f19587b8b9123de5849f91e78e59bAmith Yamasani * @param fragmentName the class name of the Fragment about to be attached to this activity. 966364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * @return true if the fragment class name is valid for this Activity and false otherwise. 967364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani */ 968364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani protected boolean isValidFragment(String fragmentName) { 969e8222dddaf2e3da14380101e818d4254899e0c0dChet Haase if (getApplicationInfo().targetSdkVersion >= android.os.Build.VERSION_CODES.KITKAT) { 970a5001b94a01b3c7547b688a5091e2fdf989640d6Amith Yamasani throw new RuntimeException( 971a5001b94a01b3c7547b688a5091e2fdf989640d6Amith Yamasani "Subclasses of PreferenceActivity must override isValidFragment(String)" 97261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis + " to verify that the Fragment class is valid! " 97361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis + this.getClass().getName() 97461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis + " has not checked if fragment " + fragmentName + " is valid."); 975364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } else { 976364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani return true; 977364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9805c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 9815c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Set a footer that should be shown at the bottom of the header list. 9825c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 9835c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public void setListFooter(View view) { 9845c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.removeAllViews(); 9855c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.addView(view, new FrameLayout.LayoutParams( 9865c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.MATCH_PARENT, 9875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.WRAP_CONTENT)); 9885c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9895c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 9929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 99319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 994b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 995b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityStop(); 996b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 10011ebf13ef20fea56f55094a3744c9813500a55b17Hiroaki Kuriyama mHandler.removeMessages(MSG_BIND_PREFERENCES); 10021ebf13ef20fea56f55094a3744c9813500a55b17Hiroaki Kuriyama mHandler.removeMessages(MSG_BUILD_HEADERS); 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 1004b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1005b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1006b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityDestroy(); 1007b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1014a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 1015a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putParcelableArrayList(HEADERS_TAG, mHeaders); 1016a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mCurHeader != null) { 1017a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(mCurHeader); 1018a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 1019a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putInt(CUR_HEADER_TAG, index); 1020a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1021a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1022a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1023a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1024b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1025b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 1026b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 1027b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = new Bundle(); 1028b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.saveHierarchyState(container); 1029b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn outState.putBundle(PREFERENCES_TAG, container); 1030b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onRestoreInstanceState(Bundle state) { 1036b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1037b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = state.getBundle(PREFERENCES_TAG); 1038b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (container != null) { 1039b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 1040b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 1041b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.restoreHierarchyState(container); 1042b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSavedInstanceState = state; 1043b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return; 1044b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 10459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1047e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 1048e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // Only call this if we didn't save the instance state for later. 1049e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // If we did save it, it will be restored when we bind the adapter. 1050e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(state); 105161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 105261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (!mSinglePane) { 105361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // Multi-pane. 105461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mCurHeader != null) { 105561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis setSelectedHeader(mCurHeader); 105661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 105761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 10589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onActivityResult(int requestCode, int resultCode, Intent data) { 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onActivityResult(requestCode, resultCode, data); 106319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1064b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1065b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityResult(requestCode, resultCode, data); 1066b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onContentChanged() { 10719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onContentChanged(); 1072b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1073b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1074b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn postBindPreferences(); 1075b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1076b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1077b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1078b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 1079b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn protected void onListItemClick(ListView l, View v, int position, long id) { 108049bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani if (!isResumed()) { 108149bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani return; 108249bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani } 1083b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super.onListItemClick(l, v, position, id); 1084b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1085b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter != null) { 108639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne Object item = mAdapter.getItem(position); 108739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne if (item instanceof Header) onHeaderClick((Header) item, position); 1088b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1089b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1090b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1091b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1092b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the user selects an item in the header list. The default 1093e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * implementation will call either 1094e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 1095a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * or {@link #switchToHeader(Header)} as appropriate. 1096b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1097b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param header The header that was selected. 1098b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param position The header's position in the list. 1099b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onHeaderClick(Header header, int position) { 11015c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header.fragment != null) { 110261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis switchToHeader(header); 11035c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (header.intent != null) { 11045c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn startActivity(header.intent); 1105b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1106b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1107b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1108b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1109e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Called by {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} when 1110b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * in single-pane mode, to build an Intent to launch a new activity showing 1111b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the selected fragment. The default implementation constructs an Intent 1112b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * that re-launches the current activity with the appropriate arguments to 1113b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * display the fragment. 111461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis * 1115b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param fragmentName The name of the fragment to display. 1116b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1117e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Optional resource ID of title to show for this item. 111839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * @param shortTitleRes Optional resource ID of short title to show for this item. 1119b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @return Returns an Intent that can be launched to display the given 1120b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * fragment. 1121b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn */ 1122e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public Intent onBuildStartFragmentIntent(String fragmentName, Bundle args, 11237b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes int titleRes, int shortTitleRes) { 1124b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn Intent intent = new Intent(Intent.ACTION_MAIN); 1125b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.setClass(this, getClass()); 1126b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName); 1127b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args); 1128e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_TITLE, titleRes); 1129e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, shortTitleRes); 1130b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_NO_HEADERS, true); 1131b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn return intent; 1132b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn } 113361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 1134b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn /** 1135e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Like {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 1136e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * but uses a 0 titleRes. 1137e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 1138e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 1139e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Fragment resultTo, int resultRequestCode) { 1140e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(fragmentName, args, resultTo, resultRequestCode, 0, 0); 1141e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 1142e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 1143e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 1144b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Start a new instance of this activity, showing only the given 1145b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. When launched in this mode, the header list 1146b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will be hidden and the given preference fragment will be instantiated 1147b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and fill the entire activity. 1148b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1149b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1150b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1151b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultTo Option fragment that should receive the result of 1152b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the activity launch. 1153b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the request 1154b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * code in which to report the result. 1155e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Resource ID of string to display for the title of 1156e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 115739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * @param shortTitleRes Resource ID of string to display for the short title of 1158e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 1159b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 11608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 11617b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye Fragment resultTo, int resultRequestCode, @StringRes int titleRes, 11627b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye @StringRes int shortTitleRes) { 1163e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Intent intent = onBuildStartFragmentIntent(fragmentName, args, titleRes, shortTitleRes); 11648eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo == null) { 11658eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startActivity(intent); 11668eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 11678eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultTo.startActivityForResult(intent, resultRequestCode); 11688eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1169b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1170b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1171c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 1172c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Change the base title of the bread crumbs for the current preferences. 1173c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * This will normally be called for you. See 1174c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * {@link android.app.FragmentBreadCrumbs} for more information. 1175c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 1176c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public void showBreadCrumbs(CharSequence title, CharSequence shortTitle) { 1177c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (mFragmentBreadCrumbs == null) { 11783e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani View crumbs = findViewById(android.R.id.title); 11793e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani // For screens with a different kind of title, don't create breadcrumbs. 1180e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn try { 1181e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn mFragmentBreadCrumbs = (FragmentBreadCrumbs)crumbs; 1182e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } catch (ClassCastException e) { 1183cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 1184e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1185e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 11863c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani if (mFragmentBreadCrumbs == null) { 1187e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (title != null) { 1188e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setTitle(title); 11893c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani } 1190e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1191c57406cdfa1925c3474e87865c51950b76ee0347Jim Miller } 11923ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani if (mSinglePane) { 11933ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani mFragmentBreadCrumbs.setVisibility(View.GONE); 11943ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani // Hide the breadcrumb section completely for single-pane 11953ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani View bcSection = findViewById(com.android.internal.R.id.breadcrumb_section); 11963ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani if (bcSection != null) bcSection.setVisibility(View.GONE); 1197cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 11983ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani } 11993c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setMaxVisible(2); 12003c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setActivity(this); 1201c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1202cf638aceef9515728cac93a42bce552c12206142Amith Yamasani if (mFragmentBreadCrumbs.getVisibility() != View.VISIBLE) { 1203cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 1204cf638aceef9515728cac93a42bce552c12206142Amith Yamasani } else { 1205cf638aceef9515728cac93a42bce552c12206142Amith Yamasani mFragmentBreadCrumbs.setTitle(title, shortTitle); 1206cf638aceef9515728cac93a42bce552c12206142Amith Yamasani mFragmentBreadCrumbs.setParentTitle(null, null, null); 1207cf638aceef9515728cac93a42bce552c12206142Amith Yamasani } 1208c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1209c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani 1210c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani /** 1211c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * Should be called after onCreate to ensure that the breadcrumbs, if any, were created. 1212c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * This prepends a title to the fragment breadcrumbs and attaches a listener to any clicks 1213c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * on the parent entry. 1214c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param title the title for the breadcrumb 1215c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param shortTitle the short title for the breadcrumb 1216c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani */ 1217c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani public void setParentTitle(CharSequence title, CharSequence shortTitle, 1218c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani OnClickListener listener) { 1219c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani if (mFragmentBreadCrumbs != null) { 1220c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani mFragmentBreadCrumbs.setParentTitle(title, shortTitle, listener); 1221c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1222c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1223c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 1224a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn void setSelectedHeader(Header header) { 1225a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mCurHeader = header; 1226a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(header); 1227a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 1228a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setItemChecked(index, true); 1229a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 1230a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().clearChoices(); 1231a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 123234905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn showBreadCrumbs(header); 123334905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn } 123434905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn 123534905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn void showBreadCrumbs(Header header) { 1236c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (header != null) { 123750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence title = header.getBreadCrumbTitle(getResources()); 123850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (title == null) title = header.getTitle(getResources()); 1239c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = getTitle(); 124050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn showBreadCrumbs(title, header.getBreadCrumbShortTitle(getResources())); 1241c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } else { 1242c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(getTitle(), null); 1243c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1244c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1245c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 12465aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio private void switchToHeaderInner(String fragmentName, Bundle args) { 12473a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 12483a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 1249364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani if (!isValidFragment(fragmentName)) { 1250364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani throw new IllegalArgumentException("Invalid fragment for this activity: " 1251364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani + fragmentName); 1252364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 125361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 1254c6669ca63299219d815464129dac051ab2404286Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentName, args); 125548e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 125661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.setTransition(mSinglePane 125761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis ? FragmentTransaction.TRANSIT_NONE 125861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis : FragmentTransaction.TRANSIT_FRAGMENT_FADE); 12599ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.replace(com.android.internal.R.id.prefs, f); 1260cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 126161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 126261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (mSinglePane && mPrefsContainer.getVisibility() == View.GONE) { 126361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // We are transitioning from headers to preferences panel in single-pane so we need 126461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // to hide headers and show the prefs container. 126561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mPrefsContainer.setVisibility(View.VISIBLE); 126661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis mHeadersContainer.setVisibility(View.GONE); 126761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 1268a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1269a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1270b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1271b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * When in two-pane mode, switch the fragment pane to show the given 1272b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. 1273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1275b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1276b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1277b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void switchToHeader(String fragmentName, Bundle args) { 127802bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell Header selectedHeader = null; 127902bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell for (int i = 0; i < mHeaders.size(); i++) { 128002bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell if (fragmentName.equals(mHeaders.get(i).fragment)) { 128102bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell selectedHeader = mHeaders.get(i); 128202bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell break; 128302bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell } 128402bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell } 128502bc31e7b351281e7ca905dbf7ad72ec4119e2e0Brian Attwell setSelectedHeader(selectedHeader); 12865aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio switchToHeaderInner(fragmentName, args); 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1289aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler /** 1290a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * When in two-pane mode, switch to the fragment pane to show the given 1291a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * preference fragment. 1292a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * 1293a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @param header The new header to display. 1294a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 1295a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void switchToHeader(Header header) { 12968eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mCurHeader == header) { 12978eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // This is the header we are currently displaying. Just make sure 12988eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // to pop the stack up to its root state. 12993a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 13003a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 13018eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 130219470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn if (header.fragment == null) { 130319470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn throw new IllegalStateException("can't switch to header that has no fragment"); 130419470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 13055aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio switchToHeaderInner(header.fragment, header.fragmentArguments); 13068eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setSelectedHeader(header); 13078eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1308a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1309a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1310a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header findBestMatchingHeader(Header cur, ArrayList<Header> from) { 1311a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> matches = new ArrayList<Header>(); 1312a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<from.size(); j++) { 1313a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = from.get(j); 1314a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur == oh || (cur.id != HEADER_ID_UNDEFINED && cur.id == oh.id)) { 1315a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Must be this one. 1316a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.clear(); 1317a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1318a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn break; 1319a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1320a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment != null) { 1321a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment.equals(oh.fragment)) { 1322a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1323a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1324a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.intent != null) { 1325a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.intent.equals(oh.intent)) { 1326a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1327a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1328a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.title != null) { 1329a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title.equals(oh.title)) { 1330a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1331a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1332a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1333a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1334a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn final int NM = matches.size(); 1335a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (NM == 1) { 1336a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return matches.get(0); 1337a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (NM > 1) { 1338a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<NM; j++) { 1339a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = matches.get(j); 1340a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragmentArguments != null && 1341a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn cur.fragmentArguments.equals(oh.fragmentArguments)) { 1342a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1343a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1344a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.extras != null && cur.extras.equals(oh.extras)) { 1345a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1346a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1347a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title != null && cur.title.equals(oh.title)) { 1348a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1349a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1350a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1351a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1352a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return null; 1353a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1354a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1355a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 1356aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * Start a new fragment. 1357aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * 1358aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param fragment The fragment to start 1359aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param push If true, the current fragment will be pushed onto the back stack. If false, 1360aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * the current fragment will be replaced. 1361aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler */ 1362aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler public void startPreferenceFragment(Fragment fragment, boolean push) { 136348e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 13648eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, fragment); 1365aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler if (push) { 13669ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 1367aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.addToBackStack(BACK_STACK_PREFS); 13689ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase } else { 1369327fbd2c8fa294b919475feb4c74a74ee1981e02Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 1370aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1371cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 1372aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1373aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler 1374c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 1375a47372c8617e8817d5b57aa6ed905017e7573224Amith Yamasani * Start a new fragment containing a preference panel. If the preferences 13768eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * are being displayed in multi-pane mode, the given fragment class will 13778eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * be instantiated and placed in the appropriate pane. If running in 13788eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * single-pane mode, a new activity will be launched in which to show the 13798eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 138061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis * 13818eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param fragmentClass Full name of the class implementing the fragment. 13828eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param args Any desired arguments to supply to the fragment. 13838eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleRes Optional resource identifier of the title of this 13848eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 13858eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleText Optional text of the title of this fragment. 13868eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultTo Optional fragment that result data should be sent to. 13878eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * If non-null, resultTo.onActivityResult() will be called when this 13888eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * preference panel is done. The launched panel must use 13898eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * {@link #finishPreferencePanel(Fragment, int, Intent)} when done. 13908eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the caller's 13917b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye * request code to be received with the result. 1392c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 13937b9c912f536925ac6ec43935d6e97506851b33d6Tor Norbye public void startPreferencePanel(String fragmentClass, Bundle args, @StringRes int titleRes, 13948eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn CharSequence titleText, Fragment resultTo, int resultRequestCode) { 139561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis Fragment f = Fragment.instantiate(this, fragmentClass, args); 139661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (resultTo != null) { 139761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis f.setTargetFragment(resultTo, resultRequestCode); 13988eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 139961fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis FragmentTransaction transaction = getFragmentManager().beginTransaction(); 140061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.replace(com.android.internal.R.id.prefs, f); 140161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (titleRes != 0) { 140261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.setBreadCrumbTitle(titleRes); 140361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } else if (titleText != null) { 140461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.setBreadCrumbTitle(titleText); 140561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis } 140661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 140761fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.addToBackStack(BACK_STACK_PREFS); 140861fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis transaction.commitAllowingStateLoss(); 1409c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1410364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani 14118eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn /** 14128eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Called by a preference panel fragment to finish itself. 141361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis * 14148eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param caller The fragment that is asking to be finished. 14158eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultCode Optional result code to send back to the original 14168eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 14178eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultData Optional result data to send back to the original 14188eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 14198eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn */ 14208eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void finishPreferencePanel(Fragment caller, int resultCode, Intent resultData) { 142161fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis // TODO: be smarter about popping the stack. 142261fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis onBackPressed(); 142361fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (caller != null) { 142461fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis if (caller.getTargetFragment() != null) { 142561fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis caller.getTargetFragment().onActivityResult(caller.getTargetRequestCode(), 142661fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis resultCode, resultData); 14278eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 14288eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 14298eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 143061fc0d47ff2f78acb8914398d1d7a570bb9a0b11Filip Pavlis 1431b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn @Override 1432b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) { 1433e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startPreferencePanel(pref.getFragment(), pref.getExtras(), pref.getTitleRes(), 1434e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn pref.getTitle(), null, 0); 1435b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn return true; 1436b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn } 1437b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Posts a message to bind the preferences to the list view. 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binding late is preferred as any custom preference types created in 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onCreate(Bundle)} are able to have their views recycled. 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void postBindPreferences() { 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler.hasMessages(MSG_BIND_PREFERENCES)) return; 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.obtainMessage(MSG_BIND_PREFERENCES).sendToTarget(); 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 144819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void bindPreferences() { 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final PreferenceScreen preferenceScreen = getPreferenceScreen(); 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (preferenceScreen != null) { 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project preferenceScreen.bind(getListView()); 1453e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell if (mSavedInstanceState != null) { 1454e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(mSavedInstanceState); 1455e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell mSavedInstanceState = null; 1456e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell } 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 145919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link PreferenceManager} used by this activity. 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceManager}. 1463b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1464b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1465b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1467b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceManager getPreferenceManager() { 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager; 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 147119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void requirePreferenceManager() { 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 1474b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter == null) { 1475b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("This should be called after super.onCreate."); 1476b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1477b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 1478b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn "Modern two-pane PreferenceActivity requires use of a PreferenceFragment"); 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the root of the preference hierarchy that this activity is showing. 148419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferenceScreen The root {@link PreferenceScreen} of the preference hierarchy. 1486b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1487b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1488b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1490b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreferenceScreen(PreferenceScreen preferenceScreen) { 1492b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn requirePreferenceManager(); 1493b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager.setPreferences(preferenceScreen) && preferenceScreen != null) { 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project postBindPreferences(); 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence title = getPreferenceScreen().getTitle(); 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set the title of the activity 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (title != null) { 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTitle(title); 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 150319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the root of the preference hierarchy that this activity is showing. 150619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceScreen} that is the root of the preference 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hierarchy. 1509b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1510b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1511b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1513b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceScreen getPreferenceScreen() { 1515b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1516b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return mPreferenceManager.getPreferenceScreen(); 1517b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1518b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return null; 15199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 152019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds preferences from activities that match the given {@link Intent}. 152319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The {@link Intent} to query activities. 1525b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1526b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1527b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1529b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromIntent(Intent intent) { 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 153219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromIntent(intent, getPreferenceScreen())); 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 153519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inflates the given XML resource and adds the preference hierarchy to the current 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preference hierarchy. 153919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferencesResId The XML resource ID to inflate. 1541b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1542b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1543b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1545b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromResource(int preferencesResId) { 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 154819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromResource(this, preferencesResId, 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getPreferenceScreen())); 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@inheritDoc} 1555b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1556b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1557b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 15589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1559b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 15609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 15619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 15629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 156319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Finds a {@link Preference} based on its key. 156619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key of the preference to retrieve. 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link Preference} with the key, or null. 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see PreferenceGroup#findPreference(CharSequence) 1570b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1571b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1572b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1574b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Preference findPreference(CharSequence key) { 157619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 158019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager.findPreference(key); 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onNewIntent(Intent intent) { 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager != null) { 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreferenceManager.dispatchNewIntent(intent); 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 159019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 159119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // give subclasses access to the Next button 159219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 159319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected boolean hasNextButton() { 159419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton != null; 159519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 159619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 159719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected Button getNextButton() { 159819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton; 159919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1601