PreferenceActivity.java revision 50ed8294d366412aa739e763f5e53f1e9717c7c6
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; 3250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.content.res.Resources; 33b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.TypedArray; 34b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.content.res.XmlResourceParser; 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Bundle; 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Message; 38a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcel; 39a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.os.Parcelable; 4019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.text.TextUtils; 41b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.AttributeSet; 4250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackbornimport android.util.TypedValue; 43b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.util.Xml; 44b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.view.LayoutInflater; 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.view.View; 4619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.view.View.OnClickListener; 47aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadlerimport android.view.ViewGroup; 48a21e3da55940e239addd80bf379091a1d85d006fDianne Hackbornimport android.widget.AbsListView; 49b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ArrayAdapter; 5019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ngimport android.widget.Button; 515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackbornimport android.widget.FrameLayout; 52b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ImageView; 53b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.ListView; 54b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport android.widget.TextView; 55b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 56b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.io.IOException; 57b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.ArrayList; 58b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackbornimport java.util.List; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 61b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * This is the base class for an activity to show a hierarchy of preferences 62b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to the user. Prior to {@link android.os.Build.VERSION_CODES#HONEYCOMB} 63b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * this class only allowed the display of a single set of preference; this 64b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * functionality should now be found in the new {@link PreferenceFragment} 65b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * class. If you are using PreferenceActivity in its old mode, the documentation 66b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * there applies to the deprecated APIs here. 67b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 68b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>This activity shows one or more headers of preferences, each of with 69b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * is associated with a {@link PreferenceFragment} to display the preferences 70b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of that header. The actual layout and display of these associations can 71b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * however vary; currently there are two major approaches it may take: 72b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 73b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <ul> 74b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a small screen it may display only the headers as a single list 75b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * when first launched. Selecting one of the header items will re-launch 76b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the activity with it only showing the PreferenceFragment of that header. 77b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <li>On a large screen in may display both the headers and current 78b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceFragment together as panes. Selecting a header item switches 79b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to showing the correct PreferenceFragment for that item. 80b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * </ul> 81b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 82b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Subclasses of PreferenceActivity should implement 83b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@link #onBuildHeaders} to populate the header list with the desired 84b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * items. Doing this implicitly switches the class into its new "headers 85b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * + fragments" mode rather than the old style of just showing a single 86b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preferences list. 87b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 88b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <a name="SampleCode"></a> 89b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <h3>Sample Code</h3> 90b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 91b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The following sample code shows a simple preference activity that 92b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * has two different sets of preferences. The implementation, consisting 93b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * of the activity itself as well as its two preference fragments is:</p> 94b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 95b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/preference/PreferenceWithHeaders.java 96b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity} 9719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 98b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>The preference_headers resource describes the headers to be displayed 99b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and the fragments associated with them. It is: 100b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 101b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/preference_headers.xml headers} 102b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 103b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>The first header is shown by Prefs1Fragment, which populates itself 104b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * from the following XML resource:</p> 105b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 106b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * {@sample development/samples/ApiDemos/res/xml/fragmented_preferences.xml preferences} 107b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 108b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>Note that this XML resource contains a preference screen holding another 109b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment, the Prefs1FragmentInner implemented here. This allows the user 110b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * to traverse down a hierarchy of preferences; pressing back will pop each 111b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * fragment off the stack to return to the previous preferences. 112b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * 113b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * <p>See {@link PreferenceFragment} for information on implementing the 114b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * fragments themselves. 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic abstract class PreferenceActivity extends ListActivity implements 117b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceManager.OnPreferenceTreeClickListener, 118b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn PreferenceFragment.OnPreferenceStartFragmentCallback { 119b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private static final String TAG = "PreferenceActivity"; 12019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 121a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Constants for state save/restore 122a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String HEADERS_TAG = ":android:headers"; 123a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String CUR_HEADER_TAG = ":android:cur_header"; 124a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private static final String PREFERENCES_TAG = ":android:preferences"; 12519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 126b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 127b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 128b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * string to specify which fragment should be initially displayed. 129b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 130b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT = ":android:show_fragment"; 131b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 132b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 133b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity and using {@link #EXTRA_SHOW_FRAGMENT}, 134b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * this extra can also be specify to supply a Bundle of arguments to pass 135b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to that fragment when it is instantiated during the initial creation 136b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * of PreferenceActivity. 137b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 138b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_SHOW_FRAGMENT_ARGUMENTS = ":android:show_fragment_args"; 139b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 140b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 141b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * When starting this activity, the invoking Intent can contain this extra 142b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * boolean that the header list should not be displayed. This is most often 143b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * used in conjunction with {@link #EXTRA_SHOW_FRAGMENT} to launch 144b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * the activity to display a specific fragment that the user has navigated 145b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * to. 146b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 147b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public static final String EXTRA_NO_HEADERS = ":android:no_headers"; 148b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 149b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn private static final String BACK_STACK_PREFS = ":android:prefs"; 150b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 15119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // extras that allow any preference activity to be launched as part of a wizard 15219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // show Back and Next buttons? takes boolean parameter 15419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // Back will then return RESULT_CANCELED and Next RESULT_OK 15519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SHOW_BUTTON_BAR = "extra_prefs_show_button_bar"; 15619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 15709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng // add a Skip button? 15809dbf1844016682ed461d080e32a43d0086e767dFreeman Ng private static final String EXTRA_PREFS_SHOW_SKIP = "extra_prefs_show_skip"; 15909dbf1844016682ed461d080e32a43d0086e767dFreeman Ng 16019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // specify custom text for the Back or Next buttons, or cause a button to not appear 16119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // at all by setting it to null 16219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_NEXT_TEXT = "extra_prefs_set_next_text"; 16319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng private static final String EXTRA_PREFS_SET_BACK_TEXT = "extra_prefs_set_back_text"; 16419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 165b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for new mode when showing a list of headers + prefs fragment 166b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 167b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private final ArrayList<Header> mHeaders = new ArrayList<Header>(); 168b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 169b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private HeaderAdapter mAdapter; 170b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1715c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn private FrameLayout mListFooter; 1725c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 173b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private View mPrefsContainer; 174b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 175c6669ca63299219d815464129dac051ab2404286Dianne Hackborn private FragmentBreadCrumbs mFragmentBreadCrumbs; 176c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 177b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private boolean mSinglePane; 178b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 179a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn private Header mCurHeader; 180a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 181b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- State for old mode when showing a single preference list 18219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private PreferenceManager mPreferenceManager; 18419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 185e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell private Bundle mSavedInstanceState; 186e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 187b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // --- Common state 188b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 189b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private Button mNextButton; 190b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 1919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The starting request code given out to preference framework. 1939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int FIRST_REQUEST_CODE = 100; 19519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 1963e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BIND_PREFERENCES = 1; 1973e449ce00ed2d3b271e50bc7a52798f630973bf1Dianne Hackborn private static final int MSG_BUILD_HEADERS = 2; 1989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private Handler mHandler = new Handler() { 1999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 2009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void handleMessage(Message msg) { 2019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project switch (msg.what) { 202a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BIND_PREFERENCES: { 2039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project bindPreferences(); 204a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 205a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn case MSG_BUILD_HEADERS: { 206a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> oldHeaders = new ArrayList<Header>(mHeaders); 207a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.clear(); 208b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn onBuildHeaders(mHeaders); 20983681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler if (mAdapter != null) { 21083681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler mAdapter.notifyDataSetChanged(); 21183681eb6003d69f095547d10bdd96822e30432c2Andrew Stadler } 2125c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn Header header = onGetNewHeader(); 2135c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header != null && header.fragment != null) { 214a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(header, oldHeaders); 215a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader == null || mCurHeader != mappedHeader) { 216a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 217a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 218a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mCurHeader != null) { 219a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header mappedHeader = findBestMatchingHeader(mCurHeader, mHeaders); 220a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mappedHeader != null) { 221a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mappedHeader); 222a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 2235c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 224a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } break; 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderAdapter extends ArrayAdapter<Header> { 230468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler private static class HeaderViewHolder { 231468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler ImageView icon; 232468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView title; 233468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler TextView summary; 234468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 235b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 236b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn private LayoutInflater mInflater; 237b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 238b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public HeaderAdapter(Context context, List<Header> objects) { 239b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super(context, 0, objects); 240b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mInflater = (LayoutInflater)context.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 241b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 242b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 243b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 244b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public View getView(int position, View convertView, ViewGroup parent) { 245b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn HeaderViewHolder holder; 246b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn View view; 247b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 248b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (convertView == null) { 249d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn view = mInflater.inflate(com.android.internal.R.layout.preference_header_item, 250b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parent, false); 251b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn holder = new HeaderViewHolder(); 252468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.icon = (ImageView) view.findViewById(com.android.internal.R.id.icon); 253468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.title = (TextView) view.findViewById(com.android.internal.R.id.title); 254468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary = (TextView) view.findViewById(com.android.internal.R.id.summary); 255b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view.setTag(holder); 256b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 257b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn view = convertView; 258468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder = (HeaderViewHolder) view.getTag(); 259b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 260b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 261468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler // All view fields must be updated every time, because the view may be recycled 262b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = getItem(position); 263a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn holder.icon.setImageResource(header.iconRes); 26450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.title.setText(header.getTitle(getContext().getResources())); 26550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence summary = header.getSummary(getContext().getResources()); 26650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (!TextUtils.isEmpty(summary)) { 267468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler holder.summary.setVisibility(View.VISIBLE); 26850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setText(summary); 26950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 27050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn holder.summary.setVisibility(View.GONE); 271468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler } 272b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return view; 274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 275b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 276b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 277b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 278a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Default value for {@link Header#id Header.id} indicating that no 279a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * identifier value is set. All other values (including those below -1) 280a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * are valid. 281a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 282a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final long HEADER_ID_UNDEFINED = -1; 283a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 284a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 285b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Description of a single Header item that the user can select. 286b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 287a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final class Header implements Parcelable { 288a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 289a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Identifier for this header, to correlate with a new list when 290a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * it is updated. The default value is 291a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * {@link PreferenceActivity#HEADER_ID_UNDEFINED}, meaning no id. 292a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_id 293a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 294a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public long id = HEADER_ID_UNDEFINED; 295a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 296b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 29750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of title of the header that is shown to the user. 29850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 29950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 30050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int titleRes; 30150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 30250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 303b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Title of the header that is shown to the user. 304b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_title 305b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 306468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence title; 307b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 308b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 30950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional summary describing what this header controls. 31050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 31150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 31250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int summaryRes; 31350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 31450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 315b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional summary describing what this header controls. 316b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_summary 317b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 318468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public CharSequence summary; 319b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 320b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 32150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the title in the bread crumb. 32250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 32350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 32450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbTitleRes; 32550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 32650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 327c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the title in the bread crumb. 328c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbTitle 329c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 330c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbTitle; 331c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 332c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 33350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Resource ID of optional text to show as the short title in the bread crumb. 33450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 33550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 33650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public int breadCrumbShortTitleRes; 33750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 33850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 339c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Optional text to show as the short title in the bread crumb. 340c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_breadCrumbShortTitle 341c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 342c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public CharSequence breadCrumbShortTitle; 343c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 344c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 345b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Optional icon resource to show for this header. 346b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_icon 347b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 348468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public int iconRes; 349b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 350b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 351b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Full class name of the fragment to display when this header is 352b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * selected. 353b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn * @attr ref android.R.styleable#PreferenceHeader_fragment 354b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 355468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public String fragment; 356b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 357b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 358b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Optional arguments to supply to the fragment when it is 359b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * instantiated. 360b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 361468c3230dafc2d131bdeded7b5a6825988166244Andrew Stadler public Bundle fragmentArguments; 3625c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 3635c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 3645c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Intent to launch when the preference is selected. 3655c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 3665c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Intent intent; 367a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 368a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 369a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * Optional additional data for use by subclasses of PreferenceActivity. 370a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 371a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Bundle extras; 372a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 373a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header() { 374a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 375a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 37650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 37750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set title. If {@link #titleRes} is set, 37850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 37950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #title} is returned. 38050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 38150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getTitle(Resources res) { 38250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (titleRes != 0) { 38350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(titleRes); 38450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 38550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return title; 38650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 38750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 38850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 38950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set summary. If {@link #summaryRes} is set, 39050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 39150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #summary} is returned. 39250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 39350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getSummary(Resources res) { 39450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (summaryRes != 0) { 39550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(summaryRes); 39650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 39750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return title; 39850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 39950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 40050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 40150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb title. If {@link #breadCrumbTitleRes} is set, 40250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 40350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbTitle} is returned. 40450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 40550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbTitle(Resources res) { 40650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbTitleRes != 0) { 40750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbTitleRes); 40850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 40950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbTitle; 41050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 41150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 41250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn /** 41350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * Return the currently set bread crumb short title. If 41450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitleRes} is set, 41550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * this resource is loaded from <var>res</var> and returned. Otherwise 41650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn * {@link #breadCrumbShortTitle} is returned. 41750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn */ 41850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn public CharSequence getBreadCrumbShortTitle(Resources res) { 41950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (breadCrumbShortTitleRes != 0) { 42050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return res.getText(breadCrumbShortTitleRes); 42150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 42250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn return breadCrumbShortTitle; 42350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 42450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn 425a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 426a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public int describeContents() { 427a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return 0; 428a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 429a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 430a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn @Override 431a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 432a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeLong(id); 43350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(titleRes); 434a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(title, dest, flags); 43550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(summaryRes); 436a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn TextUtils.writeToParcel(summary, dest, flags); 43750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbTitleRes); 438c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbTitle, dest, flags); 43950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn dest.writeInt(breadCrumbShortTitleRes); 440c6669ca63299219d815464129dac051ab2404286Dianne Hackborn TextUtils.writeToParcel(breadCrumbShortTitle, dest, flags); 441a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(iconRes); 442a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeString(fragment); 443a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(fragmentArguments); 444a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (intent != null) { 445a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(1); 446a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent.writeToParcel(dest, flags); 447a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 448a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeInt(0); 449a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 450a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn dest.writeBundle(extras); 451a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 452a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 453a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void readFromParcel(Parcel in) { 454a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn id = in.readLong(); 45550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn titleRes = in.readInt(); 456a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn title = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 45750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn summaryRes = in.readInt(); 458a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn summary = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 45950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbTitleRes = in.readInt(); 460c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 46150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn breadCrumbShortTitleRes = in.readInt(); 462c6669ca63299219d815464129dac051ab2404286Dianne Hackborn breadCrumbShortTitle = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(in); 463a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn iconRes = in.readInt(); 464a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragment = in.readString(); 465a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn fragmentArguments = in.readBundle(); 466a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (in.readInt() != 0) { 467a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn intent = Intent.CREATOR.createFromParcel(in); 468a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 469a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn extras = in.readBundle(); 470a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 471a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 472a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header(Parcel in) { 473a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn readFromParcel(in); 474a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 475a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 476a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public static final Creator<Header> CREATOR = new Creator<Header>() { 477a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header createFromParcel(Parcel source) { 478a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header(source); 479a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 480a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public Header[] newArray(int size) { 481a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return new Header[size]; 482a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 483a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn }; 484b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 485b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onCreate(Bundle savedInstanceState) { 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onCreate(savedInstanceState); 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setContentView(com.android.internal.R.layout.preference_list_content); 49119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 4925c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter = (FrameLayout)findViewById(com.android.internal.R.id.list_footer); 493b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPrefsContainer = findViewById(com.android.internal.R.id.prefs); 494b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn boolean hidingHeaders = onIsHidingHeaders(); 495b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSinglePane = hidingHeaders || !onIsMultiPane(); 496b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn String initialFragment = getIntent().getStringExtra(EXTRA_SHOW_FRAGMENT); 497b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn Bundle initialArguments = getIntent().getBundleExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS); 498b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 499a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (savedInstanceState != null) { 500a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We are restarting from a previous saved state; used that to 501a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // initialize, instead of starting fresh. 502a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> headers = savedInstanceState.getParcelableArrayList(HEADERS_TAG); 503a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (headers != null) { 504a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mHeaders.addAll(headers); 505a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int curHeader = savedInstanceState.getInt(CUR_HEADER_TAG, 506a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 507a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (curHeader >= 0 && curHeader < mHeaders.size()) { 508a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(mHeaders.get(curHeader)); 509a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 510a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 511b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 512b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 513a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 514a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If we are just showing a fragment, we want to run in 515a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // new fragment mode, but don't need to compute and show 516a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the headers. 517a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 518a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 519a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 520a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // We need to try to build the headers. 521a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn onBuildHeaders(mHeaders); 522a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 523a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // If there are headers, then at this point we need to show 524a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // them and, depending on the screen, we may also show in-line 525a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // the currently selected preference fragment. 526a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 527a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 528a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment == null) { 529a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header h = onGetInitialHeader(); 530a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(h); 531a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 532a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(initialFragment, initialArguments); 533a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 534b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 535b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 536a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 537a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 538b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 539a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // The default configuration is to only show the list view. Adjust 540a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // visibility for other configurations. 541a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (initialFragment != null && mSinglePane) { 542a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Single pane, showing just a prefs fragment. 54305fbc31ed9c6ac13a7aeddc176f19a5c17217e30Amith Yamasani findViewById(com.android.internal.R.id.headers).setVisibility(View.GONE); 544a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 545a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (mHeaders.size() > 0) { 546a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mAdapter = new HeaderAdapter(this, mHeaders); 547a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setListAdapter(mAdapter); 548a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (!mSinglePane) { 549a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Multi-pane. 550a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setChoiceMode(AbsListView.CHOICE_MODE_SINGLE); 551d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn if (mCurHeader != null) { 552d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn setSelectedHeader(mCurHeader); 553d0fa371f276fde32d81c037006941bc93da0bb03Dianne Hackborn } 554a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPrefsContainer.setVisibility(View.VISIBLE); 555a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 556a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 557b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // If there are no headers, we are in the old "just show a screen 558b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn // of preferences" mode. 5598da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani setContentView(com.android.internal.R.layout.preference_list_content_single); 5608da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mListFooter = (FrameLayout) findViewById(com.android.internal.R.id.list_footer); 5618da35290693d404b482104abc5f696f6cfd58a2cAmith Yamasani mPrefsContainer = findViewById(com.android.internal.R.id.prefs); 562a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager = new PreferenceManager(this, FIRST_REQUEST_CODE); 563a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mPreferenceManager.setOnPreferenceTreeClickListener(this); 564b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 565b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 566b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn getListView().setScrollBarStyle(View.SCROLLBARS_INSIDE_OVERLAY); 567b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 56819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // see if we should show Back/Next buttons 56919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Intent intent = getIntent(); 57019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_BUTTON_BAR, false)) { 57119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 57219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng findViewById(com.android.internal.R.id.button_bar).setVisibility(View.VISIBLE); 57319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 57419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng Button backButton = (Button)findViewById(com.android.internal.R.id.back_button); 57519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setOnClickListener(new OnClickListener() { 57619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 57719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_CANCELED); 57819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 57919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 58019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 58109dbf1844016682ed461d080e32a43d0086e767dFreeman Ng Button skipButton = (Button)findViewById(com.android.internal.R.id.skip_button); 58209dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setOnClickListener(new OnClickListener() { 58309dbf1844016682ed461d080e32a43d0086e767dFreeman Ng public void onClick(View v) { 58409dbf1844016682ed461d080e32a43d0086e767dFreeman Ng setResult(RESULT_OK); 58509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng finish(); 58609dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 58709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng }); 58819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton = (Button)findViewById(com.android.internal.R.id.next_button); 58919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setOnClickListener(new OnClickListener() { 59019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng public void onClick(View v) { 59119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng setResult(RESULT_OK); 59219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng finish(); 59319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 59419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng }); 59519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 59619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // set our various button parameters 59719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_NEXT_TEXT)) { 59819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_NEXT_TEXT); 59919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 60019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setVisibility(View.GONE); 60119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 60219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 60319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng mNextButton.setText(buttonText); 60419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 60519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 60619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (intent.hasExtra(EXTRA_PREFS_SET_BACK_TEXT)) { 60719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng String buttonText = intent.getStringExtra(EXTRA_PREFS_SET_BACK_TEXT); 60819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng if (TextUtils.isEmpty(buttonText)) { 60919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setVisibility(View.GONE); 61019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 61119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng else { 61219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng backButton.setText(buttonText); 61319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 61419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 61509dbf1844016682ed461d080e32a43d0086e767dFreeman Ng if (intent.getBooleanExtra(EXTRA_PREFS_SHOW_SKIP, false)) { 61609dbf1844016682ed461d080e32a43d0086e767dFreeman Ng skipButton.setVisibility(View.VISIBLE); 61709dbf1844016682ed461d080e32a43d0086e767dFreeman Ng } 61819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 619b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 620b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 621b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 622291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is currently showing the header list. 623291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 624291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean hasHeaders() { 625291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return getListView().getVisibility() == View.VISIBLE 626291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn && mPreferenceManager == null; 627291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 628291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 629291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 630291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Returns true if this activity is showing multiple panes -- the headers 631291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * and a preference fragment. 632291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn */ 633291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn public boolean isMultiPane() { 634291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn return hasHeaders() && mPrefsContainer.getVisibility() == View.VISIBLE; 635291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn } 636291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn 637291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn /** 638b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called to determine if the activity should run in multi-pane mode. 639b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * The default implementation returns true if the screen is large 640b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * enough. 641b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 642b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsMultiPane() { 643b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Configuration config = getResources().getConfiguration(); 644b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 645c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_XLARGE) { 646c6669ca63299219d815464129dac051ab2404286Dianne Hackborn return true; 647c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 648c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if ((config.screenLayout&Configuration.SCREENLAYOUT_SIZE_MASK) 649c6669ca63299219d815464129dac051ab2404286Dianne Hackborn == Configuration.SCREENLAYOUT_SIZE_LARGE 650b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && config.orientation == Configuration.ORIENTATION_LANDSCAPE) { 651b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return true; 652b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 653b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return false; 654b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 655b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 656b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 657291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * Called to determine whether the header list should be hidden. 658291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * The default implementation returns the 659291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * value given in {@link #EXTRA_NO_HEADERS} or false if it is not supplied. 660291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * This is set to false, for example, when the activity is being re-launched 661291905e34a7f0ae03c68fb2c1b8c34b92d447fbfDianne Hackborn * to show a particular preference activity. 662b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 663b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public boolean onIsHidingHeaders() { 664b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return getIntent().getBooleanExtra(EXTRA_NO_HEADERS, false); 665b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 666b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 667b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 668b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Called to determine the initial header to be shown. The default 669b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * implementation simply returns the fragment of the first header. Note 670b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * that the returned Header object does not actually need to exist in 671b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * your header list -- whatever its fragment is will simply be used to 672b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * show for the initial UI. 673b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 674b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public Header onGetInitialHeader() { 675b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn return mHeaders.get(0); 676b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 677b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 678b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 6795c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Called after the header list has been updated ({@link #onBuildHeaders} 6805c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * has been called and returned due to {@link #invalidateHeaders()}) to 6815c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * specify the header that should now be selected. The default implementation 6825c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * returns null to keep whatever header is currently selected. 6835c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 6845c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public Header onGetNewHeader() { 6855c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn return null; 6865c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 6875c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 6885c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 689b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the activity needs its list of headers build. By 690b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * implementing this and adding at least one item to the list, you 691b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will cause the activity to run in its modern fragment mode. Note 692b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * that this function may not always be called; for example, if the 693b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * activity has been asked to display a particular fragment without 694b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * the header list, there is no need to build the headers. 695b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 696b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * <p>Typical implementations will use {@link #loadHeadersFromResource} 697b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * to fill in the list from a resource. 698b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 699b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which to place the headers. 700b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 701b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onBuildHeaders(List<Header> target) { 702b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 703b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 704b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 705b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * Call when you need to change the headers being displayed. Will result 706b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * in onBuildHeaders() later being called to retrieve the new list. 707b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn */ 708b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void invalidateHeaders() { 709b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn if (!mHandler.hasMessages(MSG_BUILD_HEADERS)) { 710b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn mHandler.sendEmptyMessage(MSG_BUILD_HEADERS); 711b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 712b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn } 713b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn 714b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn /** 715b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Parse the given XML file as a header description, adding each 716b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * parsed Header into the target list. 717b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 718b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param resid The XML resource to load and parse. 719b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param target The list in which the parsed headers should be placed. 720b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 721b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void loadHeadersFromResource(int resid, List<Header> target) { 722b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlResourceParser parser = null; 723b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn try { 724b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn parser = getResources().getXml(resid); 725b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn AttributeSet attrs = Xml.asAttributeSet(parser); 726b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 727b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn int type; 728b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 729b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && type != XmlPullParser.START_TAG) { 730b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 731b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 732b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn String nodeName = parser.getName(); 733def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (!"preference-headers".equals(nodeName)) { 734b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 735def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn "XML document must start with <preference-headers> tag; found" 736b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn + nodeName + " at " + parser.getPositionDescription()); 737b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 738b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 739def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn Bundle curBundle = null; 740def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn 7415c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int outerDepth = parser.getDepth(); 742b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 743b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > outerDepth)) { 744b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 745b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn continue; 746b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 747b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 748b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn nodeName = parser.getName(); 749def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if ("header".equals(nodeName)) { 750b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Header header = new Header(); 751b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 752b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn TypedArray sa = getResources().obtainAttributes(attrs, 753b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader); 754ed13cde1de86933f64285fa34e3a3aca80994859Amith Yamasani header.id = sa.getResourceId( 755a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn com.android.internal.R.styleable.PreferenceHeader_id, 756a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn (int)HEADER_ID_UNDEFINED); 75750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn TypedValue tv = sa.peekValue( 758b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_title); 75950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 76050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 76150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.titleRes = tv.resourceId; 76250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 76350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.title = tv.string; 76450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 76550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 76650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 767b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_summary); 76850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 76950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 77050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summaryRes = tv.resourceId; 77150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 77250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.summary = tv.string; 77350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 77450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 77550ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 776c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbTitle); 77750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 77850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 77950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitleRes = tv.resourceId; 78050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 78150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbTitle = tv.string; 78250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 78350ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 78450ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn tv = sa.peekValue( 785c6669ca63299219d815464129dac051ab2404286Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_breadCrumbShortTitle); 78650ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv != null && tv.type == TypedValue.TYPE_STRING) { 78750ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (tv.resourceId != 0) { 78850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitleRes = tv.resourceId; 78950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } else { 79050ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn header.breadCrumbShortTitle = tv.string; 79150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 79250ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn } 793b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.iconRes = sa.getResourceId( 794b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_icon, 0); 795b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn header.fragment = sa.getString( 796b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn com.android.internal.R.styleable.PreferenceHeader_fragment); 797b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn sa.recycle(); 798b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 799def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle == null) { 800def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = new Bundle(); 801def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 8025c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8035c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn final int innerDepth = parser.getDepth(); 8045c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn while ((type=parser.next()) != XmlPullParser.END_DOCUMENT 8055c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn && (type != XmlPullParser.END_TAG || parser.getDepth() > innerDepth)) { 8065c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (type == XmlPullParser.END_TAG || type == XmlPullParser.TEXT) { 8075c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn continue; 8085c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8095c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8105c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn String innerNodeName = parser.getName(); 8115c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (innerNodeName.equals("extra")) { 8125c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn getResources().parseBundleExtra("extra", attrs, curBundle); 8135c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8145c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8155c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (innerNodeName.equals("intent")) { 8165c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn header.intent = Intent.parseIntent(getResources(), parser, attrs); 8175c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8185c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 8195c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn XmlUtils.skipCurrentTag(parser); 8205c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8215c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8225c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 823def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn if (curBundle.size() > 0) { 824def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn header.fragmentArguments = curBundle; 825def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn curBundle = null; 826def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn } 827b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 828def1537e9e8d0dd190cde5310ddae8b921088c9bDianne Hackborn target.add(header); 829b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } else { 830b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn XmlUtils.skipCurrentTag(parser); 831b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 832b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 833b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 834b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (XmlPullParserException e) { 835b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 836b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } catch (IOException e) { 837b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("Error parsing headers", e); 838b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } finally { 839b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (parser != null) parser.close(); 840b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 84119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8445c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn /** 8455c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn * Set a footer that should be shown at the bottom of the header list. 8465c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn */ 8475c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn public void setListFooter(View view) { 8485c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.removeAllViews(); 8495c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn mListFooter.addView(view, new FrameLayout.LayoutParams( 8505c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.MATCH_PARENT, 8515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn FrameLayout.LayoutParams.WRAP_CONTENT)); 8525c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 8535c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onStop() { 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onStop(); 85719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 858b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 859b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityStop(); 860b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onDestroy() { 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onDestroy(); 866b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 867b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 868b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityDestroy(); 869b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onSaveInstanceState(Bundle outState) { 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onSaveInstanceState(outState); 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 876a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mHeaders.size() > 0) { 877a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putParcelableArrayList(HEADERS_TAG, mHeaders); 878a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (mCurHeader != null) { 879a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(mCurHeader); 880a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 881a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn outState.putInt(CUR_HEADER_TAG, index); 882a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 883a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 884a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 885a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 886b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 887b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 888b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 889b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = new Bundle(); 890b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.saveHierarchyState(container); 891b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn outState.putBundle(PREFERENCES_TAG, container); 892b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onRestoreInstanceState(Bundle state) { 898b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 899b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Bundle container = state.getBundle(PREFERENCES_TAG); 900b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (container != null) { 901b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn final PreferenceScreen preferenceScreen = getPreferenceScreen(); 902b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (preferenceScreen != null) { 903b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn preferenceScreen.restoreHierarchyState(container); 904b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mSavedInstanceState = state; 905b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return; 906b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 909e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell 910e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // Only call this if we didn't save the instance state for later. 911e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell // If we did save it, it will be restored when we bind the adapter. 912e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(state); 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onActivityResult(int requestCode, int resultCode, Intent data) { 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onActivityResult(requestCode, resultCode, data); 91819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 919b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 920b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn mPreferenceManager.dispatchActivityResult(requestCode, resultCode, data); 921b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void onContentChanged() { 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.onContentChanged(); 927b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 928b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 929b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn postBindPreferences(); 930b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 931b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 932b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 933b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Override 934b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn protected void onListItemClick(ListView l, View v, int position, long id) { 935b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn super.onListItemClick(l, v, position, id); 936b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 937b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter != null) { 938b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn onHeaderClick(mHeaders.get(position), position); 939b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 940b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 941b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 942b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 943b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Called when the user selects an item in the header list. The default 9448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * implementation will call either {@link #startWithFragment(String, Bundle, Fragment, int)} 945a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * or {@link #switchToHeader(Header)} as appropriate. 946b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 947b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param header The header that was selected. 948b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param position The header's position in the list. 949b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 950b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn public void onHeaderClick(Header header, int position) { 9515c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (header.fragment != null) { 9525c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn if (mSinglePane) { 9538eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startWithFragment(header.fragment, header.fragmentArguments, null, 0); 9545c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else { 955a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn switchToHeader(header); 9565c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } 9575c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn } else if (header.intent != null) { 9585c769a47aeb399324cca7f5d449331a3bba85b52Dianne Hackborn startActivity(header.intent); 959b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 960b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 961b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 962b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 963b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * Start a new instance of this activity, showing only the given 964b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. When launched in this mode, the header list 965b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * will be hidden and the given preference fragment will be instantiated 966b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * and fill the entire activity. 967b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 968b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 969b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 970b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 9718eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startWithFragment(String fragmentName, Bundle args, 9728eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment resultTo, int resultRequestCode) { 973b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn Intent intent = new Intent(Intent.ACTION_MAIN); 974b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn intent.setClass(this, getClass()); 975b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT, fragmentName); 976b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_SHOW_FRAGMENT_ARGUMENTS, args); 977b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn intent.putExtra(EXTRA_NO_HEADERS, true); 9788eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo == null) { 9798eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startActivity(intent); 9808eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 9818eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultTo.startActivityForResult(intent, resultRequestCode); 9828eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 983b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 984b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 985c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 986c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * Change the base title of the bread crumbs for the current preferences. 987c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * This will normally be called for you. See 988c6669ca63299219d815464129dac051ab2404286Dianne Hackborn * {@link android.app.FragmentBreadCrumbs} for more information. 989c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 990c6669ca63299219d815464129dac051ab2404286Dianne Hackborn public void showBreadCrumbs(CharSequence title, CharSequence shortTitle) { 991c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (mFragmentBreadCrumbs == null) { 992c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs = new FragmentBreadCrumbs(this); 993c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs.setActivity(this); 994c6669ca63299219d815464129dac051ab2404286Dianne Hackborn getActionBar().setCustomNavigationMode(mFragmentBreadCrumbs); 995c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 996c6669ca63299219d815464129dac051ab2404286Dianne Hackborn mFragmentBreadCrumbs.setTitle(title, shortTitle); 997c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 998c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 999a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn void setSelectedHeader(Header header) { 1000a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn mCurHeader = header; 1001a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn int index = mHeaders.indexOf(header); 1002a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (index >= 0) { 1003a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().setItemChecked(index, true); 1004a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else { 1005a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn getListView().clearChoices(); 1006a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1007c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (header != null) { 100850ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn CharSequence title = header.getBreadCrumbTitle(getResources()); 100950ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn if (title == null) title = header.getTitle(getResources()); 1010c6669ca63299219d815464129dac051ab2404286Dianne Hackborn if (title == null) title = getTitle(); 101150ed8294d366412aa739e763f5e53f1e9717c7c6Dianne Hackborn showBreadCrumbs(title, header.getBreadCrumbShortTitle(getResources())); 1012c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } else { 1013c6669ca63299219d815464129dac051ab2404286Dianne Hackborn showBreadCrumbs(getTitle(), null); 1014c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1015c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 1016c6669ca63299219d815464129dac051ab2404286Dianne Hackborn 1017f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani private void switchToHeaderInner(String fragmentName, Bundle args, int direction) { 10183a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 10193a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 1020c6669ca63299219d815464129dac051ab2404286Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentName, args); 10219ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase FragmentTransaction transaction = getFragmentManager().openTransaction(); 1022f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani transaction.setTransition(direction == 0 ? FragmentTransaction.TRANSIT_NONE 1023f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani : direction > 0 ? FragmentTransaction.TRANSIT_FRAGMENT_NEXT 1024f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani : FragmentTransaction.TRANSIT_FRAGMENT_PREV); 10259ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.replace(com.android.internal.R.id.prefs, f); 10269ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.commit(); 1027a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1028a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1029b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn /** 1030b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * When in two-pane mode, switch the fragment pane to show the given 1031b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * preference fragment. 1032b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1033b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @param fragmentName The name of the fragment to display. 1034b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn * @param args Optional arguments to supply to the fragment. 1035b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn */ 1036b7a2e4772220c4b41df1260cedaf8912f4b07547Dianne Hackborn public void switchToHeader(String fragmentName, Bundle args) { 1037a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn setSelectedHeader(null); 1038f5cbaeda148aa80470d4100d51e3fb3975843ef2Amith Yamasani switchToHeaderInner(fragmentName, args, 0); 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1041aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler /** 1042a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * When in two-pane mode, switch to the fragment pane to show the given 1043a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * preference fragment. 1044a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * 1045a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn * @param header The new header to display. 1046a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn */ 1047a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn public void switchToHeader(Header header) { 10488eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mCurHeader == header) { 10498eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // This is the header we are currently displaying. Just make sure 10508eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn // to pop the stack up to its root state. 10513a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn getFragmentManager().popBackStack(BACK_STACK_PREFS, 10523a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn FragmentManager.POP_BACK_STACK_INCLUSIVE); 10538eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 10548eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn int direction = mHeaders.indexOf(header) - mHeaders.indexOf(mCurHeader); 10558eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn switchToHeaderInner(header.fragment, header.fragmentArguments, direction); 10568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setSelectedHeader(header); 10578eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1058a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1059a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1060a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header findBestMatchingHeader(Header cur, ArrayList<Header> from) { 1061a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn ArrayList<Header> matches = new ArrayList<Header>(); 1062a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<from.size(); j++) { 1063a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = from.get(j); 1064a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur == oh || (cur.id != HEADER_ID_UNDEFINED && cur.id == oh.id)) { 1065a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn // Must be this one. 1066a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.clear(); 1067a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1068a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn break; 1069a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1070a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment != null) { 1071a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragment.equals(oh.fragment)) { 1072a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1073a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1074a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.intent != null) { 1075a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.intent.equals(oh.intent)) { 1076a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1077a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1078a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (cur.title != null) { 1079a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title.equals(oh.title)) { 1080a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn matches.add(oh); 1081a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1082a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1083a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1084a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn final int NM = matches.size(); 1085a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (NM == 1) { 1086a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return matches.get(0); 1087a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } else if (NM > 1) { 1088a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn for (int j=0; j<NM; j++) { 1089a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn Header oh = matches.get(j); 1090a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.fragmentArguments != null && 1091a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn cur.fragmentArguments.equals(oh.fragmentArguments)) { 1092a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1093a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1094a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.extras != null && cur.extras.equals(oh.extras)) { 1095a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1096a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1097a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn if (cur.title != null && cur.title.equals(oh.title)) { 1098a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return oh; 1099a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1100a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1101a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1102a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn return null; 1103a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn } 1104a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn 1105a21e3da55940e239addd80bf379091a1d85d006fDianne Hackborn /** 1106aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * Start a new fragment. 1107aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * 1108aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param fragment The fragment to start 1109aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * @param push If true, the current fragment will be pushed onto the back stack. If false, 1110aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler * the current fragment will be replaced. 1111aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler */ 1112aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler public void startPreferenceFragment(Fragment fragment, boolean push) { 1113aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler FragmentTransaction transaction = getFragmentManager().openTransaction(); 11148eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, fragment); 1115aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler if (push) { 11169ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 1117aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.addToBackStack(BACK_STACK_PREFS); 11189ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase } else { 11199ff82bf2b33513052500473d0d6d025a80dcecbfChet Haase transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_NEXT); 1120aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1121aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler transaction.commit(); 1122aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler } 1123aa904f48cf3e3a31cc43806fee0e17af607c7faeAndrew Stadler 1124c6669ca63299219d815464129dac051ab2404286Dianne Hackborn /** 11258eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Start a new fragment containing a preference panel. If the prefences 11268eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * are being displayed in multi-pane mode, the given fragment class will 11278eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * be instantiated and placed in the appropriate pane. If running in 11288eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * single-pane mode, a new activity will be launched in which to show the 11298eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 11308eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 11318eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param fragmentClass Full name of the class implementing the fragment. 11328eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param args Any desired arguments to supply to the fragment. 11338eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleRes Optional resource identifier of the title of this 11348eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * fragment. 11358eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param titleText Optional text of the title of this fragment. 11368eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultTo Optional fragment that result data should be sent to. 11378eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * If non-null, resultTo.onActivityResult() will be called when this 11388eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * preference panel is done. The launched panel must use 11398eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * {@link #finishPreferencePanel(Fragment, int, Intent)} when done. 11408eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultRequestCode If resultTo is non-null, this is the caller's 11418eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * request code to be received with the resut. 1142c6669ca63299219d815464129dac051ab2404286Dianne Hackborn */ 11438eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void startPreferencePanel(String fragmentClass, Bundle args, int titleRes, 11448eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn CharSequence titleText, Fragment resultTo, int resultRequestCode) { 11458eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 11468eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startWithFragment(fragmentClass, args, resultTo, resultRequestCode); 11478eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 11488eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn Fragment f = Fragment.instantiate(this, fragmentClass, args); 11498eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (resultTo != null) { 11508eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn f.setTargetFragment(resultTo, resultRequestCode); 11518eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11528eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn FragmentTransaction transaction = getFragmentManager().openTransaction(); 11538eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.replace(com.android.internal.R.id.prefs, f); 11548eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (titleRes != 0) { 11558eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleRes); 11568eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else if (titleText != null) { 11578eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setBreadCrumbTitle(titleText); 11588eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11598eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.setTransition(FragmentTransaction.TRANSIT_FRAGMENT_OPEN); 11608eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.addToBackStack(BACK_STACK_PREFS); 11618eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn transaction.commit(); 11628eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 1163c6669ca63299219d815464129dac051ab2404286Dianne Hackborn } 11648eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 11658eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn /** 11668eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * Called by a preference panel fragment to finish itself. 11678eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * 11688eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param caller The fragment that is asking to be finished. 11698eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultCode Optional result code to send back to the original 11708eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 11718eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * @param resultData Optional result data to send back to the original 11728eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn * launching fragment. 11738eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn */ 11748eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn public void finishPreferencePanel(Fragment caller, int resultCode, Intent resultData) { 11758eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (mSinglePane) { 11768eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn setResult(resultCode, resultData); 11778eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn finish(); 11788eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } else { 11793a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn // XXX be smarter about popping the stack. 11803a57fb9e9c4f205ca6bd4f036b3080f92588d16dDianne Hackborn onBackPressed(); 11818eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller != null) { 11828eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn if (caller.getTargetFragment() != null) { 11838eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn caller.getTargetFragment().onActivityResult(caller.getTargetRequestCode(), 11848eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn resultCode, resultData); 11858eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11868eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11878eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11888eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn } 11898eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn 1190b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn @Override 1191b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn public boolean onPreferenceStartFragment(PreferenceFragment caller, Preference pref) { 11928eb2e244f9b14d946ee587d0b673b866865026c0Dianne Hackborn startPreferencePanel(pref.getFragment(), pref.getExtras(), 0, pref.getTitle(), null, 0); 1193b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn return true; 1194b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn } 1195b3cf10ffa8ff9cac0da8b23a0d84076b3f501400Dianne Hackborn 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Posts a message to bind the preferences to the list view. 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Binding late is preferred as any custom preference types created in 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #onCreate(Bundle)} are able to have their views recycled. 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void postBindPreferences() { 12039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHandler.hasMessages(MSG_BIND_PREFERENCES)) return; 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler.obtainMessage(MSG_BIND_PREFERENCES).sendToTarget(); 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 120619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void bindPreferences() { 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project final PreferenceScreen preferenceScreen = getPreferenceScreen(); 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (preferenceScreen != null) { 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project preferenceScreen.bind(getListView()); 1211e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell if (mSavedInstanceState != null) { 1212e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell super.onRestoreInstanceState(mSavedInstanceState); 1213e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell mSavedInstanceState = null; 1214e7fea45863afb10335cb7845aebcf2907d3c3e41Adam Powell } 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 121719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns the {@link PreferenceManager} used by this activity. 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceManager}. 1221b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1222b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1223b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1225b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceManager getPreferenceManager() { 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager; 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 122919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private void requirePreferenceManager() { 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 1232b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mAdapter == null) { 1233b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException("This should be called after super.onCreate."); 1234b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1235b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn throw new RuntimeException( 1236b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn "Modern two-pane PreferenceActivity requires use of a PreferenceFragment"); 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Sets the root of the preference hierarchy that this activity is showing. 124219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferenceScreen The root {@link PreferenceScreen} of the preference hierarchy. 1244b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1245b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1246b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1248b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setPreferenceScreen(PreferenceScreen preferenceScreen) { 1250b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn requirePreferenceManager(); 1251b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager.setPreferences(preferenceScreen) && preferenceScreen != null) { 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project postBindPreferences(); 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project CharSequence title = getPreferenceScreen().getTitle(); 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Set the title of the activity 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (title != null) { 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setTitle(title); 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 126119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the root of the preference hierarchy that this activity is showing. 126419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link PreferenceScreen} that is the root of the preference 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * hierarchy. 1267b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1268b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1269b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1271b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public PreferenceScreen getPreferenceScreen() { 1273b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn if (mPreferenceManager != null) { 1274b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return mPreferenceManager.getPreferenceScreen(); 1275b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn } 1276b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn return null; 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 127819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Adds preferences from activities that match the given {@link Intent}. 128119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param intent The {@link Intent} to query activities. 1283b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1284b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1285b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1287b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromIntent(Intent intent) { 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 129019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromIntent(intent, getPreferenceScreen())); 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 129319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Inflates the given XML resource and adds the preference hierarchy to the current 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * preference hierarchy. 129719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param preferencesResId The XML resource ID to inflate. 1299b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1300b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1301b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1303b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void addPreferencesFromResource(int preferencesResId) { 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project requirePreferenceManager(); 130619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project setPreferenceScreen(mPreferenceManager.inflateFromResource(this, preferencesResId, 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project getPreferenceScreen())); 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@inheritDoc} 1313b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1314b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1315b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1317b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean onPreferenceTreeClick(PreferenceScreen preferenceScreen, Preference preference) { 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 132119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Finds a {@link Preference} based on its key. 132419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng * 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param key The key of the preference to retrieve. 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return The {@link Preference} with the key, or null. 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see PreferenceGroup#findPreference(CharSequence) 1328b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * 1329b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * @deprecated This function is not relevant for a modern fragment-based 1330b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn * PreferenceActivity. 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1332b1ad5977bc8178b6d350ebe9099daded4c1ef603Dianne Hackborn @Deprecated 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public Preference findPreference(CharSequence key) { 133419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager == null) { 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 133819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mPreferenceManager.findPreference(key); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void onNewIntent(Intent intent) { 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mPreferenceManager != null) { 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mPreferenceManager.dispatchNewIntent(intent); 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 134819ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng 134919ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng // give subclasses access to the Next button 135019ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 135119ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected boolean hasNextButton() { 135219ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton != null; 135319ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 135419ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng /** @hide */ 135519ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng protected Button getNextButton() { 135619ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng return mNextButton; 135719ea2e0d788810473136ceca46c1c28326daff5eFreeman Ng } 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1359