PreferenceActivity.java revision 5aaae37506236bf9d3c43535537bd84e54bd5df9
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 19b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.app.Fragment; 20c6669ca63299219d815464129dac051ab2404286Dianne Hackbornimport android.app.FragmentBreadCrumbs; 213a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackbornimport android.app.FragmentManager; 22aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.app.FragmentTransaction; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.ListActivity; 24b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.Context; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 2650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.content.res.Resources; 27b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.TypedArray; 28b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.XmlResourceParser; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 32a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcel; 33a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcelable; 3419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.text.TextUtils; 35b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.AttributeSet; 3650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.util.TypedValue; 37b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.Xml; 38b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.view.LayoutInflater; 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 40405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport android.view.View.OnClickListener; 4139725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport android.view.ViewGroup; 42a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.widget.AbsListView; 43b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ArrayAdapter; 4439725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport android.widget.BaseAdapter; 4519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.widget.Button; 465c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackbornimport android.widget.FrameLayout; 47b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ImageView; 48b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ListView; 49b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.TextView; 50b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 5139725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport com.android.internal.util.XmlUtils; 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 53405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport org.xmlpull.v1.XmlPullParser; 54405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasaniimport org.xmlpull.v1.XmlPullParserException; 55405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani 5639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.io.IOException; 5739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.util.ArrayList; 5839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunneimport java.util.List; 5939725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 61b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * This is the base class for an activity to show a hierarchy of preferences 62b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to the user. Prior to {@link android.os.Build.VERSION_CODES#HONEYCOMB} 63b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * this class only allowed the display of a single set of preference; this 64b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * functionality should now be found in the new {@link PreferenceFragment} 65b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * class. If you are using PreferenceActivity in its old mode, the documentation 66b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * there applies to the deprecated APIs here. 67b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 6839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * <p>This activity shows one or more headers of preferences, each of which 69b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * is associated with a {@link PreferenceFragment} to display the preferences 70b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of that header. The actual layout and display of these associations can 71b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * however vary; currently there are two major approaches it may take: 72b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 73b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 74b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a small screen it may display only the headers as a single list 75b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * when first launched. Selecting one of the header items will re-launch 76b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the activity with it only showing the PreferenceFragment of that header. 77b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a large screen in may display both the headers and current 78b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceFragment together as panes. Selecting a header item switches 79b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to showing the correct PreferenceFragment for that item. 80b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 81b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 82b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Subclasses of PreferenceActivity should implement 83b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@link #onBuildHeaders} to populate the header list with the desired 84b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * items. Doing this implicitly switches the class into its new "headers 85b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * + fragments" mode rather than the old style of just showing a single 86b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preferences list. 87cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * 88cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <div class="special reference"> 89cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <h3>Developer Guides</h3> 90cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * <p>For information about using {@code PreferenceActivity}, 91cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * read the <a href="{@docRoot}guide/topics/ui/settings.html">Settings</a> 92cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * guide.</p> 93cdd0c59a0108036895796dcb2bea69ff5eef26caScott Main * </div> 94b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 95b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <a name="SampleCode"></a> 96b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <h3>Sample Code</h3> 97b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 98b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The following sample code shows a simple preference activity that 99b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * has two different sets of preferences. The implementation, consisting 100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of the activity itself as well as its two preference fragments is:</p> 101b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 102b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/preference/PreferenceWithHeaders.java 103b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity} 10419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 105b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The preference_headers resource describes the headers to be displayed 106b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and the fragments associated with them. It is: 107b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 108b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/preference_headers.xml headers} 109b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 110b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>The first header is shown by Prefs1Fragment, which populates itself 111b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * from the following XML resource:</p> 112b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 113b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/fragmented_preferences.xml preferences} 114b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 115b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>Note that this XML resource contains a preference screen holding another 116b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment, the Prefs1FragmentInner implemented here. This allows the user 117b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * to traverse down a hierarchy of preferences; pressing back will pop each 118b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment off the stack to return to the previous preferences. 119b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 120b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>See {@link PreferenceFragment} for information on implementing the 121b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * fragments themselves. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class PreferenceActivity extends ListActivity implements 124b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceManager.OnPreferenceTreeClickListener, 125b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceFragment.OnPreferenceStartFragmentCallback { 12619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1278fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov private static final String TAG = "PreferenceActivity"; 1288fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov 129a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Constants for state save/restore 130a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String HEADERS_TAG = ":android:headers"; 131a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String CUR_HEADER_TAG = ":android:cur_header"; 132a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String PREFERENCES_TAG = ":android:preferences"; 13319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 134b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 135b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 136b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * string to specify which fragment should be initially displayed. 137364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * <p/>Starting from Key Lime Pie, when this argument is passed in, the PreferenceActivity 138364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * will call isValidFragment() to confirm that the fragment class name is valid for this 139364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * activity. 140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 141b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT = ":android:show_fragment"; 142b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 143b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 144b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 145e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specified to supply a Bundle of arguments to pass 146b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to that fragment when it is instantiated during the initial creation 147b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * of PreferenceActivity. 148b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 149b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":android:show_fragment_args"; 150b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 151b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 152e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 153e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the title to be shown for 154e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 155e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 156e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_TITLE = ":android:show_fragment_title"; 157e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 158e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 159e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 160e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the short title to be shown for 161e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 162e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 163e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_SHORT_TITLE 164e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn = ":android:show_fragment_short_title"; 165e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 166e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 167b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 168b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * boolean that the header list should not be displayed. This is most often 169b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * used in conjunction with {@link #EXTRA_SHOW_FRAGMENT} to launch 170b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * the activity to display a specific fragment that the user has navigated 171b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to. 172b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 173b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_NO_HEADERS = ":android:no_headers"; 174b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 175b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn private static final String BACK_STACK_PREFS = ":android:prefs"; 176b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 17719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // extras that allow any preference activity to be launched as part of a wizard 17819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 17919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // show Back and Next buttons? takes boolean parameter 18019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // Back will then return RESULT_CANCELED and Next RESULT_OK 18119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SHOW_BUTTON_BAR = "extra_prefs_show_button_bar"; 18219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 18309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng // add a Skip button? 18409dbf1844016682ed461d080e32a43d0086e767dFreeman Ng private static final String EXTRA_PREFS_SHOW_SKIP = "extra_prefs_show_skip"; 18509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng 18619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // specify custom text for the Back or Next buttons, or cause a button to not appear 18719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // at all by setting it to null 18819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_NEXT_TEXT = "extra_prefs_set_next_text"; 18919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_BACK_TEXT = "extra_prefs_set_back_text"; 19019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 191b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for new mode when showing a list of headers + prefs fragment 192b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 193b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private final ArrayList<Header> mHeaders = new ArrayList<Header>(); 194b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1955c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn private FrameLayout mListFooter; 1965c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 1973c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani private ViewGroup mPrefsContainer; 198b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 199c6669ca63299219d815464129dac051ab2404286Dianne Hackborn private FragmentBreadCrumbs mFragmentBreadCrumbs; 200c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 201b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private boolean mSinglePane; 202b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 203a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private Header mCurHeader; 204a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 205b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for old mode when showing a single preference list 20619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreferenceManager mPreferenceManager; 20819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 209e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell private Bundle mSavedInstanceState; 210e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 211b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- Common state 212b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 213b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private Button mNextButton; 214b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The starting request code given out to preference framework. 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int FIRST_REQUEST_CODE = 100; 21919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 2203e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BIND_PREFERENCES = 1; 2213e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BUILD_HEADERS = 2; 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Handler mHandler = new Handler() { 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 226a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BIND_PREFERENCES: { 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindPreferences(); 228a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 229a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BUILD_HEADERS: { 230a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> oldHeaders = new ArrayList<Header>(mHeaders); 231a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.clear(); 232b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn onBuildHeaders(mHeaders); 23339725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne if (mAdapter instanceof BaseAdapter) { 23439725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne ((BaseAdapter) mAdapter).notifyDataSetChanged(); 23583681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler } 2365c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn Header header = onGetNewHeader(); 2375c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header != null && header.fragment != null) { 238a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(header, oldHeaders); 239a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader == null || mCurHeader != mappedHeader) { 240a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 241a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 242a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mCurHeader != null) { 243a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(mCurHeader, mHeaders); 244a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader != null) { 245a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mappedHeader); 246a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 2475c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 248a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 253468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderAdapter extends ArrayAdapter<Header> { 254468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderViewHolder { 255468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler ImageView icon; 256468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView title; 257468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView summary; 258468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 259b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 260b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private LayoutInflater mInflater; 261b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 262b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public HeaderAdapter(Context context, List<Header> objects) { 263b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super(context, 0, objects); 264b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 265b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 266b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 267b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 268b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public View getView(int position, View convertView, ViewGroup parent) { 269b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn HeaderViewHolder holder; 270b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn View view; 271b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 272b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (convertView == null) { 273d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn view = mInflater.inflate(com.android.internal.R.layout.preference_header_item, 274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parent, false); 275b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn holder = new HeaderViewHolder(); 276468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon); 277468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title = (TextView) view.findViewById(com.android.internal.R.id.title); 278468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary); 279b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view.setTag(holder); 280b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 281b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view = convertView; 282468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder = (HeaderViewHolder) view.getTag(); 283b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 284b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 285468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler // All view fields must be updated every time, because the view may be recycled 286b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = getItem(position); 287a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn holder.icon.setImageResource(header.iconRes); 28850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.title.setText(header.getTitle(getContext().getResources())); 28950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence summary = header.getSummary(getContext().getResources()); 29050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (!TextUtils.isEmpty(summary)) { 291468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.VISIBLE); 29250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setText(summary); 29350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 29450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setVisibility(View.GONE); 295468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 296b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 297b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return view; 298b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 299b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 300b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 301b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 302a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Default value for {@link Header#id Header.id} indicating that no 303a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * identifier value is set. All other values (including those below -1) 304a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * are valid. 305a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 306a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final long HEADER_ID_UNDEFINED = -1; 307364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani 308a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 309b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Description of a single Header item that the user can select. 310b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 311a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final class Header implements Parcelable { 312a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 313a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Identifier for this header, to correlate with a new list when 314a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * it is updated. The default value is 315a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * {@link PreferenceActivity#HEADER_ID_UNDEFINED}, meaning no id. 316a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_id 317a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 318a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public long id = HEADER_ID_UNDEFINED; 319a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 320b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 32150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of title of the header that is shown to the user. 32250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 32350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 32450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int titleRes; 32550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 32650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 327b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Title of the header that is shown to the user. 328b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 329b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 330468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence title; 331b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 332b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 33350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional summary describing what this header controls. 33450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 33550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 33650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int summaryRes; 33750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 33850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 339b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional summary describing what this header controls. 340b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 341b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 342468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence summary; 343b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 344b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 34550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the title in the bread crumb. 34650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 34750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 34850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbTitleRes; 34950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 35050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 351c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the title in the bread crumb. 352c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 353c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 354c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbTitle; 355c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 356c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 35750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the short title in the bread crumb. 35850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 35950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 36050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbShortTitleRes; 36150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 36250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 363c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the short title in the bread crumb. 364c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 365c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 366c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbShortTitle; 367c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 368c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 369b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional icon resource to show for this header. 370b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_icon 371b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 372468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public int iconRes; 373b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 374b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 375b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Full class name of the fragment to display when this header is 376b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * selected. 377b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_fragment 378b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 379468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public String fragment; 380b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 381b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 382b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Optional arguments to supply to the fragment when it is 383b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * instantiated. 384b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 385468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public Bundle fragmentArguments; 3865c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 3875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 3885c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Intent to launch when the preference is selected. 3895c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 3905c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Intent intent; 391a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 392a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 393a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Optional additional data for use by subclasses of PreferenceActivity. 394a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 395a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Bundle extras; 396a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 397a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header() { 39839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Empty 399a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 400a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 40150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 40250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set title. If {@link #titleRes} is set, 40350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 40450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #title} is returned. 40550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 40650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getTitle(Resources res) { 40750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (titleRes != 0) { 40850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(titleRes); 40950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 41050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return title; 41150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 41250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 41350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 41450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set summary. If {@link #summaryRes} is set, 41550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 41650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #summary} is returned. 41750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 41850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getSummary(Resources res) { 41950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (summaryRes != 0) { 42050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(summaryRes); 42150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 4229d0718042f7c0a50d825c621f82ce9a92071f07aDianne Hackborn return summary; 42350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 42450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 42550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 42650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb title. If {@link #breadCrumbTitleRes} is set, 42750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 42850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbTitle} is returned. 42950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 43050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbTitle(Resources res) { 43150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbTitleRes != 0) { 43250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbTitleRes); 43350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 43450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbTitle; 43550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 43650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 43750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 43850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb short title. If 43950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitleRes} is set, 44050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 44150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitle} is returned. 44250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 44350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbShortTitle(Resources res) { 44450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbShortTitleRes != 0) { 44550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbShortTitleRes); 44650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 44750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbShortTitle; 44850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 44950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 450a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 451a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public int describeContents() { 452a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return 0; 453a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 454a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 455a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 456a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 457a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeLong(id); 45850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(titleRes); 459a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(title, dest, flags); 46050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(summaryRes); 461a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(summary, dest, flags); 46250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbTitleRes); 463c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbTitle, dest, flags); 46450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbShortTitleRes); 465c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbShortTitle, dest, flags); 466a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(iconRes); 467a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeString(fragment); 468a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(fragmentArguments); 469a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (intent != null) { 470a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(1); 471a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent.writeToParcel(dest, flags); 472a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 473a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(0); 474a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 475a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(extras); 476a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 477a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 478a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void readFromParcel(Parcel in) { 479a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn id = in.readLong(); 48050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn titleRes = in.readInt(); 481a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn title = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 48250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn summaryRes = in.readInt(); 483a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn summary = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 48450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbTitleRes = in.readInt(); 485c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 48650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbShortTitleRes = in.readInt(); 487c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbShortTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 488a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn iconRes = in.readInt(); 489a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragment = in.readString(); 490a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragmentArguments = in.readBundle(); 491a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (in.readInt() != 0) { 492a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent = Intent.CREATOR.createFromParcel(in); 493a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 494a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn extras = in.readBundle(); 495a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 496a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 497a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header(Parcel in) { 498a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn readFromParcel(in); 499a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 500a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 501a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final Creator<Header> CREATOR = new Creator<Header>() { 502a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header createFromParcel(Parcel source) { 503a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header(source); 504a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 505a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header[] newArray(int size) { 506a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header[size]; 507a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 508a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn }; 509b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 510b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onCreate(Bundle savedInstanceState) { 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 515405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani setContentView(com.android.internal.R.layout.preference_list_content); 51619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 5175c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter = (FrameLayout)findViewById(com.android.internal.R.id.list_footer); 5183c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs_frame); 519b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn boolean hidingHeaders = onIsHidingHeaders(); 520b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSinglePane = hidingHeaders || !onIsMultiPane(); 521b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn String initialFragment = getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT); 522b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn Bundle initialArguments = getIntent().getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS); 523e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_TITLE, 0); 524e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialShortTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, 0); 525b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 526a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (savedInstanceState != null) { 527a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We are restarting from a previous saved state; used that to 528a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // initialize, instead of starting fresh. 529a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> headers = savedInstanceState.getParcelableArrayList(HEADERS_TAG); 530a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (headers != null) { 531a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.addAll(headers); 532a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int curHeader = savedInstanceState.getInt(CUR_HEADER_TAG, 53339725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne (int) HEADER_ID_UNDEFINED); 534a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (curHeader >= 0 && curHeader < mHeaders.size()) { 535a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mHeaders.get(curHeader)); 536a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 537a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 538b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 539b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 540a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 541a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If we are just showing a fragment, we want to run in 542a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // new fragment mode, but don't need to compute and show 543a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the headers. 544a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 545e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (initialTitle != 0) { 546e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn CharSequence initialTitleStr = getText(initialTitle); 547e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn CharSequence initialShortTitleStr = initialShortTitle != 0 548e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn ? getText(initialShortTitle) : null; 549e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn showBreadCrumbs(initialTitleStr, initialShortTitleStr); 550e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 551a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 552a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 553a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We need to try to build the headers. 554a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn onBuildHeaders(mHeaders); 555a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 556a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If there are headers, then at this point we need to show 557a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // them and, depending on the screen, we may also show in-line 558a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the currently selected preference fragment. 559a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 560a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 561a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment == null) { 562a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header h = onGetInitialHeader(); 563a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(h); 564a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 565a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 566a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 567b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 568b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 569a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 570a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 571b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 572a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // The default configuration is to only show the list view. Adjust 573a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // visibility for other configurations. 574a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 575a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Single pane, showing just a prefs fragment. 57605fbc31ed9c6ac13a7aeddc176f19a5c17217e30Amith Yamasani findViewById(com.android.internal.R.id.headers).setVisibility(View.GONE); 577a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 57834905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn if (initialTitle != 0) { 5798fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov CharSequence initialTitleStr = getText(initialTitle); 5808fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov CharSequence initialShortTitleStr = initialShortTitle != 0 58134905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn ? getText(initialShortTitle) : null; 5828fc552e695701ff9bc64d5adca0f06a47f0f9f37Svetoslav Ganov showBreadCrumbs(initialTitleStr, initialShortTitleStr); 58334905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn } 584a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mHeaders.size() > 0) { 58539725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne setListAdapter(new HeaderAdapter(this, mHeaders)); 586a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 587a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Multi-pane. 588a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setChoiceMode(AbsListView.CHOICE_MODE_SINGLE); 589d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn if (mCurHeader != null) { 590d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn setSelectedHeader(mCurHeader); 591d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn } 592a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 593a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 594a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 595b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // If there are no headers, we are in the old "just show a screen 596b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // of preferences" mode. 597405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani setContentView(com.android.internal.R.layout.preference_list_content_single); 5988da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mListFooter = (FrameLayout) findViewById(com.android.internal.R.id.list_footer); 5993c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs); 600a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager = new PreferenceManager(this, FIRST_REQUEST_CODE); 601a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager.setOnPreferenceTreeClickListener(this); 602b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 603b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 60419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // see if we should show Back/Next buttons 60519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Intent intent = getIntent(); 60619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_BUTTON_BAR, false)) { 60719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 60819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng findViewById(com.android.internal.R.id.button_bar).setVisibility(View.VISIBLE); 60919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 61019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Button backButton = (Button)findViewById(com.android.internal.R.id.back_button); 61119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setOnClickListener(new OnClickListener() { 61219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 61319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_CANCELED); 61419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 61519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 61619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 61709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng Button skipButton = (Button)findViewById(com.android.internal.R.id.skip_button); 61809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setOnClickListener(new OnClickListener() { 61909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng public void onClick(View v) { 62009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng setResult(RESULT_OK); 62109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng finish(); 62209dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 62309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng }); 62419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton = (Button)findViewById(com.android.internal.R.id.next_button); 62519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setOnClickListener(new OnClickListener() { 62619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 62719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_OK); 62819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 62919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 63019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 63119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 63219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // set our various button parameters 63319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_NEXT_TEXT)) { 63419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_NEXT_TEXT); 63519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 63619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setVisibility(View.GONE); 63719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 63819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 63919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setText(buttonText); 64019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_BACK_TEXT)) { 64319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_BACK_TEXT); 64419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 64519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setVisibility(View.GONE); 64619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 64819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setText(buttonText); 64919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 65019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 65109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_SKIP, false)) { 65209dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setVisibility(View.VISIBLE); 65309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 65419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 655b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 656b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 657b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 658291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is currently showing the header list. 659291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 660291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean hasHeaders() { 661291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return getListView().getVisibility() == View.VISIBLE 662291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn && mPreferenceManager == null; 663291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 664291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 665291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 666423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani * Returns the Header list 667423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani * @hide 668423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani */ 669423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani public List<Header> getHeaders() { 670423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani return mHeaders; 671423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani } 672423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani 673423d48bbba074ee1d0d7b09f4e9e074a6944edbaAmith Yamasani /** 674291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is showing multiple panes -- the headers 675291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * and a preference fragment. 676291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 677291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean isMultiPane() { 678291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return hasHeaders() && mPrefsContainer.getVisibility() == View.VISIBLE; 679291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 680291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 681291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 682b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called to determine if the activity should run in multi-pane mode. 683b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * The default implementation returns true if the screen is large 684b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * enough. 685b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 686b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsMultiPane() { 687405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani boolean preferMultiPane = getResources().getBoolean( 688405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani com.android.internal.R.bool.preferences_prefer_dual_pane); 689405c1af75607fafdb1d6faf34e13e032e4934787Amith Yamasani return preferMultiPane; 690b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 691b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 692b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 693291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Called to determine whether the header list should be hidden. 694291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * The default implementation returns the 695291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * value given in {@link #EXTRA_NO_HEADERS} or false if it is not supplied. 696291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * This is set to false, for example, when the activity is being re-launched 697291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * to show a particular preference activity. 698b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 699b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsHidingHeaders() { 700b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return getIntent().getBooleanExtra(EXTRA_NO_HEADERS, false); 701b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 702b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 703b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 704b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Called to determine the initial header to be shown. The default 705b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * implementation simply returns the fragment of the first header. Note 706b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * that the returned Header object does not actually need to exist in 707b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * your header list -- whatever its fragment is will simply be used to 708b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * show for the initial UI. 709b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 710b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public Header onGetInitialHeader() { 71119470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn for (int i=0; i<mHeaders.size(); i++) { 71219470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn Header h = mHeaders.get(i); 71319470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn if (h.fragment != null) { 71419470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn return h; 71519470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 71619470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 71719470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn throw new IllegalStateException("Must have at least one header with a fragment"); 718b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 719b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 720b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 7215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Called after the header list has been updated ({@link #onBuildHeaders} 7225c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * has been called and returned due to {@link #invalidateHeaders()}) to 7235c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * specify the header that should now be selected. The default implementation 7245c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * returns null to keep whatever header is currently selected. 7255c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 7265c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Header onGetNewHeader() { 7275c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn return null; 7285c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 7295c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 7305c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 731b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the activity needs its list of headers build. By 732b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * implementing this and adding at least one item to the list, you 733b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will cause the activity to run in its modern fragment mode. Note 734b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * that this function may not always be called; for example, if the 735b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity has been asked to display a particular fragment without 736b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the header list, there is no need to build the headers. 737b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 738b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Typical implementations will use {@link #loadHeadersFromResource} 739b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to fill in the list from a resource. 740b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 741b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which to place the headers. 742b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 743b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onBuildHeaders(List<Header> target) { 74439725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Should be overloaded by subclasses 745b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 746b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 747b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 748b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Call when you need to change the headers being displayed. Will result 749b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * in onBuildHeaders() later being called to retrieve the new list. 750b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 751b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void invalidateHeaders() { 752b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn if (!mHandler.hasMessages(MSG_BUILD_HEADERS)) { 753b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn mHandler.sendEmptyMessage(MSG_BUILD_HEADERS); 754b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 755b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 756b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 757b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 758b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Parse the given XML file as a header description, adding each 759b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * parsed Header into the target list. 760b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 761b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param resid The XML resource to load and parse. 762b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which the parsed headers should be placed. 763b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 764b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void loadHeadersFromResource(int resid, List<Header> target) { 765b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlResourceParser parser = null; 766b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn try { 767b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parser = getResources().getXml(resid); 768b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn AttributeSet attrs = Xml.asAttributeSet(parser); 769b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 770b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn int type; 771b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 772b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && type != XmlPullParser.START_TAG) { 77339725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne // Parse next until start tag is found 774b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 775b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 776b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn String nodeName = parser.getName(); 777def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (!"preference-headers".equals(nodeName)) { 778b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 779def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn "XML document must start with <preference-headers> tag; found" 780b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn + nodeName + " at " + parser.getPositionDescription()); 781b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 782b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 783def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn Bundle curBundle = null; 784def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn 7855c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int outerDepth = parser.getDepth(); 786b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 787b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) { 788b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 789b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn continue; 790b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 791b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 792b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn nodeName = parser.getName(); 793def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if ("header".equals(nodeName)) { 794b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = new Header(); 795b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 796f878c298e157ba81a378ba5ae3b4f23df8b1d85aAlan Viverette TypedArray sa = obtainStyledAttributes( 797f878c298e157ba81a378ba5ae3b4f23df8b1d85aAlan Viverette attrs, com.android.internal.R.styleable.PreferenceHeader); 798ed13cde1de86933f64285fa34e3a3aca80994859Amith Yamasani header.id = sa.getResourceId( 799a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn com.android.internal.R.styleable.PreferenceHeader_id, 800a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 80150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn TypedValue tv = sa.peekValue( 802b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_title); 80350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 80450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 80550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.titleRes = tv.resourceId; 80650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 80750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.title = tv.string; 80850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 80950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 81050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 811b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_summary); 81250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 81350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 81450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summaryRes = tv.resourceId; 81550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 81650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summary = tv.string; 81750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 81850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 81950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 820c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle); 82150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 82250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 82350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitleRes = tv.resourceId; 82450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 82550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitle = tv.string; 82650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 82750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 82850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 829c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle); 83050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 83150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 83250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitleRes = tv.resourceId; 83350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 83450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitle = tv.string; 83550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 83650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 837b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.iconRes = sa.getResourceId( 838b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_icon, 0); 839b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.fragment = sa.getString( 840b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_fragment); 841b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn sa.recycle(); 842b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 843def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle == null) { 844def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = new Bundle(); 845def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 8465c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8475c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int innerDepth = parser.getDepth(); 8485c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 8495c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) { 8505c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 8515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn continue; 8525c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8535c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8545c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn String innerNodeName = parser.getName(); 8555c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (innerNodeName.equals("extra")) { 8565c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn getResources().parseBundleExtra("extra", attrs, curBundle); 8575c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8585c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8595c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (innerNodeName.equals("intent")) { 8605c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn header.intent = Intent.parseIntent(getResources(), parser, attrs); 8615c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8625c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 8635c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8645c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8655c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8665c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 867def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle.size() > 0) { 868def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn header.fragmentArguments = curBundle; 869def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = null; 870def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 871b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 872def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn target.add(header); 873b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 874b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlUtils.skipCurrentTag(parser); 875b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 876b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 877b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 878b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (XmlPullParserException e) { 879b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 880b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (IOException e) { 881b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 882b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } finally { 883b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (parser != null) parser.close(); 884b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 885364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 88619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 887364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani /** 888364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * Subclasses should override this method and verify that the given fragment is a valid type 889c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * to be attached to this activity. The default implementation returns <code>true</code> for 890c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * apps built for <code>android:targetSdkVersion</code> older than 891c2be0d61830dd867f3092923e149e0cc251cdfc5Amith Yamasani * {@link android.os.Build.VERSION_CODES#KITKAT}. For later versions, it will throw an exception. 89220915daf064f19587b8b9123de5849f91e78e59bAmith Yamasani * @param fragmentName the class name of the Fragment about to be attached to this activity. 893364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani * @return true if the fragment class name is valid for this Activity and false otherwise. 894364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani */ 895364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani protected boolean isValidFragment(String fragmentName) { 896e8222dddaf2e3da14380101e818d4254899e0c0dChet Haase if (getApplicationInfo().targetSdkVersion >= android.os.Build.VERSION_CODES.KITKAT) { 897a5001b94a01b3c7547b688a5091e2fdf989640d6Amith Yamasani throw new RuntimeException( 898a5001b94a01b3c7547b688a5091e2fdf989640d6Amith Yamasani "Subclasses of PreferenceActivity must override isValidFragment(String)" 899364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani + " to verify that the Fragment class is valid! " + this.getClass().getName() 900364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani + " has not checked if fragment " + fragmentName + " is valid."); 901364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } else { 902364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani return true; 903364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9065c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 9075c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Set a footer that should be shown at the bottom of the header list. 9085c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 9095c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public void setListFooter(View view) { 9105c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.removeAllViews(); 9115c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.addView(view, new FrameLayout.LayoutParams( 9125c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.MATCH_PARENT, 9135c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.WRAP_CONTENT)); 9145c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9155c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 91919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 920b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 921b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityStop(); 922b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 9271ebf13ef20fea56f55094a3744c9813500a55b17Hiroaki Kuriyama mHandler.removeMessages(MSG_BIND_PREFERENCES); 9281ebf13ef20fea56f55094a3744c9813500a55b17Hiroaki Kuriyama mHandler.removeMessages(MSG_BUILD_HEADERS); 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 930b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 931b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 932b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityDestroy(); 933b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 940a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 941a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putParcelableArrayList(HEADERS_TAG, mHeaders); 942a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mCurHeader != null) { 943a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(mCurHeader); 944a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 945a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putInt(CUR_HEADER_TAG, index); 946a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 947a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 948a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 949a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 950b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 951b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 952b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 953b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = new Bundle(); 954b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.saveHierarchyState(container); 955b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn outState.putBundle(PREFERENCES_TAG, container); 956b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onRestoreInstanceState(Bundle state) { 962b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 963b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = state.getBundle(PREFERENCES_TAG); 964b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (container != null) { 965b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 966b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 967b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.restoreHierarchyState(container); 968b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSavedInstanceState = state; 969b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return; 970b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 973e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 974e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // Only call this if we didn't save the instance state for later. 975e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // If we did save it, it will be restored when we bind the adapter. 976e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(state); 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onActivityResult(int requestCode, int resultCode, Intent data) { 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onActivityResult(requestCode, resultCode, data); 98219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 983b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 984b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityResult(requestCode, resultCode, data); 985b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onContentChanged() { 9909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onContentChanged(); 991b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 992b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 993b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn postBindPreferences(); 994b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 995b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 996b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 997b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 998b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn protected void onListItemClick(ListView l, View v, int position, long id) { 99949bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani if (!isResumed()) { 100049bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani return; 100149bdc1681e58bd01174673042c42f65bb34943ddAmith Yamasani } 1002b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super.onListItemClick(l, v, position, id); 1003b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1004b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter != null) { 100539725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne Object item = mAdapter.getItem(position); 100639725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne if (item instanceof Header) onHeaderClick((Header) item, position); 1007b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1008b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1009b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1010b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1011b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the user selects an item in the header list. The default 1012e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * implementation will call either 1013e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 1014a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * or {@link #switchToHeader(Header)} as appropriate. 1015b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1016b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param header The header that was selected. 1017b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param position The header's position in the list. 1018b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1019b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onHeaderClick(Header header, int position) { 10205c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header.fragment != null) { 10215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (mSinglePane) { 1022e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int titleRes = header.breadCrumbTitleRes; 1023e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int shortTitleRes = header.breadCrumbShortTitleRes; 1024e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (titleRes == 0) { 1025e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn titleRes = header.titleRes; 1026e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn shortTitleRes = 0; 1027e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 1028e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(header.fragment, header.fragmentArguments, null, 0, 1029e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn titleRes, shortTitleRes); 10305c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 1031a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 10325c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 10335c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (header.intent != null) { 10345c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn startActivity(header.intent); 1035b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1036b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1037b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1038b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1039e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Called by {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} when 1040b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * in single-pane mode, to build an Intent to launch a new activity showing 1041b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the selected fragment. The default implementation constructs an Intent 1042b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * that re-launches the current activity with the appropriate arguments to 1043b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * display the fragment. 1044b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * 1045b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param fragmentName The name of the fragment to display. 1046b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1047e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Optional resource ID of title to show for this item. 104839725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * @param shortTitleRes Optional resource ID of short title to show for this item. 1049b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @return Returns an Intent that can be launched to display the given 1050b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * fragment. 1051b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn */ 1052e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public Intent onBuildStartFragmentIntent(String fragmentName, Bundle args, 1053e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int titleRes, int shortTitleRes) { 1054b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn Intent intent = new Intent(Intent.ACTION_MAIN); 1055b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.setClass(this, getClass()); 1056b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName); 1057b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args); 1058e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_TITLE, titleRes); 1059e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, shortTitleRes); 1060b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_NO_HEADERS, true); 1061b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn return intent; 1062b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn } 1063b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn 1064b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn /** 1065e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Like {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 1066e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * but uses a 0 titleRes. 1067e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 1068e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 1069e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Fragment resultTo, int resultRequestCode) { 1070e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(fragmentName, args, resultTo, resultRequestCode, 0, 0); 1071e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 1072e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 1073e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 1074b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Start a new instance of this activity, showing only the given 1075b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. When launched in this mode, the header list 1076b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will be hidden and the given preference fragment will be instantiated 1077b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and fill the entire activity. 1078b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1079b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1080b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1081b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultTo Option fragment that should receive the result of 1082b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the activity launch. 1083b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the request 1084b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * code in which to report the result. 1085e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Resource ID of string to display for the title of 1086e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 108739725ac96b68f7d2d25d10662bd9ad3189fdab77Gilles Debunne * @param shortTitleRes Resource ID of string to display for the short title of 1088e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 1089b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 10908eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 1091e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Fragment resultTo, int resultRequestCode, int titleRes, int shortTitleRes) { 1092e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Intent intent = onBuildStartFragmentIntent(fragmentName, args, titleRes, shortTitleRes); 10938eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo == null) { 10948eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startActivity(intent); 10958eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 10968eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultTo.startActivityForResult(intent, resultRequestCode); 10978eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1098b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1099b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1100c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 1101c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Change the base title of the bread crumbs for the current preferences. 1102c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * This will normally be called for you. See 1103c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * {@link android.app.FragmentBreadCrumbs} for more information. 1104c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 1105c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public void showBreadCrumbs(CharSequence title, CharSequence shortTitle) { 1106c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (mFragmentBreadCrumbs == null) { 11073e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani View crumbs = findViewById(android.R.id.title); 11083e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani // For screens with a different kind of title, don't create breadcrumbs. 1109e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn try { 1110e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn mFragmentBreadCrumbs = (FragmentBreadCrumbs)crumbs; 1111e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } catch (ClassCastException e) { 1112cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 1113e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1114e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 11153c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani if (mFragmentBreadCrumbs == null) { 1116e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (title != null) { 1117e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setTitle(title); 11183c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani } 1119e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1120c57406cdfa1925c3474e87865c51950b76ee0347Jim Miller } 11213ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani if (mSinglePane) { 11223ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani mFragmentBreadCrumbs.setVisibility(View.GONE); 11233ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani // Hide the breadcrumb section completely for single-pane 11243ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani View bcSection = findViewById(com.android.internal.R.id.breadcrumb_section); 11253ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani if (bcSection != null) bcSection.setVisibility(View.GONE); 1126cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 11273ec7bac9a0c262882d6ca2985f4dc3ecc42489c0Amith Yamasani } 11283c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setMaxVisible(2); 11293c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setActivity(this); 1130c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1131cf638aceef9515728cac93a42bce552c12206142Amith Yamasani if (mFragmentBreadCrumbs.getVisibility() != View.VISIBLE) { 1132cf638aceef9515728cac93a42bce552c12206142Amith Yamasani setTitle(title); 1133cf638aceef9515728cac93a42bce552c12206142Amith Yamasani } else { 1134cf638aceef9515728cac93a42bce552c12206142Amith Yamasani mFragmentBreadCrumbs.setTitle(title, shortTitle); 1135cf638aceef9515728cac93a42bce552c12206142Amith Yamasani mFragmentBreadCrumbs.setParentTitle(null, null, null); 1136cf638aceef9515728cac93a42bce552c12206142Amith Yamasani } 1137c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1138c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani 1139c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani /** 1140c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * Should be called after onCreate to ensure that the breadcrumbs, if any, were created. 1141c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * This prepends a title to the fragment breadcrumbs and attaches a listener to any clicks 1142c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * on the parent entry. 1143c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param title the title for the breadcrumb 1144c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param shortTitle the short title for the breadcrumb 1145c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani */ 1146c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani public void setParentTitle(CharSequence title, CharSequence shortTitle, 1147c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani OnClickListener listener) { 1148c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani if (mFragmentBreadCrumbs != null) { 1149c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani mFragmentBreadCrumbs.setParentTitle(title, shortTitle, listener); 1150c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1151c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1152c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 1153a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn void setSelectedHeader(Header header) { 1154a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mCurHeader = header; 1155a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(header); 1156a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 1157a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setItemChecked(index, true); 1158a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 1159a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().clearChoices(); 1160a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 116134905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn showBreadCrumbs(header); 116234905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn } 116334905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn 116434905a9808a63e8b671b8e9c4a20c6e1ca470b36Dianne Hackborn void showBreadCrumbs(Header header) { 1165c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (header != null) { 116650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence title = header.getBreadCrumbTitle(getResources()); 116750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (title == null) title = header.getTitle(getResources()); 1168c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = getTitle(); 116950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn showBreadCrumbs(title, header.getBreadCrumbShortTitle(getResources())); 1170c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } else { 1171c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(getTitle(), null); 1172c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1173c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1174c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 11755aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio private void switchToHeaderInner(String fragmentName, Bundle args) { 11763a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 11773a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 1178364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani if (!isValidFragment(fragmentName)) { 1179364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani throw new IllegalArgumentException("Invalid fragment for this activity: " 1180364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani + fragmentName); 1181364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani } 1182c6669ca63299219d815464129dac051ab2404286Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentName, args); 118348e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 1184327fbd2c8fa294b919475feb4c74a74ee1981e02Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 11859ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.replace(com.android.internal.R.id.prefs, f); 1186cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 1187a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1188a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1189b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1190b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * When in two-pane mode, switch the fragment pane to show the given 1191b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. 1192b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1193b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1194b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1195b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1196b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void switchToHeader(String fragmentName, Bundle args) { 1197a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(null); 11985aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio switchToHeaderInner(fragmentName, args); 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1201aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler /** 1202a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * When in two-pane mode, switch to the fragment pane to show the given 1203a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * preference fragment. 1204a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * 1205a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @param header The new header to display. 1206a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 1207a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void switchToHeader(Header header) { 12088eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mCurHeader == header) { 12098eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // This is the header we are currently displaying. Just make sure 12108eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // to pop the stack up to its root state. 12113a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 12123a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 12138eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 121419470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn if (header.fragment == null) { 121519470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn throw new IllegalStateException("can't switch to header that has no fragment"); 121619470ecc0f3fa4f95fd55db722cb8e43e956da5eDianne Hackborn } 12175aaae37506236bf9d3c43535537bd84e54bd5df9Fabrice Di Meglio switchToHeaderInner(header.fragment, header.fragmentArguments); 12188eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setSelectedHeader(header); 12198eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1220a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1221a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1222a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header findBestMatchingHeader(Header cur, ArrayList<Header> from) { 1223a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> matches = new ArrayList<Header>(); 1224a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<from.size(); j++) { 1225a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = from.get(j); 1226a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur == oh || (cur.id != HEADER_ID_UNDEFINED && cur.id == oh.id)) { 1227a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Must be this one. 1228a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.clear(); 1229a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1230a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn break; 1231a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1232a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment != null) { 1233a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment.equals(oh.fragment)) { 1234a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1235a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1236a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.intent != null) { 1237a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.intent.equals(oh.intent)) { 1238a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1239a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1240a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.title != null) { 1241a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title.equals(oh.title)) { 1242a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1243a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1244a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1245a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1246a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn final int NM = matches.size(); 1247a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (NM == 1) { 1248a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return matches.get(0); 1249a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (NM > 1) { 1250a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<NM; j++) { 1251a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = matches.get(j); 1252a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragmentArguments != null && 1253a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn cur.fragmentArguments.equals(oh.fragmentArguments)) { 1254a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1255a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1256a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.extras != null && cur.extras.equals(oh.extras)) { 1257a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1258a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1259a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title != null && cur.title.equals(oh.title)) { 1260a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1261a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1262a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1263a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1264a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return null; 1265a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1266a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1267a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 1268aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * Start a new fragment. 1269aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * 1270aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param fragment The fragment to start 1271aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param push If true, the current fragment will be pushed onto the back stack. If false, 1272aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * the current fragment will be replaced. 1273aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler */ 1274aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler public void startPreferenceFragment(Fragment fragment, boolean push) { 127548e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 12768eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, fragment); 1277aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler if (push) { 12789ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 1279aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.addToBackStack(BACK_STACK_PREFS); 12809ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase } else { 1281327fbd2c8fa294b919475feb4c74a74ee1981e02Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 1282aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1283cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 1284aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1285aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler 1286c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 1287a47372c8617e8817d5b57aa6ed905017e7573224Amith Yamasani * Start a new fragment containing a preference panel. If the preferences 12888eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * are being displayed in multi-pane mode, the given fragment class will 12898eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * be instantiated and placed in the appropriate pane. If running in 12908eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * single-pane mode, a new activity will be launched in which to show the 12918eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 12928eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 12938eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param fragmentClass Full name of the class implementing the fragment. 12948eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param args Any desired arguments to supply to the fragment. 12958eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleRes Optional resource identifier of the title of this 12968eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 12978eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleText Optional text of the title of this fragment. 12988eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultTo Optional fragment that result data should be sent to. 12998eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * If non-null, resultTo.onActivityResult() will be called when this 13008eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * preference panel is done. The launched panel must use 13018eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * {@link #finishPreferencePanel(Fragment, int, Intent)} when done. 13028eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the caller's 13038eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * request code to be received with the resut. 1304c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 13058eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startPreferencePanel(String fragmentClass, Bundle args, int titleRes, 13068eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn CharSequence titleText, Fragment resultTo, int resultRequestCode) { 13078eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 1308e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(fragmentClass, args, resultTo, resultRequestCode, titleRes, 0); 13098eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 13108eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentClass, args); 13118eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo != null) { 13128eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn f.setTargetFragment(resultTo, resultRequestCode); 13138eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 131448e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 13158eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, f); 13168eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (titleRes != 0) { 13178eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleRes); 13188eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else if (titleText != null) { 13198eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleText); 13208eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 13218eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 13228eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.addToBackStack(BACK_STACK_PREFS); 1323cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 13248eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1325c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1326364ed4dda42882b600dce48319881ff58464fcedAmith Yamasani 13278eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn /** 13288eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Called by a preference panel fragment to finish itself. 13298eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 13308eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param caller The fragment that is asking to be finished. 13318eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultCode Optional result code to send back to the original 13328eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 13338eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultData Optional result data to send back to the original 13348eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 13358eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn */ 13368eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void finishPreferencePanel(Fragment caller, int resultCode, Intent resultData) { 13378eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 13388eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setResult(resultCode, resultData); 13398eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn finish(); 13408eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 13413a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn // XXX be smarter about popping the stack. 13423a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn onBackPressed(); 13438eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller != null) { 13448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller.getTargetFragment() != null) { 13458eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn caller.getTargetFragment().onActivityResult(caller.getTargetRequestCode(), 13468eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultCode, resultData); 13478eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 13488eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 13498eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 13508eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 13518eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 1352b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn @Override 1353b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) { 1354e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startPreferencePanel(pref.getFragment(), pref.getExtras(), pref.getTitleRes(), 1355e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn pref.getTitle(), null, 0); 1356b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn return true; 1357b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn } 1358b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Posts a message to bind the preferences to the list view. 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binding late is preferred as any custom preference types created in 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onCreate(Bundle)} are able to have their views recycled. 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void postBindPreferences() { 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler.hasMessages(MSG_BIND_PREFERENCES)) return; 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.obtainMessage(MSG_BIND_PREFERENCES).sendToTarget(); 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 136919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void bindPreferences() { 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final PreferenceScreen preferenceScreen = getPreferenceScreen(); 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (preferenceScreen != null) { 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project preferenceScreen.bind(getListView()); 1374e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell if (mSavedInstanceState != null) { 1375e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(mSavedInstanceState); 1376e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell mSavedInstanceState = null; 1377e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell } 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 138019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link PreferenceManager} used by this activity. 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceManager}. 1384b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1385b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1386b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1388b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceManager getPreferenceManager() { 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager; 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 139219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void requirePreferenceManager() { 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 1395b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter == null) { 1396b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("This should be called after super.onCreate."); 1397b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1398b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 1399b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn "Modern two-pane PreferenceActivity requires use of a PreferenceFragment"); 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the root of the preference hierarchy that this activity is showing. 140519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferenceScreen The root {@link PreferenceScreen} of the preference hierarchy. 1407b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1408b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1409b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1411b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreferenceScreen(PreferenceScreen preferenceScreen) { 1413b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn requirePreferenceManager(); 1414b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager.setPreferences(preferenceScreen) && preferenceScreen != null) { 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project postBindPreferences(); 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence title = getPreferenceScreen().getTitle(); 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set the title of the activity 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (title != null) { 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTitle(title); 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 142419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the root of the preference hierarchy that this activity is showing. 142719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceScreen} that is the root of the preference 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hierarchy. 1430b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1431b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1432b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1434b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceScreen getPreferenceScreen() { 1436b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1437b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return mPreferenceManager.getPreferenceScreen(); 1438b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1439b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return null; 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 144119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds preferences from activities that match the given {@link Intent}. 144419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The {@link Intent} to query activities. 1446b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1447b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1448b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1450b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromIntent(Intent intent) { 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 145319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromIntent(intent, getPreferenceScreen())); 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 145619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inflates the given XML resource and adds the preference hierarchy to the current 14599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preference hierarchy. 146019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferencesResId The XML resource ID to inflate. 1462b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1463b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1464b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1466b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromResource(int preferencesResId) { 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 146919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromResource(this, preferencesResId, 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getPreferenceScreen())); 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@inheritDoc} 1476b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1477b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1478b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1480b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 148419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Finds a {@link Preference} based on its key. 148719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key of the preference to retrieve. 14899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link Preference} with the key, or null. 14909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see PreferenceGroup#findPreference(CharSequence) 1491b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1492b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1493b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1495b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Preference findPreference(CharSequence key) { 149719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 150119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager.findPreference(key); 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onNewIntent(Intent intent) { 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager != null) { 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreferenceManager.dispatchNewIntent(intent); 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 151119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 151219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // give subclasses access to the Next button 151319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 151419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected boolean hasNextButton() { 151519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton != null; 151619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 151719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 151819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected Button getNextButton() { 151919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton; 152019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1522