PreferenceActivity.java revision 3a57fb9e9c4f205ca6bd4f036b3080f92588d16d
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 24b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.app.Fragment; 25c6669ca63299219d815464129dac051ab2404286Dianne Hackbornimport android.app.FragmentBreadCrumbs; 263a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackbornimport android.app.FragmentManager; 27aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.app.FragmentTransaction; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.app.ListActivity; 29b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.Context; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.content.Intent; 31b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.Configuration; 32b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.TypedArray; 33b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.XmlResourceParser; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 37a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcel; 38a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcelable; 3919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.text.TextUtils; 40b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.AttributeSet; 41b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.Xml; 42b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.view.LayoutInflater; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 4419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.view.View.OnClickListener; 45aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.view.ViewGroup; 46a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.widget.AbsListView; 47b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ArrayAdapter; 4819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.widget.Button; 495c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackbornimport android.widget.FrameLayout; 50b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ImageView; 51b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ListView; 52b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.TextView; 53b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 54b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.io.IOException; 55b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.ArrayList; 56b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.List; 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 59b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * This is the base class for an activity to show a hierarchy of preferences 60b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to the user. Prior to {@link android.os.Build.VERSION_CODES#HONEYCOMB} 61b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * this class only allowed the display of a single set of preference; this 62b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * functionality should now be found in the new {@link PreferenceFragment} 63b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * class. If you are using PreferenceActivity in its old mode, the documentation 64b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * there applies to the deprecated APIs here. 65b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 66b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>This activity shows one or more headers of preferences, each of with 67b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * is associated with a {@link PreferenceFragment} to display the preferences 68b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of that header. The actual layout and display of these associations can 69b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * however vary; currently there are two major approaches it may take: 70b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 71b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 72b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a small screen it may display only the headers as a single list 73b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * when first launched. Selecting one of the header items will re-launch 74b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the activity with it only showing the PreferenceFragment of that header. 75b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a large screen in may display both the headers and current 76b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceFragment together as panes. Selecting a header item switches 77b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to showing the correct PreferenceFragment for that item. 78b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 79b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 80b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Subclasses of PreferenceActivity should implement 81b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@link #onBuildHeaders} to populate the header list with the desired 82b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * items. Doing this implicitly switches the class into its new "headers 83b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * + fragments" mode rather than the old style of just showing a single 84b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preferences list. 85b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 86b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <a name="SampleCode"></a> 87b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <h3>Sample Code</h3> 88b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 89b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The following sample code shows a simple preference activity that 90b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * has two different sets of preferences. The implementation, consisting 91b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of the activity itself as well as its two preference fragments is:</p> 92b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 93b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/preference/PreferenceWithHeaders.java 94b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity} 9519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 96b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The preference_headers resource describes the headers to be displayed 97b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and the fragments associated with them. It is: 98b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 99b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/preference_headers.xml headers} 100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 101b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>The first header is shown by Prefs1Fragment, which populates itself 102b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * from the following XML resource:</p> 103b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 104b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/fragmented_preferences.xml preferences} 105b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 106b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>Note that this XML resource contains a preference screen holding another 107b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment, the Prefs1FragmentInner implemented here. This allows the user 108b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * to traverse down a hierarchy of preferences; pressing back will pop each 109b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment off the stack to return to the previous preferences. 110b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 111b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>See {@link PreferenceFragment} for information on implementing the 112b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * fragments themselves. 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class PreferenceActivity extends ListActivity implements 115b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceManager.OnPreferenceTreeClickListener, 116b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceFragment.OnPreferenceStartFragmentCallback { 117b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private static final String TAG = "PreferenceActivity"; 11819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 119a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Constants for state save/restore 120a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String HEADERS_TAG = ":android:headers"; 121a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String CUR_HEADER_TAG = ":android:cur_header"; 122a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String PREFERENCES_TAG = ":android:preferences"; 12319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 124b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 125b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 126b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * string to specify which fragment should be initially displayed. 127b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 128b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT = ":android:show_fragment"; 129b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 130b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 131b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 132b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * this extra can also be specify to supply a Bundle of arguments to pass 133b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to that fragment when it is instantiated during the initial creation 134b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * of PreferenceActivity. 135b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 136b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":android:show_fragment_args"; 137b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 138b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 139b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * boolean that the header list should not be displayed. This is most often 141b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * used in conjunction with {@link #EXTRA_SHOW_FRAGMENT} to launch 142b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * the activity to display a specific fragment that the user has navigated 143b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to. 144b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 145b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_NO_HEADERS = ":android:no_headers"; 146b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 147b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn private static final String BACK_STACK_PREFS = ":android:prefs"; 148b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 14919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // extras that allow any preference activity to be launched as part of a wizard 15019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // show Back and Next buttons? takes boolean parameter 15219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // Back will then return RESULT_CANCELED and Next RESULT_OK 15319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SHOW_BUTTON_BAR = "extra_prefs_show_button_bar"; 15419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng // add a Skip button? 15609dbf1844016682ed461d080e32a43d0086e767dFreeman Ng private static final String EXTRA_PREFS_SHOW_SKIP = "extra_prefs_show_skip"; 15709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng 15819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // specify custom text for the Back or Next buttons, or cause a button to not appear 15919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // at all by setting it to null 16019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_NEXT_TEXT = "extra_prefs_set_next_text"; 16119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_BACK_TEXT = "extra_prefs_set_back_text"; 16219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 163b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for new mode when showing a list of headers + prefs fragment 164b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 165b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private final ArrayList<Header> mHeaders = new ArrayList<Header>(); 166b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 167b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private HeaderAdapter mAdapter; 168b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1695c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn private FrameLayout mListFooter; 1705c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 171b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private View mPrefsContainer; 172b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 173c6669ca63299219d815464129dac051ab2404286Dianne Hackborn private FragmentBreadCrumbs mFragmentBreadCrumbs; 174c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 175b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private boolean mSinglePane; 176b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 177a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private Header mCurHeader; 178a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 179b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for old mode when showing a single preference list 18019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreferenceManager mPreferenceManager; 18219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 183e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell private Bundle mSavedInstanceState; 184e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 185b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- Common state 186b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 187b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private Button mNextButton; 188b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The starting request code given out to preference framework. 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int FIRST_REQUEST_CODE = 100; 19319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1943e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BIND_PREFERENCES = 1; 1953e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BUILD_HEADERS = 2; 1969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Handler mHandler = new Handler() { 1979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 200a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BIND_PREFERENCES: { 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindPreferences(); 202a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 203a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BUILD_HEADERS: { 204a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> oldHeaders = new ArrayList<Header>(mHeaders); 205a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.clear(); 206b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn onBuildHeaders(mHeaders); 20783681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler if (mAdapter != null) { 20883681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler mAdapter.notifyDataSetChanged(); 20983681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler } 2105c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn Header header = onGetNewHeader(); 2115c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header != null && header.fragment != null) { 212a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(header, oldHeaders); 213a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader == null || mCurHeader != mappedHeader) { 214a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 215a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 216a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mCurHeader != null) { 217a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(mCurHeader, mHeaders); 218a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader != null) { 219a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mappedHeader); 220a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 2215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 222a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 227468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderAdapter extends ArrayAdapter<Header> { 228468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderViewHolder { 229468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler ImageView icon; 230468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView title; 231468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView summary; 232468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 233b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 234b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private LayoutInflater mInflater; 235b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 236b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public HeaderAdapter(Context context, List<Header> objects) { 237b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super(context, 0, objects); 238b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 239b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 240b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 241b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 242b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public View getView(int position, View convertView, ViewGroup parent) { 243b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn HeaderViewHolder holder; 244b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn View view; 245b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 246b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (convertView == null) { 247d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn view = mInflater.inflate(com.android.internal.R.layout.preference_header_item, 248b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parent, false); 249b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn holder = new HeaderViewHolder(); 250468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon); 251468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title = (TextView) view.findViewById(com.android.internal.R.id.title); 252468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary); 253b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view.setTag(holder); 254b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 255b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view = convertView; 256468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder = (HeaderViewHolder) view.getTag(); 257b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 258b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 259468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler // All view fields must be updated every time, because the view may be recycled 260b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = getItem(position); 261a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn holder.icon.setImageResource(header.iconRes); 262468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title.setText(header.title); 263468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler if (TextUtils.isEmpty(header.summary)) { 264468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.GONE); 265468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } else { 266468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.VISIBLE); 267468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setText(header.summary); 268468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 269b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 270b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return view; 271b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 272b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 275a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Default value for {@link Header#id Header.id} indicating that no 276a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * identifier value is set. All other values (including those below -1) 277a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * are valid. 278a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 279a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final long HEADER_ID_UNDEFINED = -1; 280a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 281a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 282b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Description of a single Header item that the user can select. 283b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 284a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final class Header implements Parcelable { 285a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 286a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Identifier for this header, to correlate with a new list when 287a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * it is updated. The default value is 288a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * {@link PreferenceActivity#HEADER_ID_UNDEFINED}, meaning no id. 289a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_id 290a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 291a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public long id = HEADER_ID_UNDEFINED; 292a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 293b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 294b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Title of the header that is shown to the user. 295b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 296b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 297468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence title; 298b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 299b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 300b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional summary describing what this header controls. 301b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 302b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 303468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence summary; 304b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 305b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 306c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the title in the bread crumb. 307c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 308c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 309c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbTitle; 310c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 311c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 312c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the short title in the bread crumb. 313c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 314c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 315c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbShortTitle; 316c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 317c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 318b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional icon resource to show for this header. 319b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_icon 320b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 321468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public int iconRes; 322b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 323b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 324b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Full class name of the fragment to display when this header is 325b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * selected. 326b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_fragment 327b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 328468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public String fragment; 329b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 330b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 331b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Optional arguments to supply to the fragment when it is 332b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * instantiated. 333b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 334468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public Bundle fragmentArguments; 3355c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 3365c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 3375c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Intent to launch when the preference is selected. 3385c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 3395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Intent intent; 340a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 341a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 342a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Optional additional data for use by subclasses of PreferenceActivity. 343a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 344a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Bundle extras; 345a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 346a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header() { 347a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 348a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 349a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 350a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public int describeContents() { 351a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return 0; 352a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 353a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 354a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 355a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 356a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeLong(id); 357a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(title, dest, flags); 358a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(summary, dest, flags); 359c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbTitle, dest, flags); 360c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbShortTitle, dest, flags); 361a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(iconRes); 362a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeString(fragment); 363a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(fragmentArguments); 364a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (intent != null) { 365a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(1); 366a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent.writeToParcel(dest, flags); 367a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 368a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(0); 369a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 370a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(extras); 371a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 372a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 373a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void readFromParcel(Parcel in) { 374a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn id = in.readLong(); 375a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn title = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 376a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn summary = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 377c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 378c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbShortTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 379a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn iconRes = in.readInt(); 380a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragment = in.readString(); 381a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragmentArguments = in.readBundle(); 382a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (in.readInt() != 0) { 383a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent = Intent.CREATOR.createFromParcel(in); 384a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 385a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn extras = in.readBundle(); 386a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 387a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 388a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header(Parcel in) { 389a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn readFromParcel(in); 390a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 391a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 392a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final Creator<Header> CREATOR = new Creator<Header>() { 393a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header createFromParcel(Parcel source) { 394a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header(source); 395a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 396a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header[] newArray(int size) { 397a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header[size]; 398a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 399a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn }; 400b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 401b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onCreate(Bundle savedInstanceState) { 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setContentView(com.android.internal.R.layout.preference_list_content); 40719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 4085c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter = (FrameLayout)findViewById(com.android.internal.R.id.list_footer); 409b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPrefsContainer = findViewById(com.android.internal.R.id.prefs); 410b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn boolean hidingHeaders = onIsHidingHeaders(); 411b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSinglePane = hidingHeaders || !onIsMultiPane(); 412b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn String initialFragment = getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT); 413b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn Bundle initialArguments = getIntent().getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS); 414b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 415a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (savedInstanceState != null) { 416a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We are restarting from a previous saved state; used that to 417a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // initialize, instead of starting fresh. 418a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> headers = savedInstanceState.getParcelableArrayList(HEADERS_TAG); 419a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (headers != null) { 420a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.addAll(headers); 421a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int curHeader = savedInstanceState.getInt(CUR_HEADER_TAG, 422a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 423a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (curHeader >= 0 && curHeader < mHeaders.size()) { 424a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mHeaders.get(curHeader)); 425a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 426a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 427b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 428b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 429a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 430a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If we are just showing a fragment, we want to run in 431a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // new fragment mode, but don't need to compute and show 432a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the headers. 433a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 434a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 435a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 436a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We need to try to build the headers. 437a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn onBuildHeaders(mHeaders); 438a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 439a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If there are headers, then at this point we need to show 440a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // them and, depending on the screen, we may also show in-line 441a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the currently selected preference fragment. 442a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 443a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 444a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment == null) { 445a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header h = onGetInitialHeader(); 446a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(h); 447a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 448a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 449a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 450b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 451b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 452a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 453a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 454b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 455a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // The default configuration is to only show the list view. Adjust 456a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // visibility for other configurations. 457a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 458a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Single pane, showing just a prefs fragment. 45905fbc31ed9c6ac13a7aeddc176f19a5c17217e30Amith Yamasani findViewById(com.android.internal.R.id.headers).setVisibility(View.GONE); 460a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 461a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mHeaders.size() > 0) { 462a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mAdapter = new HeaderAdapter(this, mHeaders); 463a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setListAdapter(mAdapter); 464a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 465a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Multi-pane. 466a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setChoiceMode(AbsListView.CHOICE_MODE_SINGLE); 467d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn if (mCurHeader != null) { 468d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn setSelectedHeader(mCurHeader); 469d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn } 470a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 471a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 472a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 473b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // If there are no headers, we are in the old "just show a screen 474b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // of preferences" mode. 4758da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani setContentView(com.android.internal.R.layout.preference_list_content_single); 4768da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mListFooter = (FrameLayout) findViewById(com.android.internal.R.id.list_footer); 4778da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mPrefsContainer = findViewById(com.android.internal.R.id.prefs); 478a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager = new PreferenceManager(this, FIRST_REQUEST_CODE); 479a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager.setOnPreferenceTreeClickListener(this); 480b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 481b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 482b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn getListView().setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY); 483b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 48419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // see if we should show Back/Next buttons 48519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Intent intent = getIntent(); 48619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_BUTTON_BAR, false)) { 48719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 48819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng findViewById(com.android.internal.R.id.button_bar).setVisibility(View.VISIBLE); 48919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 49019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Button backButton = (Button)findViewById(com.android.internal.R.id.back_button); 49119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setOnClickListener(new OnClickListener() { 49219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 49319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_CANCELED); 49419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 49519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 49619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 49709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng Button skipButton = (Button)findViewById(com.android.internal.R.id.skip_button); 49809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setOnClickListener(new OnClickListener() { 49909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng public void onClick(View v) { 50009dbf1844016682ed461d080e32a43d0086e767dFreeman Ng setResult(RESULT_OK); 50109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng finish(); 50209dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 50309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng }); 50419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton = (Button)findViewById(com.android.internal.R.id.next_button); 50519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setOnClickListener(new OnClickListener() { 50619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 50719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_OK); 50819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 50919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 51019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 51119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 51219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // set our various button parameters 51319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_NEXT_TEXT)) { 51419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_NEXT_TEXT); 51519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 51619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setVisibility(View.GONE); 51719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 51819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 51919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setText(buttonText); 52019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 52119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 52219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_BACK_TEXT)) { 52319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_BACK_TEXT); 52419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 52519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setVisibility(View.GONE); 52619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 52719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 52819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setText(buttonText); 52919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 53019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 53109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_SKIP, false)) { 53209dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setVisibility(View.VISIBLE); 53309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 53419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 535b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 536b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 537b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 538291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is currently showing the header list. 539291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 540291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean hasHeaders() { 541291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return getListView().getVisibility() == View.VISIBLE 542291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn && mPreferenceManager == null; 543291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 544291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 545291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 546291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is showing multiple panes -- the headers 547291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * and a preference fragment. 548291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 549291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean isMultiPane() { 550291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return hasHeaders() && mPrefsContainer.getVisibility() == View.VISIBLE; 551291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 552291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 553291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 554b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called to determine if the activity should run in multi-pane mode. 555b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * The default implementation returns true if the screen is large 556b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * enough. 557b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 558b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsMultiPane() { 559b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Configuration config = getResources().getConfiguration(); 560b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 561c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_XLARGE) { 562c6669ca63299219d815464129dac051ab2404286Dianne Hackborn return true; 563c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 564c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 565c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_LARGE 566b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && config.orientation == Configuration.ORIENTATION_LANDSCAPE) { 567b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return true; 568b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 569b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return false; 570b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 571b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 572b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 573291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Called to determine whether the header list should be hidden. 574291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * The default implementation returns the 575291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * value given in {@link #EXTRA_NO_HEADERS} or false if it is not supplied. 576291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * This is set to false, for example, when the activity is being re-launched 577291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * to show a particular preference activity. 578b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 579b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsHidingHeaders() { 580b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return getIntent().getBooleanExtra(EXTRA_NO_HEADERS, false); 581b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 582b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 583b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 584b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Called to determine the initial header to be shown. The default 585b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * implementation simply returns the fragment of the first header. Note 586b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * that the returned Header object does not actually need to exist in 587b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * your header list -- whatever its fragment is will simply be used to 588b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * show for the initial UI. 589b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 590b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public Header onGetInitialHeader() { 591b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return mHeaders.get(0); 592b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 593b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 594b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 5955c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Called after the header list has been updated ({@link #onBuildHeaders} 5965c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * has been called and returned due to {@link #invalidateHeaders()}) to 5975c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * specify the header that should now be selected. The default implementation 5985c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * returns null to keep whatever header is currently selected. 5995c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 6005c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Header onGetNewHeader() { 6015c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn return null; 6025c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 6035c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 6045c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 605b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the activity needs its list of headers build. By 606b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * implementing this and adding at least one item to the list, you 607b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will cause the activity to run in its modern fragment mode. Note 608b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * that this function may not always be called; for example, if the 609b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity has been asked to display a particular fragment without 610b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the header list, there is no need to build the headers. 611b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 612b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Typical implementations will use {@link #loadHeadersFromResource} 613b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to fill in the list from a resource. 614b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 615b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which to place the headers. 616b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 617b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onBuildHeaders(List<Header> target) { 618b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 619b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 620b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 621b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Call when you need to change the headers being displayed. Will result 622b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * in onBuildHeaders() later being called to retrieve the new list. 623b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 624b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void invalidateHeaders() { 625b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn if (!mHandler.hasMessages(MSG_BUILD_HEADERS)) { 626b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn mHandler.sendEmptyMessage(MSG_BUILD_HEADERS); 627b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 628b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 629b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 630b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 631b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Parse the given XML file as a header description, adding each 632b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * parsed Header into the target list. 633b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 634b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param resid The XML resource to load and parse. 635b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which the parsed headers should be placed. 636b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 637b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void loadHeadersFromResource(int resid, List<Header> target) { 638b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlResourceParser parser = null; 639b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn try { 640b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parser = getResources().getXml(resid); 641b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn AttributeSet attrs = Xml.asAttributeSet(parser); 642b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 643b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn int type; 644b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 645b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && type != XmlPullParser.START_TAG) { 646b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 647b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 648b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn String nodeName = parser.getName(); 649def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (!"preference-headers".equals(nodeName)) { 650b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 651def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn "XML document must start with <preference-headers> tag; found" 652b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn + nodeName + " at " + parser.getPositionDescription()); 653b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 654b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 655def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn Bundle curBundle = null; 656def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn 6575c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int outerDepth = parser.getDepth(); 658b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 659b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) { 660b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 661b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn continue; 662b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 663b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 664b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn nodeName = parser.getName(); 665def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if ("header".equals(nodeName)) { 666b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = new Header(); 667b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 668b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn TypedArray sa = getResources().obtainAttributes(attrs, 669b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader); 670ed13cde1de86933f64285fa34e3a3aca80994859Amith Yamasani header.id = sa.getResourceId( 671a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn com.android.internal.R.styleable.PreferenceHeader_id, 672a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 673b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.title = sa.getText( 674b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_title); 675b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.summary = sa.getText( 676b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_summary); 677c6669ca63299219d815464129dac051ab2404286Dianne Hackborn header.breadCrumbTitle = sa.getText( 678c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle); 679c6669ca63299219d815464129dac051ab2404286Dianne Hackborn header.breadCrumbShortTitle = sa.getText( 680c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle); 681b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.iconRes = sa.getResourceId( 682b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_icon, 0); 683b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.fragment = sa.getString( 684b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_fragment); 685b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn sa.recycle(); 686b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 687def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle == null) { 688def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = new Bundle(); 689def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 6905c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 6915c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int innerDepth = parser.getDepth(); 6925c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 6935c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) { 6945c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 6955c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn continue; 6965c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 6975c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 6985c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn String innerNodeName = parser.getName(); 6995c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (innerNodeName.equals("extra")) { 7005c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn getResources().parseBundleExtra("extra", attrs, curBundle); 7015c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 7025c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 7035c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (innerNodeName.equals("intent")) { 7045c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn header.intent = Intent.parseIntent(getResources(), parser, attrs); 7055c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 7065c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 7075c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 7085c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 7095c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 7105c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 711def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle.size() > 0) { 712def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn header.fragmentArguments = curBundle; 713def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = null; 714def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 715b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 716def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn target.add(header); 717b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 718b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlUtils.skipCurrentTag(parser); 719b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 720b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 721b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 722b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (XmlPullParserException e) { 723b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 724b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (IOException e) { 725b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 726b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } finally { 727b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (parser != null) parser.close(); 728b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 72919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7325c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 7335c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Set a footer that should be shown at the bottom of the header list. 7345c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 7355c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public void setListFooter(View view) { 7365c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.removeAllViews(); 7375c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.addView(view, new FrameLayout.LayoutParams( 7385c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.MATCH_PARENT, 7395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.WRAP_CONTENT)); 7405c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 7415c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 74519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 746b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 747b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityStop(); 748b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 754b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 755b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 756b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityDestroy(); 757b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 764a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 765a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putParcelableArrayList(HEADERS_TAG, mHeaders); 766a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mCurHeader != null) { 767a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(mCurHeader); 768a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 769a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putInt(CUR_HEADER_TAG, index); 770a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 771a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 772a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 773a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 774b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 775b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 776b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 777b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = new Bundle(); 778b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.saveHierarchyState(container); 779b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn outState.putBundle(PREFERENCES_TAG, container); 780b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onRestoreInstanceState(Bundle state) { 786b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 787b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = state.getBundle(PREFERENCES_TAG); 788b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (container != null) { 789b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 790b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 791b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.restoreHierarchyState(container); 792b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSavedInstanceState = state; 793b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return; 794b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 797e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 798e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // Only call this if we didn't save the instance state for later. 799e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // If we did save it, it will be restored when we bind the adapter. 800e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(state); 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onActivityResult(int requestCode, int resultCode, Intent data) { 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onActivityResult(requestCode, resultCode, data); 80619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 807b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 808b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityResult(requestCode, resultCode, data); 809b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onContentChanged() { 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onContentChanged(); 815b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 816b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 817b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn postBindPreferences(); 818b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 819b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 820b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 821b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 822b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn protected void onListItemClick(ListView l, View v, int position, long id) { 823b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super.onListItemClick(l, v, position, id); 824b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 825b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter != null) { 826b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn onHeaderClick(mHeaders.get(position), position); 827b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 828b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 829b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 830b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 831b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the user selects an item in the header list. The default 8328eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * implementation will call either {@link #startWithFragment(String, Bundle, Fragment, int)} 833a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * or {@link #switchToHeader(Header)} as appropriate. 834b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 835b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param header The header that was selected. 836b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param position The header's position in the list. 837b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 838b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onHeaderClick(Header header, int position) { 8395c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header.fragment != null) { 8405c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (mSinglePane) { 8418eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startWithFragment(header.fragment, header.fragmentArguments, null, 0); 8425c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 843a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 8445c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8455c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (header.intent != null) { 8465c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn startActivity(header.intent); 847b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 848b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 849b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 850b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 851b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Start a new instance of this activity, showing only the given 852b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. When launched in this mode, the header list 853b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will be hidden and the given preference fragment will be instantiated 854b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and fill the entire activity. 855b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 856b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 857b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 858b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 8598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 8608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment resultTo, int resultRequestCode) { 861b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Intent intent = new Intent(Intent.ACTION_MAIN); 862b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn intent.setClass(this, getClass()); 863b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName); 864b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args); 865b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_NO_HEADERS, true); 8668eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo == null) { 8678eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startActivity(intent); 8688eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 8698eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultTo.startActivityForResult(intent, resultRequestCode); 8708eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 871b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 872b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 873c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 874c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Change the base title of the bread crumbs for the current preferences. 875c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * This will normally be called for you. See 876c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * {@link android.app.FragmentBreadCrumbs} for more information. 877c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 878c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public void showBreadCrumbs(CharSequence title, CharSequence shortTitle) { 879c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (mFragmentBreadCrumbs == null) { 880c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs = new FragmentBreadCrumbs(this); 881c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs.setActivity(this); 882c6669ca63299219d815464129dac051ab2404286Dianne Hackborn getActionBar().setCustomNavigationMode(mFragmentBreadCrumbs); 883c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 884c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs.setTitle(title, shortTitle); 885c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 886c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 887a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn void setSelectedHeader(Header header) { 888a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mCurHeader = header; 889a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(header); 890a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 891a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setItemChecked(index, true); 892a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 893a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().clearChoices(); 894a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 895c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (header != null) { 896c6669ca63299219d815464129dac051ab2404286Dianne Hackborn CharSequence title = header.breadCrumbTitle; 897c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = header.title; 898c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = getTitle(); 899c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(title, header.breadCrumbShortTitle); 900c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } else { 901c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(getTitle(), null); 902c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 903c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 904c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 905f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani private void switchToHeaderInner(String fragmentName, Bundle args, int direction) { 9063a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 9073a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 908c6669ca63299219d815464129dac051ab2404286Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentName, args); 9099ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase FragmentTransaction transaction = getFragmentManager().openTransaction(); 910f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani transaction.setTransition(direction == 0 ? FragmentTransaction.TRANSIT_NONE 911f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani : direction > 0 ? FragmentTransaction.TRANSIT_FRAGMENT_NEXT 912f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani : FragmentTransaction.TRANSIT_FRAGMENT_PREV); 9139ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.replace(com.android.internal.R.id.prefs, f); 9149ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.commit(); 915a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 916a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 917b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 918b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * When in two-pane mode, switch the fragment pane to show the given 919b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. 920b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 921b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 922b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 923b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 924b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void switchToHeader(String fragmentName, Bundle args) { 925a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(null); 926f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani switchToHeaderInner(fragmentName, args, 0); 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 929aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler /** 930a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * When in two-pane mode, switch to the fragment pane to show the given 931a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * preference fragment. 932a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * 933a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @param header The new header to display. 934a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 935a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void switchToHeader(Header header) { 9368eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mCurHeader == header) { 9378eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // This is the header we are currently displaying. Just make sure 9388eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // to pop the stack up to its root state. 9393a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 9403a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 9418eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 9428eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn int direction = mHeaders.indexOf(header) - mHeaders.indexOf(mCurHeader); 9438eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn switchToHeaderInner(header.fragment, header.fragmentArguments, direction); 9448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setSelectedHeader(header); 9458eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 946a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 947a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 948a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header findBestMatchingHeader(Header cur, ArrayList<Header> from) { 949a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> matches = new ArrayList<Header>(); 950a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<from.size(); j++) { 951a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = from.get(j); 952a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur == oh || (cur.id != HEADER_ID_UNDEFINED && cur.id == oh.id)) { 953a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Must be this one. 954a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.clear(); 955a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 956a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn break; 957a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 958a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment != null) { 959a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment.equals(oh.fragment)) { 960a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 961a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 962a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.intent != null) { 963a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.intent.equals(oh.intent)) { 964a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 965a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 966a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.title != null) { 967a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title.equals(oh.title)) { 968a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 969a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 970a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 971a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 972a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn final int NM = matches.size(); 973a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (NM == 1) { 974a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return matches.get(0); 975a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (NM > 1) { 976a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<NM; j++) { 977a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = matches.get(j); 978a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragmentArguments != null && 979a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn cur.fragmentArguments.equals(oh.fragmentArguments)) { 980a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 981a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 982a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.extras != null && cur.extras.equals(oh.extras)) { 983a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 984a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 985a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title != null && cur.title.equals(oh.title)) { 986a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 987a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 988a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 989a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 990a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return null; 991a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 992a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 993a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 994aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * Start a new fragment. 995aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * 996aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param fragment The fragment to start 997aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param push If true, the current fragment will be pushed onto the back stack. If false, 998aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * the current fragment will be replaced. 999aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler */ 1000aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler public void startPreferenceFragment(Fragment fragment, boolean push) { 1001aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler FragmentTransaction transaction = getFragmentManager().openTransaction(); 10028eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, fragment); 1003aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler if (push) { 10049ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 1005aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.addToBackStack(BACK_STACK_PREFS); 10069ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase } else { 10079ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_NEXT); 1008aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1009aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.commit(); 1010aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1011aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler 1012c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 10138eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Start a new fragment containing a preference panel. If the prefences 10148eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * are being displayed in multi-pane mode, the given fragment class will 10158eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * be instantiated and placed in the appropriate pane. If running in 10168eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * single-pane mode, a new activity will be launched in which to show the 10178eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 10188eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 10198eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param fragmentClass Full name of the class implementing the fragment. 10208eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param args Any desired arguments to supply to the fragment. 10218eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleRes Optional resource identifier of the title of this 10228eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 10238eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleText Optional text of the title of this fragment. 10248eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultTo Optional fragment that result data should be sent to. 10258eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * If non-null, resultTo.onActivityResult() will be called when this 10268eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * preference panel is done. The launched panel must use 10278eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * {@link #finishPreferencePanel(Fragment, int, Intent)} when done. 10288eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the caller's 10298eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * request code to be received with the resut. 1030c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 10318eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startPreferencePanel(String fragmentClass, Bundle args, int titleRes, 10328eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn CharSequence titleText, Fragment resultTo, int resultRequestCode) { 10338eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 10348eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startWithFragment(fragmentClass, args, resultTo, resultRequestCode); 10358eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 10368eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentClass, args); 10378eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo != null) { 10388eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn f.setTargetFragment(resultTo, resultRequestCode); 10398eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10408eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn FragmentTransaction transaction = getFragmentManager().openTransaction(); 10418eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, f); 10428eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (titleRes != 0) { 10438eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleRes); 10448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else if (titleText != null) { 10458eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleText); 10468eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10478eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 10488eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.addToBackStack(BACK_STACK_PREFS); 10498eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.commit(); 10508eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1051c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 10528eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 10538eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn /** 10548eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Called by a preference panel fragment to finish itself. 10558eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 10568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param caller The fragment that is asking to be finished. 10578eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultCode Optional result code to send back to the original 10588eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 10598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultData Optional result data to send back to the original 10608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 10618eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn */ 10628eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void finishPreferencePanel(Fragment caller, int resultCode, Intent resultData) { 10638eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 10648eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setResult(resultCode, resultData); 10658eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn finish(); 10668eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 10673a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn // XXX be smarter about popping the stack. 10683a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn onBackPressed(); 10698eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller != null) { 10708eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller.getTargetFragment() != null) { 10718eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn caller.getTargetFragment().onActivityResult(caller.getTargetRequestCode(), 10728eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultCode, resultData); 10738eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10748eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10758eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10768eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 10778eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 1078b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn @Override 1079b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) { 10808eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startPreferencePanel(pref.getFragment(), pref.getExtras(), 0, pref.getTitle(), null, 0); 1081b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn return true; 1082b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn } 1083b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Posts a message to bind the preferences to the list view. 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binding late is preferred as any custom preference types created in 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onCreate(Bundle)} are able to have their views recycled. 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void postBindPreferences() { 10919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler.hasMessages(MSG_BIND_PREFERENCES)) return; 10929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.obtainMessage(MSG_BIND_PREFERENCES).sendToTarget(); 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 109419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void bindPreferences() { 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final PreferenceScreen preferenceScreen = getPreferenceScreen(); 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (preferenceScreen != null) { 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project preferenceScreen.bind(getListView()); 1099e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell if (mSavedInstanceState != null) { 1100e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(mSavedInstanceState); 1101e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell mSavedInstanceState = null; 1102e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell } 11039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 110519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link PreferenceManager} used by this activity. 11089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceManager}. 1109b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1110b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1111b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 11129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1113b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 11149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceManager getPreferenceManager() { 11159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager; 11169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 111719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void requirePreferenceManager() { 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 1120b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter == null) { 1121b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("This should be called after super.onCreate."); 1122b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1123b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 1124b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn "Modern two-pane PreferenceActivity requires use of a PreferenceFragment"); 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the root of the preference hierarchy that this activity is showing. 113019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferenceScreen The root {@link PreferenceScreen} of the preference hierarchy. 1132b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1133b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1134b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1136b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreferenceScreen(PreferenceScreen preferenceScreen) { 1138b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn requirePreferenceManager(); 1139b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager.setPreferences(preferenceScreen) && preferenceScreen != null) { 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project postBindPreferences(); 11429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence title = getPreferenceScreen().getTitle(); 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set the title of the activity 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (title != null) { 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTitle(title); 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 114919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the root of the preference hierarchy that this activity is showing. 115219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceScreen} that is the root of the preference 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hierarchy. 1155b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1156b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1157b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceScreen getPreferenceScreen() { 1161b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1162b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return mPreferenceManager.getPreferenceScreen(); 1163b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1164b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return null; 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 116619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds preferences from activities that match the given {@link Intent}. 116919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 11709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The {@link Intent} to query activities. 1171b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1172b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1173b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 11749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1175b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromIntent(Intent intent) { 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 117819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromIntent(intent, getPreferenceScreen())); 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 118119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inflates the given XML resource and adds the preference hierarchy to the current 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preference hierarchy. 118519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferencesResId The XML resource ID to inflate. 1187b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1188b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1189b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1191b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromResource(int preferencesResId) { 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 119419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromResource(this, preferencesResId, 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getPreferenceScreen())); 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@inheritDoc} 1201b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1202b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1203b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1205b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 120919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Finds a {@link Preference} based on its key. 121219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key of the preference to retrieve. 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link Preference} with the key, or null. 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see PreferenceGroup#findPreference(CharSequence) 1216b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1217b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1218b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1220b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Preference findPreference(CharSequence key) { 122219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 122619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager.findPreference(key); 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onNewIntent(Intent intent) { 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager != null) { 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreferenceManager.dispatchNewIntent(intent); 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 123619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 123719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // give subclasses access to the Next button 123819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 123919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected boolean hasNextButton() { 124019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton != null; 124119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 124219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 124319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected Button getNextButton() { 124419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton; 124519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1247