PreferenceActivity.java revision e72f237defd9956a7e2d2e2bee8cd2558c3f83db
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 com.android.internal.util.XmlUtils; 20b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 21b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport org.xmlpull.v1.XmlPullParser; 22b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport org.xmlpull.v1.XmlPullParserException; 23b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 24c57406cdfa1925c3474e87865c51950b76ee0347Jim Millerimport android.app.ActionBar; 25b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.app.Fragment; 26c6669ca63299219d815464129dac051ab2404286Dianne Hackbornimport android.app.FragmentBreadCrumbs; 273a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackbornimport android.app.FragmentManager; 28aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.app.FragmentTransaction; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.ListActivity; 30b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.Context; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 32b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.Configuration; 3350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.content.res.Resources; 34b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.TypedArray; 35b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.XmlResourceParser; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 39a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcel; 40a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcelable; 4119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.text.TextUtils; 42b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.AttributeSet; 4350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.util.TypedValue; 44b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.Xml; 45b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.view.LayoutInflater; 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 4719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.view.View.OnClickListener; 48aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.view.ViewGroup; 49a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.widget.AbsListView; 50b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ArrayAdapter; 5119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.widget.Button; 525c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackbornimport android.widget.FrameLayout; 53b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ImageView; 54b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ListView; 55b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.TextView; 56b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 57b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.io.IOException; 58b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.ArrayList; 59b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.List; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 62b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * This is the base class for an activity to show a hierarchy of preferences 63b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to the user. Prior to {@link android.os.Build.VERSION_CODES#HONEYCOMB} 64b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * this class only allowed the display of a single set of preference; this 65b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * functionality should now be found in the new {@link PreferenceFragment} 66b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * class. If you are using PreferenceActivity in its old mode, the documentation 67b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * there applies to the deprecated APIs here. 68b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 69b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>This activity shows one or more headers of preferences, each of with 70b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * is associated with a {@link PreferenceFragment} to display the preferences 71b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of that header. The actual layout and display of these associations can 72b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * however vary; currently there are two major approaches it may take: 73b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 74b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 75b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a small screen it may display only the headers as a single list 76b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * when first launched. Selecting one of the header items will re-launch 77b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the activity with it only showing the PreferenceFragment of that header. 78b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a large screen in may display both the headers and current 79b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceFragment together as panes. Selecting a header item switches 80b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to showing the correct PreferenceFragment for that item. 81b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 82b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 83b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Subclasses of PreferenceActivity should implement 84b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@link #onBuildHeaders} to populate the header list with the desired 85b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * items. Doing this implicitly switches the class into its new "headers 86b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * + fragments" mode rather than the old style of just showing a single 87b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preferences list. 88b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 89b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <a name="SampleCode"></a> 90b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <h3>Sample Code</h3> 91b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 92b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The following sample code shows a simple preference activity that 93b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * has two different sets of preferences. The implementation, consisting 94b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of the activity itself as well as its two preference fragments is:</p> 95b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 96b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/preference/PreferenceWithHeaders.java 97b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity} 9819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 99b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The preference_headers resource describes the headers to be displayed 100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and the fragments associated with them. It is: 101b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 102b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/preference_headers.xml headers} 103b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 104b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>The first header is shown by Prefs1Fragment, which populates itself 105b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * from the following XML resource:</p> 106b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 107b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/fragmented_preferences.xml preferences} 108b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 109b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>Note that this XML resource contains a preference screen holding another 110b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment, the Prefs1FragmentInner implemented here. This allows the user 111b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * to traverse down a hierarchy of preferences; pressing back will pop each 112b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment off the stack to return to the previous preferences. 113b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 114b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>See {@link PreferenceFragment} for information on implementing the 115b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * fragments themselves. 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class PreferenceActivity extends ListActivity implements 118b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceManager.OnPreferenceTreeClickListener, 119b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceFragment.OnPreferenceStartFragmentCallback { 120b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private static final String TAG = "PreferenceActivity"; 12119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 122a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Constants for state save/restore 123a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String HEADERS_TAG = ":android:headers"; 124a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String CUR_HEADER_TAG = ":android:cur_header"; 125a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String PREFERENCES_TAG = ":android:preferences"; 12619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 127b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 128b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 129b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * string to specify which fragment should be initially displayed. 130b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 131b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT = ":android:show_fragment"; 132b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 133b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 134b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 135e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specified to supply a Bundle of arguments to pass 136b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to that fragment when it is instantiated during the initial creation 137b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * of PreferenceActivity. 138b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 139b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":android:show_fragment_args"; 140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 141b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 142e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 143e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the title to be shown for 144e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 145e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 146e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_TITLE = ":android:show_fragment_title"; 147e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 148e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 149e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 150e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this extra can also be specify to supply the short title to be shown for 151e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * that fragment. 152e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 153e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_SHORT_TITLE 154e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn = ":android:show_fragment_short_title"; 155e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 156e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 157b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 158b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * boolean that the header list should not be displayed. This is most often 159b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * used in conjunction with {@link #EXTRA_SHOW_FRAGMENT} to launch 160b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * the activity to display a specific fragment that the user has navigated 161b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to. 162b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 163b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_NO_HEADERS = ":android:no_headers"; 164b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 165b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn private static final String BACK_STACK_PREFS = ":android:prefs"; 166b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 16719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // extras that allow any preference activity to be launched as part of a wizard 16819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 16919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // show Back and Next buttons? takes boolean parameter 17019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // Back will then return RESULT_CANCELED and Next RESULT_OK 17119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SHOW_BUTTON_BAR = "extra_prefs_show_button_bar"; 17219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 17309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng // add a Skip button? 17409dbf1844016682ed461d080e32a43d0086e767dFreeman Ng private static final String EXTRA_PREFS_SHOW_SKIP = "extra_prefs_show_skip"; 17509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng 17619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // specify custom text for the Back or Next buttons, or cause a button to not appear 17719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // at all by setting it to null 17819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_NEXT_TEXT = "extra_prefs_set_next_text"; 17919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_BACK_TEXT = "extra_prefs_set_back_text"; 18019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 181b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for new mode when showing a list of headers + prefs fragment 182b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 183b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private final ArrayList<Header> mHeaders = new ArrayList<Header>(); 184b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 185b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private HeaderAdapter mAdapter; 186b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn private FrameLayout mListFooter; 1885c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 1893c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani private ViewGroup mPrefsContainer; 190b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 191c6669ca63299219d815464129dac051ab2404286Dianne Hackborn private FragmentBreadCrumbs mFragmentBreadCrumbs; 192c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 193b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private boolean mSinglePane; 194b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 195a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private Header mCurHeader; 196a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 197b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for old mode when showing a single preference list 19819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreferenceManager mPreferenceManager; 20019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 201e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell private Bundle mSavedInstanceState; 202e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 203b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- Common state 204b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 205b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private Button mNextButton; 206b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 2079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The starting request code given out to preference framework. 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int FIRST_REQUEST_CODE = 100; 21119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 2123e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BIND_PREFERENCES = 1; 2133e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BUILD_HEADERS = 2; 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Handler mHandler = new Handler() { 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 218a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BIND_PREFERENCES: { 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindPreferences(); 220a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 221a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BUILD_HEADERS: { 222a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> oldHeaders = new ArrayList<Header>(mHeaders); 223a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.clear(); 224b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn onBuildHeaders(mHeaders); 22583681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler if (mAdapter != null) { 22683681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler mAdapter.notifyDataSetChanged(); 22783681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler } 2285c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn Header header = onGetNewHeader(); 2295c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header != null && header.fragment != null) { 230a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(header, oldHeaders); 231a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader == null || mCurHeader != mappedHeader) { 232a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 233a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 234a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mCurHeader != null) { 235a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(mCurHeader, mHeaders); 236a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader != null) { 237a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mappedHeader); 238a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 2395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 240a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 245468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderAdapter extends ArrayAdapter<Header> { 246468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderViewHolder { 247468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler ImageView icon; 248468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView title; 249468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView summary; 250468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 251b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 252b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private LayoutInflater mInflater; 253b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 254b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public HeaderAdapter(Context context, List<Header> objects) { 255b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super(context, 0, objects); 256b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 257b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 258b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 259b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 260b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public View getView(int position, View convertView, ViewGroup parent) { 261b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn HeaderViewHolder holder; 262b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn View view; 263b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 264b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (convertView == null) { 265d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn view = mInflater.inflate(com.android.internal.R.layout.preference_header_item, 266b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parent, false); 267b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn holder = new HeaderViewHolder(); 268468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon); 269468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title = (TextView) view.findViewById(com.android.internal.R.id.title); 270468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary); 271b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view.setTag(holder); 272b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view = convertView; 274468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder = (HeaderViewHolder) view.getTag(); 275b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 276b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 277468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler // All view fields must be updated every time, because the view may be recycled 278b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = getItem(position); 279a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn holder.icon.setImageResource(header.iconRes); 28050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.title.setText(header.getTitle(getContext().getResources())); 28150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence summary = header.getSummary(getContext().getResources()); 28250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (!TextUtils.isEmpty(summary)) { 283468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.VISIBLE); 28450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setText(summary); 28550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 28650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setVisibility(View.GONE); 287468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 288b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 289b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return view; 290b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 291b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 292b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 293b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 294a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Default value for {@link Header#id Header.id} indicating that no 295a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * identifier value is set. All other values (including those below -1) 296a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * are valid. 297a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 298a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final long HEADER_ID_UNDEFINED = -1; 299a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 300a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 301b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Description of a single Header item that the user can select. 302b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 303a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final class Header implements Parcelable { 304a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 305a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Identifier for this header, to correlate with a new list when 306a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * it is updated. The default value is 307a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * {@link PreferenceActivity#HEADER_ID_UNDEFINED}, meaning no id. 308a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_id 309a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 310a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public long id = HEADER_ID_UNDEFINED; 311a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 312b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 31350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of title of the header that is shown to the user. 31450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 31550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 31650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int titleRes; 31750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 31850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 319b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Title of the header that is shown to the user. 320b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 321b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 322468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence title; 323b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 324b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 32550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional summary describing what this header controls. 32650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 32750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 32850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int summaryRes; 32950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 33050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 331b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional summary describing what this header controls. 332b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 333b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 334468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence summary; 335b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 336b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 33750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the title in the bread crumb. 33850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 33950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 34050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbTitleRes; 34150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 34250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 343c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the title in the bread crumb. 344c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 345c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 346c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbTitle; 347c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 348c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 34950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the short title in the bread crumb. 35050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 35150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 35250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbShortTitleRes; 35350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 35450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 355c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the short title in the bread crumb. 356c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 357c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 358c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbShortTitle; 359c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 360c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 361b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional icon resource to show for this header. 362b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_icon 363b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 364468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public int iconRes; 365b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 366b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 367b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Full class name of the fragment to display when this header is 368b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * selected. 369b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_fragment 370b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 371468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public String fragment; 372b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 373b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 374b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Optional arguments to supply to the fragment when it is 375b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * instantiated. 376b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 377468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public Bundle fragmentArguments; 3785c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 3795c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 3805c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Intent to launch when the preference is selected. 3815c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 3825c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Intent intent; 383a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 384a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 385a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Optional additional data for use by subclasses of PreferenceActivity. 386a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 387a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Bundle extras; 388a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 389a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header() { 390a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 391a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 39250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 39350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set title. If {@link #titleRes} is set, 39450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 39550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #title} is returned. 39650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 39750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getTitle(Resources res) { 39850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (titleRes != 0) { 39950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(titleRes); 40050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 40150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return title; 40250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 40350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 40450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 40550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set summary. If {@link #summaryRes} is set, 40650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 40750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #summary} is returned. 40850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 40950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getSummary(Resources res) { 41050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (summaryRes != 0) { 41150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(summaryRes); 41250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 4139d0718042f7c0a50d825c621f82ce9a92071f07aDianne Hackborn return summary; 41450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 41550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 41650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 41750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb title. If {@link #breadCrumbTitleRes} is set, 41850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 41950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbTitle} is returned. 42050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 42150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbTitle(Resources res) { 42250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbTitleRes != 0) { 42350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbTitleRes); 42450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 42550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbTitle; 42650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 42750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 42850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 42950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb short title. If 43050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitleRes} is set, 43150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 43250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitle} is returned. 43350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 43450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbShortTitle(Resources res) { 43550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbShortTitleRes != 0) { 43650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbShortTitleRes); 43750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 43850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbShortTitle; 43950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 44050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 441a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 442a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public int describeContents() { 443a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return 0; 444a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 445a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 446a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 447a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 448a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeLong(id); 44950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(titleRes); 450a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(title, dest, flags); 45150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(summaryRes); 452a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(summary, dest, flags); 45350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbTitleRes); 454c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbTitle, dest, flags); 45550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbShortTitleRes); 456c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbShortTitle, dest, flags); 457a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(iconRes); 458a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeString(fragment); 459a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(fragmentArguments); 460a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (intent != null) { 461a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(1); 462a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent.writeToParcel(dest, flags); 463a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 464a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(0); 465a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 466a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(extras); 467a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 468a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 469a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void readFromParcel(Parcel in) { 470a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn id = in.readLong(); 47150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn titleRes = in.readInt(); 472a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn title = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 47350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn summaryRes = in.readInt(); 474a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn summary = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 47550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbTitleRes = in.readInt(); 476c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 47750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbShortTitleRes = in.readInt(); 478c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbShortTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 479a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn iconRes = in.readInt(); 480a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragment = in.readString(); 481a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragmentArguments = in.readBundle(); 482a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (in.readInt() != 0) { 483a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent = Intent.CREATOR.createFromParcel(in); 484a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 485a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn extras = in.readBundle(); 486a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 487a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 488a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header(Parcel in) { 489a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn readFromParcel(in); 490a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 491a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 492a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final Creator<Header> CREATOR = new Creator<Header>() { 493a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header createFromParcel(Parcel source) { 494a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header(source); 495a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 496a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header[] newArray(int size) { 497a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header[size]; 498a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 499a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn }; 500b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 501b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onCreate(Bundle savedInstanceState) { 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 506e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (getResources().getConfiguration().isLayoutSizeAtLeast( 507e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Configuration.SCREENLAYOUT_SIZE_LARGE)) { 508e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setContentView(com.android.internal.R.layout.preference_list_content_large); 509e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } else { 510e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setContentView(com.android.internal.R.layout.preference_list_content); 511e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 51219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 5135c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter = (FrameLayout)findViewById(com.android.internal.R.id.list_footer); 5143c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs_frame); 515b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn boolean hidingHeaders = onIsHidingHeaders(); 516b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSinglePane = hidingHeaders || !onIsMultiPane(); 517b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn String initialFragment = getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT); 518b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn Bundle initialArguments = getIntent().getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS); 519e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_TITLE, 0); 520e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int initialShortTitle = getIntent().getIntExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, 0); 521b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 522a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (savedInstanceState != null) { 523a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We are restarting from a previous saved state; used that to 524a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // initialize, instead of starting fresh. 525a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> headers = savedInstanceState.getParcelableArrayList(HEADERS_TAG); 526a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (headers != null) { 527a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.addAll(headers); 528a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int curHeader = savedInstanceState.getInt(CUR_HEADER_TAG, 529a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 530a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (curHeader >= 0 && curHeader < mHeaders.size()) { 531a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mHeaders.get(curHeader)); 532a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 533a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 534b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 535b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 536a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 537a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If we are just showing a fragment, we want to run in 538a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // new fragment mode, but don't need to compute and show 539a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the headers. 540a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 541e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (initialTitle != 0) { 542e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn CharSequence initialTitleStr = getText(initialTitle); 543e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn CharSequence initialShortTitleStr = initialShortTitle != 0 544e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn ? getText(initialShortTitle) : null; 545e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn showBreadCrumbs(initialTitleStr, initialShortTitleStr); 546e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 547a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 548a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 549a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We need to try to build the headers. 550a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn onBuildHeaders(mHeaders); 551a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 552a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If there are headers, then at this point we need to show 553a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // them and, depending on the screen, we may also show in-line 554a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the currently selected preference fragment. 555a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 556a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 557a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment == null) { 558a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header h = onGetInitialHeader(); 559a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(h); 560a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 561a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 562a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 563b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 564b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 565a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 566a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 567b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 568a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // The default configuration is to only show the list view. Adjust 569a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // visibility for other configurations. 570a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 571a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Single pane, showing just a prefs fragment. 57205fbc31ed9c6ac13a7aeddc176f19a5c17217e30Amith Yamasani findViewById(com.android.internal.R.id.headers).setVisibility(View.GONE); 573a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 574a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mHeaders.size() > 0) { 575a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mAdapter = new HeaderAdapter(this, mHeaders); 576a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setListAdapter(mAdapter); 577a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 578a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Multi-pane. 579a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setChoiceMode(AbsListView.CHOICE_MODE_SINGLE); 580d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn if (mCurHeader != null) { 581d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn setSelectedHeader(mCurHeader); 582d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn } 583a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 584a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 585a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 586b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // If there are no headers, we are in the old "just show a screen 587b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // of preferences" mode. 588e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (getResources().getConfiguration().isLayoutSizeAtLeast( 589e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Configuration.SCREENLAYOUT_SIZE_LARGE)) { 590e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setContentView(com.android.internal.R.layout.preference_list_content_single_large); 591e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } else { 592e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setContentView(com.android.internal.R.layout.preference_list_content_single); 593e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 5948da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mListFooter = (FrameLayout) findViewById(com.android.internal.R.id.list_footer); 5953c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mPrefsContainer = (ViewGroup) findViewById(com.android.internal.R.id.prefs); 596a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager = new PreferenceManager(this, FIRST_REQUEST_CODE); 597a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager.setOnPreferenceTreeClickListener(this); 598b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 599b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 600b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn getListView().setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY); 601b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 60219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // see if we should show Back/Next buttons 60319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Intent intent = getIntent(); 60419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_BUTTON_BAR, false)) { 60519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 60619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng findViewById(com.android.internal.R.id.button_bar).setVisibility(View.VISIBLE); 60719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 60819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Button backButton = (Button)findViewById(com.android.internal.R.id.back_button); 60919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setOnClickListener(new OnClickListener() { 61019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 61119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_CANCELED); 61219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 61319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 61419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 61509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng Button skipButton = (Button)findViewById(com.android.internal.R.id.skip_button); 61609dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setOnClickListener(new OnClickListener() { 61709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng public void onClick(View v) { 61809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng setResult(RESULT_OK); 61909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng finish(); 62009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 62109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng }); 62219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton = (Button)findViewById(com.android.internal.R.id.next_button); 62319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setOnClickListener(new OnClickListener() { 62419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 62519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_OK); 62619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 62719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 62819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 62919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 63019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // set our various button parameters 63119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_NEXT_TEXT)) { 63219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_NEXT_TEXT); 63319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 63419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setVisibility(View.GONE); 63519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 63619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 63719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setText(buttonText); 63819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 63919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_BACK_TEXT)) { 64119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_BACK_TEXT); 64219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 64319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setVisibility(View.GONE); 64419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 64619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setText(buttonText); 64719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 64909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_SKIP, false)) { 65009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setVisibility(View.VISIBLE); 65109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 65219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 653b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 654b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 655b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 656291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is currently showing the header list. 657291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 658291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean hasHeaders() { 659291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return getListView().getVisibility() == View.VISIBLE 660291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn && mPreferenceManager == null; 661291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 662291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 663291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 664291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is showing multiple panes -- the headers 665291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * and a preference fragment. 666291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 667291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean isMultiPane() { 668291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return hasHeaders() && mPrefsContainer.getVisibility() == View.VISIBLE; 669291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 670291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 671291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 672b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called to determine if the activity should run in multi-pane mode. 673b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * The default implementation returns true if the screen is large 674b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * enough. 675b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 676b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsMultiPane() { 677b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Configuration config = getResources().getConfiguration(); 678b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 679c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_XLARGE) { 680c6669ca63299219d815464129dac051ab2404286Dianne Hackborn return true; 681c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 682c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 683c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_LARGE 684b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && config.orientation == Configuration.ORIENTATION_LANDSCAPE) { 685b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return true; 686b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 687b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return false; 688b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 689b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 690b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 691291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Called to determine whether the header list should be hidden. 692291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * The default implementation returns the 693291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * value given in {@link #EXTRA_NO_HEADERS} or false if it is not supplied. 694291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * This is set to false, for example, when the activity is being re-launched 695291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * to show a particular preference activity. 696b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 697b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsHidingHeaders() { 698b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return getIntent().getBooleanExtra(EXTRA_NO_HEADERS, false); 699b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 700b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 701b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 702b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Called to determine the initial header to be shown. The default 703b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * implementation simply returns the fragment of the first header. Note 704b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * that the returned Header object does not actually need to exist in 705b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * your header list -- whatever its fragment is will simply be used to 706b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * show for the initial UI. 707b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 708b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public Header onGetInitialHeader() { 709b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return mHeaders.get(0); 710b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 711b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 712b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 7135c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Called after the header list has been updated ({@link #onBuildHeaders} 7145c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * has been called and returned due to {@link #invalidateHeaders()}) to 7155c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * specify the header that should now be selected. The default implementation 7165c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * returns null to keep whatever header is currently selected. 7175c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 7185c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Header onGetNewHeader() { 7195c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn return null; 7205c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 7215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 7225c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 723b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the activity needs its list of headers build. By 724b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * implementing this and adding at least one item to the list, you 725b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will cause the activity to run in its modern fragment mode. Note 726b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * that this function may not always be called; for example, if the 727b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity has been asked to display a particular fragment without 728b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the header list, there is no need to build the headers. 729b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 730b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Typical implementations will use {@link #loadHeadersFromResource} 731b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to fill in the list from a resource. 732b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 733b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which to place the headers. 734b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 735b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onBuildHeaders(List<Header> target) { 736b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 737b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 738b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 739b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Call when you need to change the headers being displayed. Will result 740b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * in onBuildHeaders() later being called to retrieve the new list. 741b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 742b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void invalidateHeaders() { 743b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn if (!mHandler.hasMessages(MSG_BUILD_HEADERS)) { 744b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn mHandler.sendEmptyMessage(MSG_BUILD_HEADERS); 745b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 746b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 747b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 748b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 749b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Parse the given XML file as a header description, adding each 750b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * parsed Header into the target list. 751b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 752b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param resid The XML resource to load and parse. 753b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which the parsed headers should be placed. 754b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 755b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void loadHeadersFromResource(int resid, List<Header> target) { 756b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlResourceParser parser = null; 757b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn try { 758b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parser = getResources().getXml(resid); 759b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn AttributeSet attrs = Xml.asAttributeSet(parser); 760b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 761b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn int type; 762b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 763b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && type != XmlPullParser.START_TAG) { 764b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 765b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 766b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn String nodeName = parser.getName(); 767def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (!"preference-headers".equals(nodeName)) { 768b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 769def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn "XML document must start with <preference-headers> tag; found" 770b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn + nodeName + " at " + parser.getPositionDescription()); 771b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 772b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 773def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn Bundle curBundle = null; 774def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn 7755c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int outerDepth = parser.getDepth(); 776b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 777b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) { 778b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 779b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn continue; 780b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 781b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 782b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn nodeName = parser.getName(); 783def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if ("header".equals(nodeName)) { 784b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = new Header(); 785b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 786b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn TypedArray sa = getResources().obtainAttributes(attrs, 787b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader); 788ed13cde1de86933f64285fa34e3a3aca80994859Amith Yamasani header.id = sa.getResourceId( 789a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn com.android.internal.R.styleable.PreferenceHeader_id, 790a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 79150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn TypedValue tv = sa.peekValue( 792b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_title); 79350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 79450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 79550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.titleRes = tv.resourceId; 79650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 79750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.title = tv.string; 79850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 79950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 80050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 801b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_summary); 80250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 80350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 80450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summaryRes = tv.resourceId; 80550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 80650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summary = tv.string; 80750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 80850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 80950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 810c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle); 81150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 81250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 81350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitleRes = tv.resourceId; 81450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 81550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitle = tv.string; 81650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 81750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 81850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 819c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle); 82050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 82150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 82250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitleRes = tv.resourceId; 82350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 82450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitle = tv.string; 82550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 82650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 827b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.iconRes = sa.getResourceId( 828b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_icon, 0); 829b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.fragment = sa.getString( 830b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_fragment); 831b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn sa.recycle(); 832b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 833def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle == null) { 834def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = new Bundle(); 835def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 8365c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8375c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int innerDepth = parser.getDepth(); 8385c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 8395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) { 8405c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 8415c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn continue; 8425c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8435c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8445c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn String innerNodeName = parser.getName(); 8455c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (innerNodeName.equals("extra")) { 8465c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn getResources().parseBundleExtra("extra", attrs, curBundle); 8475c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8485c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8495c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (innerNodeName.equals("intent")) { 8505c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn header.intent = Intent.parseIntent(getResources(), parser, attrs); 8515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8525c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 8535c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8545c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8555c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8565c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 857def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle.size() > 0) { 858def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn header.fragmentArguments = curBundle; 859def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = null; 860def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 861b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 862def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn target.add(header); 863b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 864b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlUtils.skipCurrentTag(parser); 865b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 866b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 867b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 868b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (XmlPullParserException e) { 869b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 870b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (IOException e) { 871b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 872b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } finally { 873b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (parser != null) parser.close(); 874b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 87519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8785c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 8795c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Set a footer that should be shown at the bottom of the header list. 8805c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 8815c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public void setListFooter(View view) { 8825c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.removeAllViews(); 8835c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.addView(view, new FrameLayout.LayoutParams( 8845c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.MATCH_PARENT, 8855c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.WRAP_CONTENT)); 8865c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 89119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 892b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 893b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityStop(); 894b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 900b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 901b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 902b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityDestroy(); 903b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 910a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 911a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putParcelableArrayList(HEADERS_TAG, mHeaders); 912a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mCurHeader != null) { 913a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(mCurHeader); 914a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 915a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putInt(CUR_HEADER_TAG, index); 916a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 917a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 918a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 919a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 920b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 921b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 922b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 923b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = new Bundle(); 924b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.saveHierarchyState(container); 925b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn outState.putBundle(PREFERENCES_TAG, container); 926b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onRestoreInstanceState(Bundle state) { 932b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 933b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = state.getBundle(PREFERENCES_TAG); 934b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (container != null) { 935b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 936b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 937b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.restoreHierarchyState(container); 938b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSavedInstanceState = state; 939b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return; 940b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 943e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 944e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // Only call this if we didn't save the instance state for later. 945e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // If we did save it, it will be restored when we bind the adapter. 946e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(state); 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onActivityResult(int requestCode, int resultCode, Intent data) { 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onActivityResult(requestCode, resultCode, data); 95219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 953b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 954b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityResult(requestCode, resultCode, data); 955b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onContentChanged() { 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onContentChanged(); 961b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 962b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 963b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn postBindPreferences(); 964b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 965b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 966b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 967b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 968b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn protected void onListItemClick(ListView l, View v, int position, long id) { 969b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super.onListItemClick(l, v, position, id); 970b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 971b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter != null) { 972b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn onHeaderClick(mHeaders.get(position), position); 973b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 974b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 975b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 976b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 977b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the user selects an item in the header list. The default 978e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * implementation will call either 979e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 980a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * or {@link #switchToHeader(Header)} as appropriate. 981b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 982b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param header The header that was selected. 983b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param position The header's position in the list. 984b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 985b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onHeaderClick(Header header, int position) { 9865c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header.fragment != null) { 9875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (mSinglePane) { 988e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int titleRes = header.breadCrumbTitleRes; 989e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int shortTitleRes = header.breadCrumbShortTitleRes; 990e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (titleRes == 0) { 991e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn titleRes = header.titleRes; 992e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn shortTitleRes = 0; 993e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 994e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(header.fragment, header.fragmentArguments, null, 0, 995e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn titleRes, shortTitleRes); 9965c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 997a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 9985c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9995c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (header.intent != null) { 10005c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn startActivity(header.intent); 1001b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1002b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1003b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1004b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1005e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Called by {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} when 1006b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * in single-pane mode, to build an Intent to launch a new activity showing 1007b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the selected fragment. The default implementation constructs an Intent 1008b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * that re-launches the current activity with the appropriate arguments to 1009b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * display the fragment. 1010b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * 1011b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param fragmentName The name of the fragment to display. 1012b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1013e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Optional resource ID of title to show for this item. 1014e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Optional resource ID of short title to show for this item. 1015b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @return Returns an Intent that can be launched to display the given 1016b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * fragment. 1017b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn */ 1018e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public Intent onBuildStartFragmentIntent(String fragmentName, Bundle args, 1019e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn int titleRes, int shortTitleRes) { 1020b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn Intent intent = new Intent(Intent.ACTION_MAIN); 1021b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.setClass(this, getClass()); 1022b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName); 1023b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args); 1024e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_TITLE, titleRes); 1025e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_SHORT_TITLE, shortTitleRes); 1026b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn intent.putExtra(EXTRA_NO_HEADERS, true); 1027b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn return intent; 1028b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn } 1029b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn 1030b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn /** 1031e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * Like {@link #startWithFragment(String, Bundle, Fragment, int, int, int)} 1032e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * but uses a 0 titleRes. 1033e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn */ 1034e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 1035e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Fragment resultTo, int resultRequestCode) { 1036e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(fragmentName, args, resultTo, resultRequestCode, 0, 0); 1037e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 1038e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn 1039e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn /** 1040b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Start a new instance of this activity, showing only the given 1041b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. When launched in this mode, the header list 1042b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will be hidden and the given preference fragment will be instantiated 1043b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and fill the entire activity. 1044b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1045b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1046b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1047b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultTo Option fragment that should receive the result of 1048b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * the activity launch. 1049b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the request 1050b1a6e439f63e4fa2b07a4905f00b6badf58e6420Dianne Hackborn * code in which to report the result. 1051e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Resource ID of string to display for the title of 1052e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 1053e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * @param titleRes Resource ID of string to display for the short title of 1054e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn * this set of preferences. 1055b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 10568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 1057e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Fragment resultTo, int resultRequestCode, int titleRes, int shortTitleRes) { 1058e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn Intent intent = onBuildStartFragmentIntent(fragmentName, args, titleRes, shortTitleRes); 10598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo == null) { 10608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startActivity(intent); 10618eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 10628eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultTo.startActivityForResult(intent, resultRequestCode); 10638eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1064b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1065b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1066c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 1067c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Change the base title of the bread crumbs for the current preferences. 1068c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * This will normally be called for you. See 1069c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * {@link android.app.FragmentBreadCrumbs} for more information. 1070c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 1071c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public void showBreadCrumbs(CharSequence title, CharSequence shortTitle) { 1072c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (mFragmentBreadCrumbs == null) { 10733e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani View crumbs = findViewById(android.R.id.title); 10743e86040439d030e44eca4da81d0217046fcac55cAmith Yamasani // For screens with a different kind of title, don't create breadcrumbs. 1075e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn try { 1076e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn mFragmentBreadCrumbs = (FragmentBreadCrumbs)crumbs; 1077e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } catch (ClassCastException e) { 1078e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1079e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn } 10803c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani if (mFragmentBreadCrumbs == null) { 1081e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn if (title != null) { 1082e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn setTitle(title); 10833c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani } 1084e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn return; 1085c57406cdfa1925c3474e87865c51950b76ee0347Jim Miller } 10863c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setMaxVisible(2); 10873c9f519f898f8fc809550199ea823c0225c682a8Amith Yamasani mFragmentBreadCrumbs.setActivity(this); 1088c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1089c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs.setTitle(title, shortTitle); 1090c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani mFragmentBreadCrumbs.setParentTitle(null, null, null); 1091c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1092c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani 1093c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani /** 1094c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * Should be called after onCreate to ensure that the breadcrumbs, if any, were created. 1095c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * This prepends a title to the fragment breadcrumbs and attaches a listener to any clicks 1096c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * on the parent entry. 1097c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param title the title for the breadcrumb 1098c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani * @param shortTitle the short title for the breadcrumb 1099c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani */ 1100c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani public void setParentTitle(CharSequence title, CharSequence shortTitle, 1101c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani OnClickListener listener) { 1102c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani if (mFragmentBreadCrumbs != null) { 1103c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani mFragmentBreadCrumbs.setParentTitle(title, shortTitle, listener); 1104c9ecb73ccdab767e7904232d46b660fdd7a9aad7Amith Yamasani } 1105c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1106c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 1107a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn void setSelectedHeader(Header header) { 1108a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mCurHeader = header; 1109a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(header); 1110a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 1111a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setItemChecked(index, true); 1112a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 1113a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().clearChoices(); 1114a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1115c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (header != null) { 111650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence title = header.getBreadCrumbTitle(getResources()); 111750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (title == null) title = header.getTitle(getResources()); 1118c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = getTitle(); 111950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn showBreadCrumbs(title, header.getBreadCrumbShortTitle(getResources())); 1120c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } else { 1121c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(getTitle(), null); 1122c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1123c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1124c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 1125f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani private void switchToHeaderInner(String fragmentName, Bundle args, int direction) { 11263a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 11273a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 1128c6669ca63299219d815464129dac051ab2404286Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentName, args); 112948e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 1130327fbd2c8fa294b919475feb4c74a74ee1981e02Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 11319ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.replace(com.android.internal.R.id.prefs, f); 1132cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 1133a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1134a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1135b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1136b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * When in two-pane mode, switch the fragment pane to show the given 1137b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. 1138b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1139b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1141b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1142b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void switchToHeader(String fragmentName, Bundle args) { 1143a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(null); 1144f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani switchToHeaderInner(fragmentName, args, 0); 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1147aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler /** 1148a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * When in two-pane mode, switch to the fragment pane to show the given 1149a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * preference fragment. 1150a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * 1151a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @param header The new header to display. 1152a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 1153a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void switchToHeader(Header header) { 11548eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mCurHeader == header) { 11558eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // This is the header we are currently displaying. Just make sure 11568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // to pop the stack up to its root state. 11573a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 11583a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 11598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 11608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn int direction = mHeaders.indexOf(header) - mHeaders.indexOf(mCurHeader); 11618eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn switchToHeaderInner(header.fragment, header.fragmentArguments, direction); 11628eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setSelectedHeader(header); 11638eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1164a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1165a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1166a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header findBestMatchingHeader(Header cur, ArrayList<Header> from) { 1167a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> matches = new ArrayList<Header>(); 1168a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<from.size(); j++) { 1169a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = from.get(j); 1170a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur == oh || (cur.id != HEADER_ID_UNDEFINED && cur.id == oh.id)) { 1171a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Must be this one. 1172a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.clear(); 1173a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1174a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn break; 1175a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1176a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment != null) { 1177a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment.equals(oh.fragment)) { 1178a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1179a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1180a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.intent != null) { 1181a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.intent.equals(oh.intent)) { 1182a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1183a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1184a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.title != null) { 1185a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title.equals(oh.title)) { 1186a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1187a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1188a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1189a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1190a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn final int NM = matches.size(); 1191a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (NM == 1) { 1192a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return matches.get(0); 1193a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (NM > 1) { 1194a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<NM; j++) { 1195a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = matches.get(j); 1196a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragmentArguments != null && 1197a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn cur.fragmentArguments.equals(oh.fragmentArguments)) { 1198a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1199a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1200a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.extras != null && cur.extras.equals(oh.extras)) { 1201a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1202a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1203a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title != null && cur.title.equals(oh.title)) { 1204a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1205a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1206a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1207a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1208a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return null; 1209a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1210a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1211a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 1212aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * Start a new fragment. 1213aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * 1214aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param fragment The fragment to start 1215aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param push If true, the current fragment will be pushed onto the back stack. If false, 1216aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * the current fragment will be replaced. 1217aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler */ 1218aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler public void startPreferenceFragment(Fragment fragment, boolean push) { 121948e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 12208eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, fragment); 1221aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler if (push) { 12229ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 1223aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.addToBackStack(BACK_STACK_PREFS); 12249ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase } else { 1225327fbd2c8fa294b919475feb4c74a74ee1981e02Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_FADE); 1226aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1227cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 1228aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1229aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler 1230c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 12318eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Start a new fragment containing a preference panel. If the prefences 12328eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * are being displayed in multi-pane mode, the given fragment class will 12338eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * be instantiated and placed in the appropriate pane. If running in 12348eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * single-pane mode, a new activity will be launched in which to show the 12358eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 12368eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 12378eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param fragmentClass Full name of the class implementing the fragment. 12388eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param args Any desired arguments to supply to the fragment. 12398eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleRes Optional resource identifier of the title of this 12408eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 12418eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleText Optional text of the title of this fragment. 12428eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultTo Optional fragment that result data should be sent to. 12438eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * If non-null, resultTo.onActivityResult() will be called when this 12448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * preference panel is done. The launched panel must use 12458eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * {@link #finishPreferencePanel(Fragment, int, Intent)} when done. 12468eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the caller's 12478eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * request code to be received with the resut. 1248c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 12498eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startPreferencePanel(String fragmentClass, Bundle args, int titleRes, 12508eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn CharSequence titleText, Fragment resultTo, int resultRequestCode) { 12518eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 1252e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startWithFragment(fragmentClass, args, resultTo, resultRequestCode, titleRes, 0); 12538eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 12548eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentClass, args); 12558eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo != null) { 12568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn f.setTargetFragment(resultTo, resultRequestCode); 12578eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 125848e7b458694acdf3a4fc58e62437f1dbc4f29d83Dianne Hackborn FragmentTransaction transaction = getFragmentManager().beginTransaction(); 12598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, f); 12608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (titleRes != 0) { 12618eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleRes); 12628eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else if (titleText != null) { 12638eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleText); 12648eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 12658eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 12668eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.addToBackStack(BACK_STACK_PREFS); 1267cf407ad88bef3bc640489b300f23eaa8ea0b724eDianne Hackborn transaction.commitAllowingStateLoss(); 12688eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1269c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 12708eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 12718eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn /** 12728eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Called by a preference panel fragment to finish itself. 12738eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 12748eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param caller The fragment that is asking to be finished. 12758eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultCode Optional result code to send back to the original 12768eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 12778eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultData Optional result data to send back to the original 12788eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 12798eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn */ 12808eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void finishPreferencePanel(Fragment caller, int resultCode, Intent resultData) { 12818eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 12828eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setResult(resultCode, resultData); 12838eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn finish(); 12848eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 12853a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn // XXX be smarter about popping the stack. 12863a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn onBackPressed(); 12878eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller != null) { 12888eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller.getTargetFragment() != null) { 12898eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn caller.getTargetFragment().onActivityResult(caller.getTargetRequestCode(), 12908eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultCode, resultData); 12918eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 12928eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 12938eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 12948eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 12958eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 1296b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn @Override 1297b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) { 1298e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn startPreferencePanel(pref.getFragment(), pref.getExtras(), pref.getTitleRes(), 1299e72f237defd9956a7e2d2e2bee8cd2558c3f83dbDianne Hackborn pref.getTitle(), null, 0); 1300b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn return true; 1301b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn } 1302b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Posts a message to bind the preferences to the list view. 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binding late is preferred as any custom preference types created in 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onCreate(Bundle)} are able to have their views recycled. 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void postBindPreferences() { 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler.hasMessages(MSG_BIND_PREFERENCES)) return; 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.obtainMessage(MSG_BIND_PREFERENCES).sendToTarget(); 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 131319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void bindPreferences() { 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final PreferenceScreen preferenceScreen = getPreferenceScreen(); 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (preferenceScreen != null) { 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project preferenceScreen.bind(getListView()); 1318e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell if (mSavedInstanceState != null) { 1319e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(mSavedInstanceState); 1320e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell mSavedInstanceState = null; 1321e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell } 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 132419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link PreferenceManager} used by this activity. 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceManager}. 1328b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1329b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1330b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1332b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceManager getPreferenceManager() { 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager; 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 133619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void requirePreferenceManager() { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 1339b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter == null) { 1340b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("This should be called after super.onCreate."); 1341b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1342b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 1343b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn "Modern two-pane PreferenceActivity requires use of a PreferenceFragment"); 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the root of the preference hierarchy that this activity is showing. 134919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferenceScreen The root {@link PreferenceScreen} of the preference hierarchy. 1351b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1352b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1353b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1355b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreferenceScreen(PreferenceScreen preferenceScreen) { 1357b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn requirePreferenceManager(); 1358b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager.setPreferences(preferenceScreen) && preferenceScreen != null) { 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project postBindPreferences(); 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence title = getPreferenceScreen().getTitle(); 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set the title of the activity 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (title != null) { 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTitle(title); 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 136819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the root of the preference hierarchy that this activity is showing. 137119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceScreen} that is the root of the preference 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hierarchy. 1374b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1375b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1376b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1378b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceScreen getPreferenceScreen() { 1380b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1381b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return mPreferenceManager.getPreferenceScreen(); 1382b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1383b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return null; 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 138519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds preferences from activities that match the given {@link Intent}. 138819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The {@link Intent} to query activities. 1390b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1391b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1392b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1394b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromIntent(Intent intent) { 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 139719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromIntent(intent, getPreferenceScreen())); 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 140019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inflates the given XML resource and adds the preference hierarchy to the current 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preference hierarchy. 140419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferencesResId The XML resource ID to inflate. 1406b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1407b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1408b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1410b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromResource(int preferencesResId) { 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 141319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromResource(this, preferencesResId, 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getPreferenceScreen())); 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@inheritDoc} 1420b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1421b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1422b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1424b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 142819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Finds a {@link Preference} based on its key. 143119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key of the preference to retrieve. 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link Preference} with the key, or null. 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see PreferenceGroup#findPreference(CharSequence) 1435b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1436b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1437b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 14389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1439b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Preference findPreference(CharSequence key) { 144119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 14449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 144519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager.findPreference(key); 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 14509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onNewIntent(Intent intent) { 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager != null) { 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreferenceManager.dispatchNewIntent(intent); 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 145519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 145619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // give subclasses access to the Next button 145719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 145819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected boolean hasNextButton() { 145919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton != null; 146019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 146119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 146219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected Button getNextButton() { 146319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton; 146419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1466