Fragment.java revision 90ac236504c1a4cac7e91f1ffc523334f2a8f399
1cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn/* 2cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Copyright (C) 2011 The Android Open Source Project 3cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 4cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Licensed under the Apache License, Version 2.0 (the "License"); 5cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * you may not use this file except in compliance with the License. 6cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * You may obtain a copy of the License at 7cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 8cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * http://www.apache.org/licenses/LICENSE-2.0 9cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 10cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Unless required by applicable law or agreed to in writing, software 11cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * distributed under the License is distributed on an "AS IS" BASIS, 12cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * See the License for the specific language governing permissions and 14cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * limitations under the License. 15cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 16cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 17cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornpackage android.support.v4.app; 18cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 19cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.app.Activity; 20cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.content.ComponentCallbacks; 21cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.content.Context; 22cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.content.Intent; 23fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarriimport android.content.IntentSender; 24cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.content.res.Configuration; 25cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.content.res.Resources; 26cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.os.Bundle; 27cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.os.Parcel; 28cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.os.Parcelable; 29916455675ddb34d0eb848b2355550268d82c3ce7Adam Powellimport android.support.annotation.CallSuper; 30e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslavimport android.support.annotation.NonNull; 31a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbyeimport android.support.annotation.Nullable; 32a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbyeimport android.support.annotation.StringRes; 332290993eddf5262a8df7fc9478daed52401e325aDianne Hackbornimport android.support.v4.util.SimpleArrayMap; 34cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.support.v4.util.DebugUtils; 35bf0947be2ead9b3d8e5865bcd3d3652d02a2aa5aChris Banesimport android.support.v4.view.LayoutInflaterCompat; 36cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.util.AttributeSet; 37be2c79d9a5439922030d2a3846c81c61f0e16912Dianne Hackbornimport android.util.Log; 38cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.util.SparseArray; 39cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.ContextMenu; 40cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.LayoutInflater; 41cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.Menu; 42cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.MenuInflater; 43cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.MenuItem; 44cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.View; 45cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.ViewGroup; 46cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.ContextMenu.ContextMenuInfo; 47cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.View.OnCreateContextMenuListener; 48cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.view.animation.Animation; 49cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport android.widget.AdapterView; 50cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 51cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport java.io.FileDescriptor; 52cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornimport java.io.PrintWriter; 53cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 54cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornfinal class FragmentState implements Parcelable { 55cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final String mClassName; 56cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final int mIndex; 57cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final boolean mFromLayout; 58cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final int mFragmentId; 59cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final int mContainerId; 60cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final String mTag; 61cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final boolean mRetainInstance; 62e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn final boolean mDetached; 63cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final Bundle mArguments; 64340a183c3293d98842e4a2671b500e8e80258818Todd Kennedy final boolean mHidden; 65cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 66cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Bundle mSavedFragmentState; 67cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 68cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Fragment mInstance; 69c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell 70cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public FragmentState(Fragment frag) { 71cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mClassName = frag.getClass().getName(); 72cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mIndex = frag.mIndex; 73cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mFromLayout = frag.mFromLayout; 74cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mFragmentId = frag.mFragmentId; 75cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mContainerId = frag.mContainerId; 76cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mTag = frag.mTag; 77cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mRetainInstance = frag.mRetainInstance; 78e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn mDetached = frag.mDetached; 79cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mArguments = frag.mArguments; 80340a183c3293d98842e4a2671b500e8e80258818Todd Kennedy mHidden = frag.mHidden; 81cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 82cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 83cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public FragmentState(Parcel in) { 84cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mClassName = in.readString(); 85cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mIndex = in.readInt(); 86cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mFromLayout = in.readInt() != 0; 87cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mFragmentId = in.readInt(); 88cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mContainerId = in.readInt(); 89cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mTag = in.readString(); 90cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mRetainInstance = in.readInt() != 0; 91e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn mDetached = in.readInt() != 0; 92cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mArguments = in.readBundle(); 93340a183c3293d98842e4a2671b500e8e80258818Todd Kennedy mHidden = in.readInt() != 0; 94cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mSavedFragmentState = in.readBundle(); 95cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 96d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 97c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell public Fragment instantiate(FragmentHostCallback host, Fragment parent, 98c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell FragmentManagerNonConfig childNonConfig) { 99c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell if (mInstance == null) { 100c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell final Context context = host.getContext(); 101c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell if (mArguments != null) { 102c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mArguments.setClassLoader(context.getClassLoader()); 103c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell } 104d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 105c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance = Fragment.instantiate(context, mClassName, mArguments); 106d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 107c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell if (mSavedFragmentState != null) { 108c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mSavedFragmentState.setClassLoader(context.getClassLoader()); 109c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mSavedFragmentState = mSavedFragmentState; 110c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell } 111c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.setIndex(mIndex, parent); 112c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mFromLayout = mFromLayout; 113c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mRestored = true; 114c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mFragmentId = mFragmentId; 115c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mContainerId = mContainerId; 116c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mTag = mTag; 117c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mRetainInstance = mRetainInstance; 118c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mDetached = mDetached; 119c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mHidden = mHidden; 120c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mFragmentManager = host.mFragmentManager; 121c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell 122c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell if (FragmentManagerImpl.DEBUG) Log.v(FragmentManagerImpl.TAG, 123c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell "Instantiated fragment " + mInstance); 124cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 125c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mInstance.mChildNonConfig = childNonConfig; 126cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mInstance; 127cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 128d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 12990ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 130cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public int describeContents() { 131cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return 0; 132cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 133cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 13490ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 135cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void writeToParcel(Parcel dest, int flags) { 136cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeString(mClassName); 137cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeInt(mIndex); 138cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeInt(mFromLayout ? 1 : 0); 139cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeInt(mFragmentId); 140cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeInt(mContainerId); 141cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeString(mTag); 142cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeInt(mRetainInstance ? 1 : 0); 143e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn dest.writeInt(mDetached ? 1 : 0); 144cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeBundle(mArguments); 145340a183c3293d98842e4a2671b500e8e80258818Todd Kennedy dest.writeInt(mHidden? 1 : 0); 146cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn dest.writeBundle(mSavedFragmentState); 147cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 148cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 149cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public static final Parcelable.Creator<FragmentState> CREATOR 150cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn = new Parcelable.Creator<FragmentState>() { 15190ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 152cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public FragmentState createFromParcel(Parcel in) { 153cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return new FragmentState(in); 154cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 15590ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas 15690ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 157cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public FragmentState[] newArray(int size) { 158cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return new FragmentState[size]; 159cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 160cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn }; 161cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn} 162cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 163cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn/** 164cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Static library support version of the framework's {@link android.app.Fragment}. 165cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Used to write apps that run on platforms prior to Android 3.0. When running 166cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * on Android 3.0 or above, this implementation is still used; it does not try 1679dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * to switch to the framework's implementation. See the framework {@link android.app.Fragment} 168cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * documentation for a class overview. 1699dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * 1709dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * <p>The main differences when using this support version instead of the framework version are: 1719dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * <ul> 1729dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * <li>Your activity must extend {@link FragmentActivity} 1739dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * <li>You must call {@link FragmentActivity#getSupportFragmentManager} to get the 1749dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * {@link FragmentManager} 1759dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * </ul> 1769dcd2e58138ca4eb4b18f80b50e8979329e859d6Scott Main * 177cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 178cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackbornpublic class Fragment implements ComponentCallbacks, OnCreateContextMenuListener { 1792290993eddf5262a8df7fc9478daed52401e325aDianne Hackborn private static final SimpleArrayMap<String, Class<?>> sClassMap = 1802290993eddf5262a8df7fc9478daed52401e325aDianne Hackborn new SimpleArrayMap<String, Class<?>>(); 1819f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 1829f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount static final Object USE_DEFAULT_TRANSITION = new Object(); 1839f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 184cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn static final int INITIALIZING = 0; // Not yet created. 185cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn static final int CREATED = 1; // Created. 186cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn static final int ACTIVITY_CREATED = 2; // The activity has finished its creation. 187e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn static final int STOPPED = 3; // Fully created, not started. 188e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn static final int STARTED = 4; // Created and started, not resumed. 189e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn static final int RESUMED = 5; // Created started and resumed. 190cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 191cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mState = INITIALIZING; 192cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 193cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Non-null if the fragment's view hierarchy is currently animating away, 194cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // meaning we need to wait a bit on completely destroying it. This is the 195cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // view that is animating. 196cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn View mAnimatingAway; 197cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 198cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If mAnimatingAway != null, this is the state we should move to once the 199cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // animation is done. 200cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mStateAfterAnimating; 201cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 202cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // When instantiated from saved state, this is the saved state. 203cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Bundle mSavedFragmentState; 204cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn SparseArray<Parcelable> mSavedViewState; 205cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 206cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Index into active fragment array. 207cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mIndex = -1; 208cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 209cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Internal unique name for this fragment; 210cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn String mWho; 211cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 212cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Construction arguments; 213cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Bundle mArguments; 214cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 215cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Target fragment. 216cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Fragment mTarget; 217cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 2182c4b5dbfee5232bcbbcb74b84ce9147b62a9d789Dianne Hackborn // For use when retaining a fragment: this is the index of the last mTarget. 2192c4b5dbfee5232bcbbcb74b84ce9147b62a9d789Dianne Hackborn int mTargetIndex = -1; 2202c4b5dbfee5232bcbbcb74b84ce9147b62a9d789Dianne Hackborn 221cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Target request code. 222cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mTargetRequestCode; 223cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 224cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // True if the fragment is in the list of added fragments. 225cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mAdded; 226cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 227cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If set this fragment is being removed from its activity. 228cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mRemoving; 229cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 230cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Set to true if this fragment was instantiated from a layout file. 231cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mFromLayout; 232cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 233cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Set to true when the view has actually been inflated in its layout. 234cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mInLayout; 235cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 236cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // True if this fragment has been restored from previously saved state. 237cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mRestored; 238d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 239cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Number of active back stack entries this fragment is in. 240cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mBackStackNesting; 241d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 242cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The fragment manager we are associated with. Set as soon as the 243cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // fragment is used in a transaction; cleared after it has been removed 244cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // from all transactions. 245abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell FragmentManagerImpl mFragmentManager; 246cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 247d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy // Host this fragment is attached to. 2488491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy FragmentHostCallback mHost; 2490adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 2500adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn // Private fragment manager for child fragments inside of this one. 2510adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn FragmentManagerImpl mChildFragmentManager; 2520adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 253c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell // For use when restoring fragment state and descendant fragments are retained. 254c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell // This state is set by FragmentState.instantiate and cleared in onCreate. 255c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell FragmentManagerNonConfig mChildNonConfig; 256c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell 2570adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn // If this Fragment is contained in another Fragment, this is that container. 2580adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn Fragment mParentFragment; 2590adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 260cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The optional identifier for this fragment -- either the container ID if it 261cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // was dynamically added to the view hierarchy, or the ID supplied in 262cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // layout. 263cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mFragmentId; 264cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 265cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // When a fragment is being dynamically added to the view hierarchy, this 266cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // is the identifier of the parent container it is being added to. 267cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mContainerId; 268cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 269cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The optional named tag for this fragment -- usually used to find 270cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // fragments that are not part of the layout. 271cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn String mTag; 272cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 273cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Set to true when the app has requested that this fragment be hidden 274cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // from the user. 275cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mHidden; 276cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 277e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn // Set to true when the app has requested that this fragment be deactivated. 278e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn boolean mDetached; 279e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn 280cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If set this fragment would like its instance retained across 281cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // configuration changes. 282cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mRetainInstance; 2832bdd09a243b422960168170e2344274cc9cfd788Todd Kennedy 284cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If set this fragment is being retained across the current config change. 285cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mRetaining; 286cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 287cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If set this fragment has menu items to contribute. 288cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mHasMenu; 2892a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn 2902a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn // Set to true to allow the fragment's menu to be shown. 2912a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn boolean mMenuVisible = true; 2922a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn 293cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Used to verify that subclasses call through to super class. 294cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mCalled; 295cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 296cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // If app has requested a specific animation, this is the one to use. 297cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn int mNextAnim; 298cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 299cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The parent container of the fragment after dynamically added to UI. 300cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn ViewGroup mContainer; 301cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 302cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The View generated for this fragment. 303cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn View mView; 304cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 305cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // The real inner view that will save/restore state. 306cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn View mInnerView; 307abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell 308abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell // Whether this fragment should defer starting until after other fragments 309abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell // have been started and their loaders are finished. 310abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell boolean mDeferStart; 31179398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell 31279398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell // Hint provided by the app that this fragment is currently visible to the user. 31379398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell boolean mUserVisibleHint = true; 314abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell 315cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn LoaderManagerImpl mLoaderManager; 316cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mLoadersStarted; 317cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn boolean mCheckedForLoaderManager; 3189f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 3199f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mEnterTransition = null; 3209f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mReturnTransition = USE_DEFAULT_TRANSITION; 3219f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mExitTransition = null; 3229f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mReenterTransition = USE_DEFAULT_TRANSITION; 3239f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mSharedElementEnterTransition = null; 3249f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Object mSharedElementReturnTransition = USE_DEFAULT_TRANSITION; 3259f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Boolean mAllowReturnTransitionOverlap; 3269f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount Boolean mAllowEnterTransitionOverlap; 3279f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 3289306f07b1d66f4974a81f781d29739b30124fff0George Mount SharedElementCallback mEnterTransitionCallback = null; 3299306f07b1d66f4974a81f781d29739b30124fff0George Mount SharedElementCallback mExitTransitionCallback = null; 3309f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 331cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 3325c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * State information that has been retrieved from a fragment instance 3335c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * through {@link FragmentManager#saveFragmentInstanceState(Fragment) 3345c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * FragmentManager.saveFragmentInstanceState}. 3355c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn */ 3365c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public static class SavedState implements Parcelable { 3375c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn final Bundle mState; 3385c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3395c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn SavedState(Bundle state) { 3405c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn mState = state; 3415c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3425c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3435c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn SavedState(Parcel in, ClassLoader loader) { 3445c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn mState = in.readBundle(); 3455c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn if (loader != null && mState != null) { 3465c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn mState.setClassLoader(loader); 3475c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3485c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3495c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3505c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn @Override 3515c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public int describeContents() { 3525c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn return 0; 3535c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3545c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3555c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn @Override 3565c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void writeToParcel(Parcel dest, int flags) { 3575c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn dest.writeBundle(mState); 3585c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3595c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3605c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public static final Parcelable.Creator<SavedState> CREATOR 3615c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn = new Parcelable.Creator<SavedState>() { 362d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy @Override 3635c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public SavedState createFromParcel(Parcel in) { 3645c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn return new SavedState(in, null); 3655c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3665c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 367d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy @Override 3685c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public SavedState[] newArray(int size) { 3695c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn return new SavedState[size]; 3705c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3715c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn }; 3725c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 3735c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 3745c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn /** 375cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Thrown by {@link Fragment#instantiate(Context, String, Bundle)} when 376cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * there is an instantiation failure. 377cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 378cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn static public class InstantiationException extends RuntimeException { 379cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public InstantiationException(String msg, Exception cause) { 380cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn super(msg, cause); 381cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 382cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 383cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 384cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 385cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Default constructor. <strong>Every</strong> fragment must have an 386cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * empty constructor, so it can be instantiated when restoring its 387cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * activity's state. It is strongly recommended that subclasses do not 388cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * have other constructors with parameters, since these constructors 389cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * will not be called when the fragment is re-instantiated; instead, 390cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * arguments can be supplied by the caller with {@link #setArguments} 391cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * and later retrieved by the Fragment with {@link #getArguments}. 392cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 393cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>Applications should generally not implement a constructor. The 394cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * first place application code an run where the fragment is ready to 395cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * be used is in {@link #onAttach(Activity)}, the point where the fragment 396cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * is actually associated with its activity. Some applications may also 397cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * want to implement {@link #onInflate} to retrieve attributes from a 398cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * layout resource, though should take care here because this happens for 399cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the fragment is attached to its activity. 400cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 401cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public Fragment() { 402cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 403cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 404cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 405cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Like {@link #instantiate(Context, String, Bundle)} but with a null 406cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * argument Bundle. 407cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 408cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public static Fragment instantiate(Context context, String fname) { 409cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return instantiate(context, fname, null); 410cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 411cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 412cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 413cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Create a new instance of a Fragment with the given class name. This is 414cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the same as calling its empty constructor. 415cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 416cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param context The calling context being used to instantiate the fragment. 417cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This is currently just used to get its ClassLoader. 418cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param fname The class name of the fragment to instantiate. 419cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param args Bundle of arguments to supply to the fragment, which it 420cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * can retrieve with {@link #getArguments()}. May be null. 421cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @return Returns a new fragment instance. 422cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @throws InstantiationException If there is a failure in instantiating 423cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the given fragment class. This is a runtime exception; it is not 424cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * normally expected to happen. 425cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 426c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy public static Fragment instantiate(Context context, String fname, @Nullable Bundle args) { 427cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn try { 428cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Class<?> clazz = sClassMap.get(fname); 429cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (clazz == null) { 430cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // Class not found in the cache, see if it's real, and try to add it 431cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn clazz = context.getClassLoader().loadClass(fname); 432cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sClassMap.put(fname, clazz); 433cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 434cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn Fragment f = (Fragment)clazz.newInstance(); 435cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (args != null) { 436cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn args.setClassLoader(f.getClass().getClassLoader()); 437cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn f.mArguments = args; 438cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 439cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return f; 440cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } catch (ClassNotFoundException e) { 441cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new InstantiationException("Unable to instantiate fragment " + fname 442cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + ": make sure class name exists, is public, and has an" 443cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + " empty constructor that is public", e); 444cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } catch (java.lang.InstantiationException e) { 445cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new InstantiationException("Unable to instantiate fragment " + fname 446cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + ": make sure class name exists, is public, and has an" 447cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + " empty constructor that is public", e); 448cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } catch (IllegalAccessException e) { 449cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new InstantiationException("Unable to instantiate fragment " + fname 450cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + ": make sure class name exists, is public, and has an" 451cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn + " empty constructor that is public", e); 452cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 453cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 4543fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell 4553fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell /** 4563fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * Determine if the given fragment name is a support library fragment class. 4573fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * 4583fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * @param context Context used to determine the correct ClassLoader to use 4593fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * @param fname Class name of the fragment to test 4603fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * @return true if <code>fname</code> is <code>android.support.v4.app.Fragment</code> 4613fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell * or a subclass, false otherwise. 4623fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell */ 4633fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell static boolean isSupportFragmentClass(Context context, String fname) { 4643fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell try { 4653fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell Class<?> clazz = sClassMap.get(fname); 4663fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell if (clazz == null) { 4673fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell // Class not found in the cache, see if it's real, and try to add it 4683fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell clazz = context.getClassLoader().loadClass(fname); 4693fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell sClassMap.put(fname, clazz); 4703fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell } 4713fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell return Fragment.class.isAssignableFrom(clazz); 4723fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell } catch (ClassNotFoundException e) { 4733fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell return false; 4743fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell } 4753fafb0817f980d1819d0708b3c3da00454ba4c1fAdam Powell } 476cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 4770adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn final void restoreViewState(Bundle savedInstanceState) { 478cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mSavedViewState != null) { 479cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mInnerView.restoreHierarchyState(mSavedViewState); 480cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mSavedViewState = null; 481cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 4820adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 4830adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onViewStateRestored(savedInstanceState); 4840adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 4850adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 4860adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onViewStateRestored()"); 4870adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 488cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 4890adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 4900adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn final void setIndex(int index, Fragment parent) { 491cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mIndex = index; 4920adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (parent != null) { 4930adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mWho = parent.mWho + ":" + mIndex; 4940adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } else { 4950adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mWho = "android:fragment:" + mIndex; 4960adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 497e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn } 4980adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 499e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn final boolean isInBackStack() { 500e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn return mBackStackNesting > 0; 501e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn } 502e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn 503cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 504cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Subclasses can not override equals(). 505cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 506cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn @Override final public boolean equals(Object o) { 507cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return super.equals(o); 508cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 509cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 510cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 511cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Subclasses can not override hashCode(). 512cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 513cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn @Override final public int hashCode() { 514cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return super.hashCode(); 515cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 516cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 517cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn @Override 518cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public String toString() { 519cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn StringBuilder sb = new StringBuilder(128); 520cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn DebugUtils.buildShortClassTag(this, sb); 521cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mIndex >= 0) { 522cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(" #"); 523cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(mIndex); 524cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 525cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mFragmentId != 0) { 526cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(" id=0x"); 527cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(Integer.toHexString(mFragmentId)); 528cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 529cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mTag != null) { 530cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(" "); 531cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append(mTag); 532cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 533cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn sb.append('}'); 534cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return sb.toString(); 535cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 536cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 537cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 538cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the identifier this fragment is known by. This is either 539cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the android:id value supplied in a layout or the container view ID 540cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * supplied when adding the fragment. 541cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 542cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public int getId() { 543cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mFragmentId; 544cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 545cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 546cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 547cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Get the tag name of the fragment, if specified. 548cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 549cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public String getTag() { 550cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mTag; 551cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 552cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 553cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 554cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Supply the construction arguments for this fragment. This can only 555cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * be called before the fragment has been attached to its activity; that 556cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * is, you should call it immediately after constructing the fragment. The 557cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * arguments supplied here will be retained across fragment destroy and 558cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * creation. 559cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 560cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void setArguments(Bundle args) { 561cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mIndex >= 0) { 562cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new IllegalStateException("Fragment already active"); 563cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 564cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mArguments = args; 565cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 566cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 567cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 568cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the arguments supplied when the fragment was instantiated, 569cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * if any. 570cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 571cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public Bundle getArguments() { 572cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mArguments; 573cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 574cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 575cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 5765c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * Set the initial saved state that this Fragment should restore itself 5775c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * from when first being constructed, as returned by 5785c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * {@link FragmentManager#saveFragmentInstanceState(Fragment) 5795c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * FragmentManager.saveFragmentInstanceState}. 5805c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * 5815c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn * @param state The state the fragment should be restored from. 5825c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn */ 5835c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn public void setInitialSavedState(SavedState state) { 5845c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn if (mIndex >= 0) { 5855c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn throw new IllegalStateException("Fragment already active"); 5865c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 5875c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn mSavedFragmentState = state != null && state.mState != null 5885c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn ? state.mState : null; 5895c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn } 5905c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn 5915c1637087453de15e31861f073eae5133c4e9f7bDianne Hackborn /** 592cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Optional target for this fragment. This may be used, for example, 593cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * if this fragment is being started by another, and when done wants to 594cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * give a result back to the first. The target set here is retained 595cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * across instances via {@link FragmentManager#putFragment 596cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * FragmentManager.putFragment()}. 597cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 598cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param fragment The fragment that is the target of this one. 599cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param requestCode Optional request code, for convenience if you 600cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * are going to call back with {@link #onActivityResult(int, int, Intent)}. 601cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 602cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void setTargetFragment(Fragment fragment, int requestCode) { 603cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mTarget = fragment; 604cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mTargetRequestCode = requestCode; 605cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 606cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 607cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 608cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the target fragment set by {@link #setTargetFragment}. 609cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 610cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public Fragment getTargetFragment() { 611cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mTarget; 612cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 613cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 614cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 615cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the target request code set by {@link #setTargetFragment}. 616cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 617cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public int getTargetRequestCode() { 618cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mTargetRequestCode; 619cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 620cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 621cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 622d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * Return the {@link Context} this fragment is currently associated with. 623d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy */ 624edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy public Context getContext() { 625d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy return mHost == null ? null : mHost.getContext(); 626d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy } 627d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 628d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy /** 629d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * Return the {@link FragmentActivity} this fragment is currently associated with. 630d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * May return {@code null} if the fragment is associated with a {@link Context} 631d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * instead. 632cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 633cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public FragmentActivity getActivity() { 634d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy return mHost == null ? null : (FragmentActivity) mHost.getActivity(); 635cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 636d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 637cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 638edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy * Return the host object of this fragment. May return {@code null} if the fragment 639edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy * isn't currently being hosted. 640edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy */ 641edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy final public Object getHost() { 6428491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy return mHost == null ? null : mHost.onGetHost(); 643edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy } 644edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy 645edaa101bfa72b5e5a5b14b9e6c66579eaed5e8ccTodd Kennedy /** 646cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return <code>getActivity().getResources()</code>. 647cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 648cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public Resources getResources() { 649d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (mHost == null) { 650cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 651cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 652d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy return mHost.getContext().getResources(); 653cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 654d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 655cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 656cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return a localized, styled CharSequence from the application's package's 657cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * default string table. 658cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 659cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param resId Resource id for the CharSequence text 660cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 661a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public final CharSequence getText(@StringRes int resId) { 662cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return getResources().getText(resId); 663cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 664cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 665cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 666cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return a localized string from the application's package's 667cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * default string table. 668cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 669cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param resId Resource id for the string 670cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 671a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public final String getString(@StringRes int resId) { 672cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return getResources().getString(resId); 673cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 674cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 675cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 676cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return a localized formatted string from the application's package's 677cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * default string table, substituting the format arguments as defined in 678cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link java.util.Formatter} and {@link java.lang.String#format}. 679cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 680cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param resId Resource id for the format string 681cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param formatArgs The format arguments that will be used for substitution. 682cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 683cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 684a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public final String getString(@StringRes int resId, Object... formatArgs) { 685cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return getResources().getString(resId, formatArgs); 686cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 687cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 688cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 689cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the FragmentManager for interacting with fragments associated 690cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * with this fragment's activity. Note that this will be non-null slightly 691cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * before {@link #getActivity()}, during the time from when the fragment is 692cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * placed in a {@link FragmentTransaction} until it is committed and 693cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * attached to its activity. 6940adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * 6950adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * <p>If this Fragment is a child of another Fragment, the FragmentManager 6960adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * returned here will be the parent's {@link #getChildFragmentManager()}. 697cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 698cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public FragmentManager getFragmentManager() { 699cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mFragmentManager; 700cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 701cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 702cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 7030adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * Return a private FragmentManager for placing and managing Fragments 7040adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * inside of this Fragment. 7050adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn */ 7060adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn final public FragmentManager getChildFragmentManager() { 7070adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager == null) { 7080adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn instantiateChildFragmentManager(); 7090adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mState >= RESUMED) { 7100adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchResume(); 7110adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } else if (mState >= STARTED) { 7120adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchStart(); 7130adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } else if (mState >= ACTIVITY_CREATED) { 7140adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchActivityCreated(); 7150adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } else if (mState >= CREATED) { 7160adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchCreate(); 7170adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 7180adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 7190adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return mChildFragmentManager; 7200adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 7210adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 7220adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn /** 7230adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * Returns the parent Fragment containing this Fragment. If this Fragment 7240adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * is attached directly to an Activity, returns null. 7250adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn */ 7260adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn final public Fragment getParentFragment() { 7270adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return mParentFragment; 7280adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 7290adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 7300adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn /** 731cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if the fragment is currently added to its activity. 732cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 733cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isAdded() { 734d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy return mHost != null && mAdded; 735cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 736cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 737cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 7389c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * Return true if the fragment has been explicitly detached from the UI. 7399c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * That is, {@link FragmentTransaction#detach(Fragment) 7409c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * FragmentTransaction.detach(Fragment)} has been used on it. 7419c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn */ 7429c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn final public boolean isDetached() { 7439c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn return mDetached; 7449c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 7459c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn 7469c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn /** 747cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if this fragment is currently being removed from its 748cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * activity. This is <em>not</em> whether its activity is finishing, but 749cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * rather whether it is in the process of being removed from its activity. 750cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 751cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isRemoving() { 752cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mRemoving; 753cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 754cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 755cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 756cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if the layout is included as part of an activity view 757cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * hierarchy via the <fragment> tag. This will always be true when 758cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * fragments are created through the <fragment> tag, <em>except</em> 759cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * in the case where an old fragment is restored from a previous state and 760cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * it does not appear in the layout of the current state. 761cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 762cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isInLayout() { 763cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mInLayout; 764cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 765cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 766cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 767cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if the fragment is in the resumed state. This is true 768cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * for the duration of {@link #onResume()} and {@link #onPause()} as well. 769cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 770cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isResumed() { 77120735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell return mState >= RESUMED; 772cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 773cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 774cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 775cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if the fragment is currently visible to the user. This means 776cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * it: (1) has been added, (2) has its view attached to the window, and 777cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * (3) is not hidden. 778cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 779cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isVisible() { 780cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return isAdded() && !isHidden() && mView != null 781cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn && mView.getWindowToken() != null && mView.getVisibility() == View.VISIBLE; 782cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 783cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 784cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 785cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return true if the fragment has been hidden. By default fragments 786cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * are shown. You can find out about changes to this state with 787cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onHiddenChanged}. Note that the hidden state is orthogonal 788cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * to other states -- that is, to be visible to the user, a fragment 789cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * must be both started and not hidden. 790cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 791cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean isHidden() { 792cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mHidden; 793cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 7943a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown 7953a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown /** @hide */ 7963a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown final public boolean hasOptionsMenu() { 7973a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown return mHasMenu; 7983a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown } 7993a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown 8003a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown /** @hide */ 8013a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown final public boolean isMenuVisible() { 8023a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown return mMenuVisible; 8033a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown } 8043a1a7fff9873abbf8097c96f7654a459bf34f223Jeff Brown 805cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 806cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the hidden state (as returned by {@link #isHidden()} of 807cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the fragment has changed. Fragments start out not hidden; this will 808cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * be called whenever the fragment changes state from that. 809cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param hidden True if the fragment is now hidden, false if it is not 810cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * visible. 811cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 812cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onHiddenChanged(boolean hidden) { 813cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 814cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 815cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 816cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Control whether a fragment instance is retained across Activity 817cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * re-creation (such as from a configuration change). This can only 818cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * be used with fragments not in the back stack. If set, the fragment 819cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * lifecycle will be slightly different when an activity is recreated: 820cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <ul> 821cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <li> {@link #onDestroy()} will not be called (but {@link #onDetach()} still 822cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * will be, because the fragment is being detached from its current activity). 823cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <li> {@link #onCreate(Bundle)} will not be called since the fragment 824cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * is not being re-created. 825cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <li> {@link #onAttach(Activity)} and {@link #onActivityCreated(Bundle)} <b>will</b> 826cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * still be called. 827cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * </ul> 828cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 829cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void setRetainInstance(boolean retain) { 830cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mRetainInstance = retain; 831cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 832cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 833cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn final public boolean getRetainInstance() { 834cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mRetainInstance; 835cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 836cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 837cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 838cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Report that this fragment would like to participate in populating 839cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the options menu by receiving a call to {@link #onCreateOptionsMenu} 840cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * and related methods. 841d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * 842cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param hasMenu If true, the fragment has menu items to contribute. 843cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 844cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void setHasOptionsMenu(boolean hasMenu) { 845cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mHasMenu != hasMenu) { 846cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mHasMenu = hasMenu; 847cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (isAdded() && !isHidden()) { 8488491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy mHost.onSupportInvalidateOptionsMenu(); 849cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 850cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 851cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 8522a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn 8532a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn /** 8542a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * Set a hint for whether this fragment's menu should be visible. This 8552a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * is useful if you know that a fragment has been placed in your view 8562a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * hierarchy so that the user can not currently seen it, so any menu items 8572a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * it has should also not be shown. 8582a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * 8592a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * @param menuVisible The default is true, meaning the fragment's menu will 8602a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn * be shown as usual. If false, the user will not see the menu. 8612a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn */ 8622a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn public void setMenuVisibility(boolean menuVisible) { 8632a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (mMenuVisible != menuVisible) { 8642a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn mMenuVisible = menuVisible; 8652a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn if (mHasMenu && isAdded() && !isHidden()) { 8668491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy mHost.onSupportInvalidateOptionsMenu(); 8672a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 8682a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 8692a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn } 8702a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn 871cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 87279398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * Set a hint to the system about whether this fragment's UI is currently visible 87379398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * to the user. This hint defaults to true and is persistent across fragment instance 87479398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * state save and restore. 875abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell * 87679398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * <p>An app may set this to false to indicate that the fragment's UI is 87779398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * scrolled out of visibility or is otherwise not directly visible to the user. 87879398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * This may be used by the system to prioritize operations such as fragment lifecycle updates 87979398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * or loader ordering behavior.</p> 880abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell * 88179398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * @param isVisibleToUser true if this fragment's UI is currently visible to the user (default), 88279398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * false if it is not. 883abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell */ 88479398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell public void setUserVisibleHint(boolean isVisibleToUser) { 8853ab5a96f51cbd0498a62f1e91f1ef99e95cb1b1cAdam Powell if (!mUserVisibleHint && isVisibleToUser && mState < STARTED 8863ab5a96f51cbd0498a62f1e91f1ef99e95cb1b1cAdam Powell && mFragmentManager != null && isAdded()) { 887abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell mFragmentManager.performPendingDeferredStart(this); 888abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell } 88979398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell mUserVisibleHint = isVisibleToUser; 890c83dccecb0ec4bf9f4befdb18caccb8f373ed7bcAdam Powell mDeferStart = mState < STARTED && !isVisibleToUser; 891abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell } 892abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell 893abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell /** 89479398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * @return The current value of the user-visible hint on this fragment. 89579398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell * @see #setUserVisibleHint(boolean) 896abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell */ 89779398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell public boolean getUserVisibleHint() { 89879398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell return mUserVisibleHint; 899abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell } 900abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell 901abc968f1eba800c34a4008deb43b015da5d23a5fAdam Powell /** 902cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Return the LoaderManager for this fragment, creating it if needed. 903cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 904cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public LoaderManager getLoaderManager() { 905cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoaderManager != null) { 906cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mLoaderManager; 907cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 908d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (mHost == null) { 909cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 910cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 911cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCheckedForLoaderManager = true; 912d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mLoaderManager = mHost.getLoaderManager(mWho, mLoadersStarted, true); 913cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mLoaderManager; 914cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 915d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 916cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 9178491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy * Call {@link Activity#startActivity(Intent)} from the fragment's 918cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * containing Activity. 919cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 920cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void startActivity(Intent intent) { 9210e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick startActivity(intent, null); 9220e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick } 9230e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick 9240e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick /** 9250e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick * Call {@link Activity#startActivity(Intent, Bundle)} from the fragment's 9260e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick * containing Activity. 9270e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick */ 9280e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick public void startActivity(Intent intent, @Nullable Bundle options) { 929d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (mHost == null) { 930cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 931cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 9320e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick mHost.onStartActivityFromFragment(this /*fragment*/, intent, -1, options); 933cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 934d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 935cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 9368491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy * Call {@link Activity#startActivityForResult(Intent, int)} from the fragment's 937cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * containing Activity. 938cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 939cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void startActivityForResult(Intent intent, int requestCode) { 9400e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick startActivityForResult(intent, requestCode, null); 9410e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick } 9420e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick 9430e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick /** 9440e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick * Call {@link Activity#startActivityForResult(Intent, int, Bundle)} from the fragment's 9450e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick * containing Activity. 9460e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick */ 9470e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick public void startActivityForResult(Intent intent, int requestCode, @Nullable Bundle options) { 948d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (mHost == null) { 949cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 950cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 9510e35b9f59703416786e7ac460726c2c06a9194fcDaniel Resnick mHost.onStartActivityFromFragment(this /*fragment*/, intent, requestCode, options); 952fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri } 953fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri 954fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri /** 955fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri * Call {@link Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, 956fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri * Bundle)} from the fragment's containing Activity. 957fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri */ 958fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri public void startIntentSenderForResult(IntentSender intent, int requestCode, 959fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri @Nullable Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, 960fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri Bundle options) throws IntentSender.SendIntentException { 961fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri if (mHost == null) { 962fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 963fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri } 964fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri mHost.onStartIntentSenderFromFragment(this, intent, requestCode, fillInIntent, flagsMask, 965fed04169c31e7e3d8c7a328876358dd3564062bbClara Bayarri flagsValues, extraFlags, options); 966cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 967d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 968cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 969cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Receive the result from a previous call to 970cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #startActivityForResult(Intent, int)}. This follows the 971cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * related Activity API as described there in 972cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link Activity#onActivityResult(int, int, Intent)}. 973d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * 974cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param requestCode The integer request code originally supplied to 975cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * startActivityForResult(), allowing you to identify who this 976cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * result came from. 977cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param resultCode The integer result code returned by the child activity 978cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * through its setResult(). 979cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param data An Intent, which can return result data to the caller 980cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * (various data can be attached to Intent "extras"). 981cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 982cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onActivityResult(int requestCode, int resultCode, Intent data) { 983cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 984d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 985cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 986e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * Requests permissions to be granted to this application. These permissions 987e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * must be requested in your manifest, they should not be granted to your app, 988e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * and they should have protection level {@link android.content.pm.PermissionInfo 989e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * #PROTECTION_DANGEROUS dangerous}, regardless whether they are declared by 990e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * the platform or a third-party app. 991e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 992e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * Normal permissions {@link android.content.pm.PermissionInfo#PROTECTION_NORMAL} 993e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * are granted at install time if requested in the manifest. Signature permissions 994e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * {@link android.content.pm.PermissionInfo#PROTECTION_SIGNATURE} are granted at 995e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * install time if requested in the manifest and the signature of your app matches 996e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * the signature of the app declaring the permissions. 997e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 998e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 999e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * If your app does not have the requested permissions the user will be presented 1000e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * with UI for accepting them. After the user has accepted or rejected the 1001e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * requested permissions you will receive a callback on {@link 1002e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * #onRequestPermissionsResult(int, String[], int[])} reporting whether the 1003e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * permissions were granted or not. 1004e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1005e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 1006e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * Note that requesting a permission does not guarantee it will be granted and 1007e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * your app should be able to run without having this permission. 1008e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1009e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 1010e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * This method may start an activity allowing the user to choose which permissions 1011e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * to grant and which to reject. Hence, you should be prepared that your activity 1012e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * may be paused and resumed. Further, granting some permissions may require 1013e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * a restart of you application. In such a case, the system will recreate the 1014e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * activity stack before delivering the result to {@link 1015e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * #onRequestPermissionsResult(int, String[], int[])}. 1016e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1017e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 1018e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * When checking whether you have a permission you should use {@link 1019e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * android.content.Context#checkSelfPermission(String)}. 1020e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1021e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 10222750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * Calling this API for permissions already granted to your app would show UI 10232750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * to the user to decided whether the app can still hold these permissions. This 10242750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * can be useful if the way your app uses the data guarded by the permissions 10252750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * changes significantly. 10262750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * </p> 10272750390fbdc2e7037a7e10141d23f2068ae8c2d7Svet Ganov * <p> 1028e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * A sample permissions request looks like this: 1029e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1030e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <code><pre><p> 1031e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * private void showContacts() { 1032e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * if (getActivity().checkSelfPermission(Manifest.permission.READ_CONTACTS) 1033e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * != PackageManager.PERMISSION_GRANTED) { 1034e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * requestPermissions(new String[]{Manifest.permission.READ_CONTACTS}, 1035e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * PERMISSIONS_REQUEST_READ_CONTACTS); 1036e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * } else { 1037e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * doShowContacts(); 1038e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * } 1039e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * } 1040e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1041e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * {@literal @}Override 1042e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * public void onRequestPermissionsResult(int requestCode, String[] permissions, 1043e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * int[] grantResults) { 1044e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * if (requestCode == PERMISSIONS_REQUEST_READ_CONTACTS 1045e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * && grantResults[0] == PackageManager.PERMISSION_GRANTED) { 1046e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * doShowContacts(); 1047e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * } 1048e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * } 1049e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </code></pre></p> 1050e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1051e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param permissions The requested permissions. 1052e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param requestCode Application specific request code to match with a result 1053e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * reported to {@link #onRequestPermissionsResult(int, String[], int[])}. 1054e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1055e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see #onRequestPermissionsResult(int, String[], int[]) 1056e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see android.content.Context#checkSelfPermission(String) 1057e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav */ 1058e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav public final void requestPermissions(@NonNull String[] permissions, int requestCode) { 1059e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav if (mHost == null) { 1060e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav throw new IllegalStateException("Fragment " + this + " not attached to Activity"); 1061e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav } 10625fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian mHost.onRequestPermissionsFromFragment(this, permissions, requestCode); 1063e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav } 1064e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav 1065e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav /** 1066e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * Callback for the result from requesting permissions. This method 1067e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * is invoked for every call on {@link #requestPermissions(String[], int)}. 1068dddb7e2bbb343ecb435026c13028ba5cd1ae42a5Svet Ganov * <p> 1069dddb7e2bbb343ecb435026c13028ba5cd1ae42a5Svet Ganov * <strong>Note:</strong> It is possible that the permissions request interaction 1070dddb7e2bbb343ecb435026c13028ba5cd1ae42a5Svet Ganov * with the user is interrupted. In this case you will receive empty permissions 1071dddb7e2bbb343ecb435026c13028ba5cd1ae42a5Svet Ganov * and results arrays which should be treated as a cancellation. 1072dddb7e2bbb343ecb435026c13028ba5cd1ae42a5Svet Ganov * </p> 1073e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1074e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param requestCode The request code passed in {@link #requestPermissions(String[], int)}. 1075e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param permissions The requested permissions. Never null. 1076e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param grantResults The grant results for the corresponding permissions 1077e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * which is either {@link android.content.pm.PackageManager#PERMISSION_GRANTED} 1078e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * or {@link android.content.pm.PackageManager#PERMISSION_DENIED}. Never null. 1079e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1080e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see #requestPermissions(String[], int) 1081e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav */ 1082e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, 1083e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav @NonNull int[] grantResults) { 1084e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav /* callback - do nothing */ 1085e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav } 1086e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav 1087e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav /** 1088e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * Gets whether you should show UI with rationale for requesting a permission. 1089e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * You should do this only if you do not have the permission and the context in 1090e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * which the permission is requested does not clearly communicate to the user 1091e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * what would be the benefit from granting this permission. 1092e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * <p> 1093e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * For example, if you write a camera app, requesting the camera permission 1094e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * would be expected by the user and no rationale for why it is requested is 1095e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * needed. If however, the app needs location for tagging photos then a non-tech 1096e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * savvy user may wonder how location is related to taking photos. In this case 1097e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * you may choose to show UI with rationale of requesting this permission. 1098e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * </p> 1099e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1100e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @param permission A permission your app wants to request. 1101e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @return Whether you can show permission rationale UI. 1102e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * 1103e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see Context#checkSelfPermission(String) 1104e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see #requestPermissions(String[], int) 1105e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav * @see #onRequestPermissionsResult(int, String[], int[]) 1106e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav */ 1107e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav public boolean shouldShowRequestPermissionRationale(@NonNull String permission) { 1108e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav if (mHost != null) { 1109e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav return mHost.onShouldShowRequestPermissionRationale(permission); 1110e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav } 1111e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav return false; 1112e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav } 1113e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav 1114e1e957f536c20ebe2a7e6c417ccb2fd8f7fa845bSvetoslav /** 1115cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @hide Hack so that DialogFragment can make its Dialog before creating 1116cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * its views, and the view construction can use the dialog's context for 1117cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * inflation. Maybe this should become a public API. Note sure. 1118cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1119cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public LayoutInflater getLayoutInflater(Bundle savedInstanceState) { 11208491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy LayoutInflater result = mHost.onGetLayoutInflater(); 11210f3dfb28a503b3fb3e51666dd565b0d17eaebfbbAdam Powell getChildFragmentManager(); // Init if needed; use raw implementation below. 1122bf0947be2ead9b3d8e5865bcd3d3652d02a2aa5aChris Banes LayoutInflaterCompat.setFactory(result, mChildFragmentManager.getLayoutInflaterFactory()); 11230f3dfb28a503b3fb3e51666dd565b0d17eaebfbbAdam Powell return result; 1124cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1125d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1126cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1127cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when a fragment is being created as part of a view layout 1128cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * inflation, typically from setting the content view of an activity. This 11299277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * may be called immediately after the fragment is created from a <fragment> 1130cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * tag in a layout file. Note this is <em>before</em> the fragment's 1131cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onAttach(Activity)} has been called; all you should do here is 11329277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * parse the attributes and save them away. 1133cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1134cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>This is called every time the fragment is inflated, even if it is 11359277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * being inflated into a new instance with saved state. It typically makes 11369277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * sense to re-parse the parameters each time, to allow them to change with 11379277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * different configurations.</p> 11389277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11399277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * <p>Here is a typical implementation of a fragment that can take parameters 11409277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * both through attributes supplied here as well from {@link #getArguments()}:</p> 11419277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11429277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/app/FragmentArguments.java 11439277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * fragment} 11449277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11459277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * <p>Note that parsing the XML attributes uses a "styleable" resource. The 11469277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * declaration for the styleable used here is:</p> 11479277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11489277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * {@sample development/samples/ApiDemos/res/values/attrs.xml fragment_arguments} 1149cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 11509277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * <p>The fragment can then be declared within its activity's content layout 11519277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * through a tag like this:</p> 11529277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11539277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * {@sample development/samples/ApiDemos/res/layout/fragment_arguments.xml from_attributes} 11549277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11559277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * <p>This fragment can also be created dynamically from arguments given 11569277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * at runtime in the arguments Bundle; here is an example of doing so at 11579277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * creation of the containing activity:</p> 11589277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 11599277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * {@sample development/samples/ApiDemos/src/com/example/android/apis/app/FragmentArguments.java 11609277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * create} 11619277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn * 1162d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * @param context The Activity that is inflating this fragment. 1163cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param attrs The attributes at the tag where the fragment is 1164cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * being created. 1165cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param savedInstanceState If the fragment is being re-created from 1166cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * a previous saved state, this is the state. 1167cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1168916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1169d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy public void onInflate(Context context, AttributeSet attrs, Bundle savedInstanceState) { 1170d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mCalled = true; 1171d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy final Activity hostActivity = mHost == null ? null : mHost.getActivity(); 1172d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (hostActivity != null) { 1173d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mCalled = false; 1174d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy onInflate(hostActivity, attrs, savedInstanceState); 1175d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy } 1176d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy } 1177d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1178d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy /** 1179d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * Called when a fragment is being created as part of a view layout 1180d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * inflation, typically from setting the content view of an activity. 1181d805095048f6be52cddbd572ee343c4639ba8187Alan Viverette * 1182d805095048f6be52cddbd572ee343c4639ba8187Alan Viverette * @deprecated See {@link #onInflate(Context, AttributeSet, Bundle)}. 1183d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy */ 1184d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy @Deprecated 1185916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 11869277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn public void onInflate(Activity activity, AttributeSet attrs, Bundle savedInstanceState) { 1187cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1188cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 11899f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 1190cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1191cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * Called when a fragment is attached as a child of this fragment. 1192cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * 1193cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * <p>This is called after the attached fragment's <code>onAttach</code> and before 1194cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * the attached fragment's <code>onCreate</code> if the fragment has not yet had a previous 1195cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * call to <code>onCreate</code>.</p> 1196cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * 1197cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell * @param childFragment child fragment being attached 1198cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell */ 1199cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell public void onAttachFragment(Fragment childFragment) { 1200cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell } 1201cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell 1202cef09fee2126f901aa164f6e89c370ab81cff1b3Adam Powell /** 1203d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * Called when a fragment is first attached to its context. 1204d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy * {@link #onCreate(Bundle)} will be called after this. 1205d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy */ 1206916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1207d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy public void onAttach(Context context) { 1208d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mCalled = true; 1209d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy final Activity hostActivity = mHost == null ? null : mHost.getActivity(); 1210d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (hostActivity != null) { 1211d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mCalled = false; 1212d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy onAttach(hostActivity); 1213d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy } 1214d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy } 1215d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1216d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy /** 1217cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when a fragment is first attached to its activity. 1218cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onCreate(Bundle)} will be called after this. 1219d805095048f6be52cddbd572ee343c4639ba8187Alan Viverette * 1220d805095048f6be52cddbd572ee343c4639ba8187Alan Viverette * @deprecated See {@link #onAttach(Context)}. 1221cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1222d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy @Deprecated 1223916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1224cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onAttach(Activity activity) { 1225cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1226cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1227d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1228cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1229cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when a fragment loads an animation. 1230cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 12319277b9e4419c1f0b5236d9b573a7cc0b23d56402Dianne Hackborn public Animation onCreateAnimation(int transit, boolean enter, int nextAnim) { 1232cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return null; 1233cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1234d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1235cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1236cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called to do initial creation of a fragment. This is called after 1237cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onAttach(Activity)} and before 1238cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onCreateView(LayoutInflater, ViewGroup, Bundle)}. 1239cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1240cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>Note that this can be called while the fragment's activity is 1241cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * still in the process of being created. As such, you can not rely 1242cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * on things like the activity's content view hierarchy being initialized 1243cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * at this point. If you want to do work once the activity itself is 1244cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * created, see {@link #onActivityCreated(Bundle)}. 1245277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell * 1246277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell * <p>Any restored child fragments will be created before the base 1247277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell * <code>Fragment.onCreate</code> method returns.</p> 1248cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1249cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param savedInstanceState If the fragment is being re-created from 1250cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * a previous saved state, this is the state. 1251cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1252916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1253c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy public void onCreate(@Nullable Bundle savedInstanceState) { 1254cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 12559375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell restoreChildFragmentState(savedInstanceState); 1256fd15fbacc1d0cb92f2edf72137e4940be2547aa4Adam Powell if (mChildFragmentManager != null 1257fd15fbacc1d0cb92f2edf72137e4940be2547aa4Adam Powell && !mChildFragmentManager.isStateAtLeast(Fragment.CREATED)) { 1258fd15fbacc1d0cb92f2edf72137e4940be2547aa4Adam Powell mChildFragmentManager.dispatchCreate(); 1259fd15fbacc1d0cb92f2edf72137e4940be2547aa4Adam Powell } 12609375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell } 12619375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell 12629375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell /** 12639375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * Restore the state of the child FragmentManager. Called by either 12649375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * {@link #onCreate(Bundle)} for non-retained instance fragments or by 12659375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * {@link FragmentManagerImpl#moveToState(Fragment, int, int, int, boolean)} 12669375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * for retained instance fragments. 12679375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * 12689375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * <p><strong>Postcondition:</strong> if there were child fragments to restore, 12699375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * the child FragmentManager will be instantiated and brought to the {@link #CREATED} state. 12709375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * </p> 12719375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * 12729375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * @param savedInstanceState the savedInstanceState potentially containing fragment info 12739375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell */ 12749375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell void restoreChildFragmentState(@Nullable Bundle savedInstanceState) { 1275277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell if (savedInstanceState != null) { 1276277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell Parcelable p = savedInstanceState.getParcelable( 1277277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell FragmentActivity.FRAGMENTS_TAG); 1278277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell if (p != null) { 1279277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell if (mChildFragmentManager == null) { 1280277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell instantiateChildFragmentManager(); 1281277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell } 1282c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mChildFragmentManager.restoreAllState(p, mChildNonConfig); 1283c077b4cd990a9f220a27ad5eca04828e17136064Adam Powell mChildNonConfig = null; 1284277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell mChildFragmentManager.dispatchCreate(); 1285277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell } 1286277f9d9ad10cd8e989619ee51c888761029daa98Adam Powell } 1287cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 12880adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 1289cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1290cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called to have the fragment instantiate its user interface view. 1291cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This is optional, and non-graphical fragments can return null (which 1292cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * is the default implementation). This will be called between 1293cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onCreate(Bundle)} and {@link #onActivityCreated(Bundle)}. 1294cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1295cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>If you return a View from here, you will later be called in 1296cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onDestroyView} when the view is being released. 1297cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1298cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param inflater The LayoutInflater object that can be used to inflate 1299cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * any views in the fragment, 1300cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param container If non-null, this is the parent view that the fragment's 1301cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * UI should be attached to. The fragment should not add the view itself, 1302cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * but this can be used to generate the LayoutParams of the view. 1303cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param savedInstanceState If non-null, this fragment is being re-constructed 1304cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * from a previous saved state as given here. 1305cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1306cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @return Return the View for the fragment's UI, or null. 1307cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1308c861fd8b28b0b878ccc194ee6099b3b1bc4c3ae8Scott Kennedy @Nullable 1309a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, 1310a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye @Nullable Bundle savedInstanceState) { 1311cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return null; 1312cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 13130adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 1314cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1315e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * Called immediately after {@link #onCreateView(LayoutInflater, ViewGroup, Bundle)} 1316e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * has returned, but before any saved state has been restored in to the view. 1317e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * This gives subclasses a chance to initialize themselves once 1318e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * they know their view hierarchy has been completely created. The fragment's 1319e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * view hierarchy is not however attached to its parent at this point. 1320e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * @param view The View returned by {@link #onCreateView(LayoutInflater, ViewGroup, Bundle)}. 1321e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * @param savedInstanceState If non-null, this fragment is being re-constructed 1322e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn * from a previous saved state as given here. 1323e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn */ 1324a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public void onViewCreated(View view, @Nullable Bundle savedInstanceState) { 1325e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn } 1326e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn 1327e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn /** 1328cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Get the root view for the fragment's layout (the one returned by {@link #onCreateView}), 1329cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * if provided. 1330cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1331cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @return The fragment's root view, or null if it has no layout. 1332cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1333a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye @Nullable 1334cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public View getView() { 1335cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return mView; 1336cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1337cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1338cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1339cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the fragment's activity has been created and this 1340cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * fragment's view hierarchy instantiated. It can be used to do final 1341cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * initialization once these pieces are in place, such as retrieving 1342cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * views or restoring state. It is also useful for fragments that use 1343cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #setRetainInstance(boolean)} to retain their instance, 1344cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * as this callback tells the fragment when it is fully associated with 1345cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the new activity instance. This is called after {@link #onCreateView} 13460adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * and before {@link #onViewStateRestored(Bundle)}. 13470adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * 1348cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param savedInstanceState If the fragment is being re-created from 1349cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * a previous saved state, this is the state. 1350cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1351916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1352a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public void onActivityCreated(@Nullable Bundle savedInstanceState) { 1353cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1354cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 13550adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 13560adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn /** 13570adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * Called when all saved state has been restored into the view hierarchy 13580adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * of the fragment. This can be used to do initialization based on saved 13590adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * state that you are letting the view hierarchy track itself, such as 13600adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * whether check box widgets are currently checked. This is called 13610adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * after {@link #onActivityCreated(Bundle)} and before 13620adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * {@link #onStart()}. 13630adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * 13640adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * @param savedInstanceState If the fragment is being re-created from 13650adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn * a previous saved state, this is the state. 13660adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn */ 1367916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1368a3ff3273e976adf19770651dcf473fa67b38eb22Tor Norbye public void onViewStateRestored(@Nullable Bundle savedInstanceState) { 13690adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = true; 13700adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 13710adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 1372cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1373cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the Fragment is visible to the user. This is generally 1374cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * tied to {@link Activity#onStart() Activity.onStart} of the containing 1375cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Activity's lifecycle. 1376cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1377916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1378cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onStart() { 1379cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1380d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1381cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (!mLoadersStarted) { 1382cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoadersStarted = true; 1383cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (!mCheckedForLoaderManager) { 1384cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCheckedForLoaderManager = true; 1385d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mLoaderManager = mHost.getLoaderManager(mWho, mLoadersStarted, false); 1386cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1387cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoaderManager != null) { 1388cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoaderManager.doStart(); 1389cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1390cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1391cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1392d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy 1393cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1394cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the fragment is visible to the user and actively running. 1395cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This is generally 1396cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * tied to {@link Activity#onResume() Activity.onResume} of the containing 1397cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Activity's lifecycle. 1398cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1399916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1400cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onResume() { 1401cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1402cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1403cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1404cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1405cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called to ask the fragment to save its current dynamic state, so it 1406cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * can later be reconstructed in a new instance of its process is 1407cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * restarted. If a new instance of the fragment later needs to be 1408cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * created, the data you place in the Bundle here will be available 1409cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * in the Bundle given to {@link #onCreate(Bundle)}, 1410cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onCreateView(LayoutInflater, ViewGroup, Bundle)}, and 1411cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onActivityCreated(Bundle)}. 1412cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1413cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>This corresponds to {@link Activity#onSaveInstanceState(Bundle) 1414cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Activity.onSaveInstanceState(Bundle)} and most of the discussion there 1415cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * applies here as well. Note however: <em>this method may be called 1416cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * at any time before {@link #onDestroy()}</em>. There are many situations 1417cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * where a fragment may be mostly torn down (such as when placed on the 1418cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * back stack with no UI showing), but its state will not be saved until 1419cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * its owning activity actually needs to save its state. 1420cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1421cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param outState Bundle in which to place your saved state. 1422cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1423cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onSaveInstanceState(Bundle outState) { 1424cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 14255fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 14265fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian /** 14275fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * Called when the Fragment's activity changes from fullscreen mode to multi-window mode and 14285fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * visa-versa. This is generally tied to {@link Activity#onMultiWindowModeChanged} of the 14295fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * containing Activity. 14305fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * 14315fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * @param isInMultiWindowMode True if the activity is in multi-window mode. 14325fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian */ 14335fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian public void onMultiWindowModeChanged(boolean isInMultiWindowMode) { 14345fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 14355fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 14365fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian /** 14375fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * Called by the system when the activity changes to and from picture-in-picture mode. This is 14385fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * generally tied to {@link Activity#onPictureInPictureModeChanged} of the containing Activity. 14395fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * 14405fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian * @param isInPictureInPictureMode True if the activity is in picture-in-picture mode. 14415fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian */ 14425fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode) { 14435fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 14445fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 144590ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 1446916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1447cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onConfigurationChanged(Configuration newConfig) { 1448cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1449cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 14505fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 1451cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1452cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the Fragment is no longer resumed. This is generally 1453cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * tied to {@link Activity#onPause() Activity.onPause} of the containing 1454cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Activity's lifecycle. 1455cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1456916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1457cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onPause() { 1458cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1459cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1460cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1461cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1462cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the Fragment is no longer started. This is generally 1463cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * tied to {@link Activity#onStop() Activity.onStop} of the containing 1464cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Activity's lifecycle. 1465cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1466916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1467cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onStop() { 1468cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1469cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1470916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell 147190ac236504c1a4cac7e91f1ffc523334f2a8f399Aurimas Liutikas @Override 1472916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1473cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onLowMemory() { 1474cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1475cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1476cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1477cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1478cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the view previously created by {@link #onCreateView} has 1479cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * been detached from the fragment. The next time the fragment needs 1480cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * to be displayed, a new view will be created. This is called 1481cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * after {@link #onStop()} and before {@link #onDestroy()}. It is called 1482cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <em>regardless</em> of whether {@link #onCreateView} returned a 1483cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * non-null view. Internally it is called after the view's state has 1484cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * been saved but before it has been removed from its parent. 1485cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1486916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1487cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onDestroyView() { 1488cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1489cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1490cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1491cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1492cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the fragment is no longer in use. This is called 1493cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * after {@link #onStop()} and before {@link #onDetach()}. 1494cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1495916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1496cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onDestroy() { 1497cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1498cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn //Log.v("foo", "onDestroy: mCheckedForLoaderManager=" + mCheckedForLoaderManager 1499cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn // + " mLoaderManager=" + mLoaderManager); 1500cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (!mCheckedForLoaderManager) { 1501cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCheckedForLoaderManager = true; 1502d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mLoaderManager = mHost.getLoaderManager(mWho, mLoadersStarted, false); 1503cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1504cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoaderManager != null) { 1505cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoaderManager.doDestroy(); 1506cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1507cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1508cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1509cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 15109c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * Called by the fragment manager once this fragment has been removed, 15119c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * so that we don't have any left-over state if the application decides 15129c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * to re-use the instance. This only clears state that the framework 15139c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn * internally manages, not things the application sets. 15149c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn */ 15159c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn void initState() { 15169c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mIndex = -1; 15179c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mWho = null; 15189c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mAdded = false; 15199c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mRemoving = false; 15209c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mFromLayout = false; 15219c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mInLayout = false; 15229c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mRestored = false; 15239c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mBackStackNesting = 0; 15249c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mFragmentManager = null; 15256252d78085a07c9d6bb4645a4e8086bf23b0a49aTim Kilbourn mChildFragmentManager = null; 1526d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mHost = null; 15279c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mFragmentId = 0; 15289c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mContainerId = 0; 15299c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mTag = null; 15309c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mHidden = false; 15319c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mDetached = false; 15329c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mRetaining = false; 15339c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mLoaderManager = null; 15349c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mLoadersStarted = false; 15359c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mCheckedForLoaderManager = false; 15369c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 15379c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn 15389c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn /** 1539cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when the fragment is no longer attached to its activity. This 1540cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * is called after {@link #onDestroy()}. 1541cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1542916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell @CallSuper 1543cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onDetach() { 1544cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCalled = true; 1545cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1546cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1547cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 15489375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * Initialize the contents of the Fragment host's standard options menu. You 1549cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * should place your menu items in to <var>menu</var>. For this method 1550cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * to be called, you must have first called {@link #setHasOptionsMenu}. See 1551cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link Activity#onCreateOptionsMenu(Menu) Activity.onCreateOptionsMenu} 1552cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * for more information. 1553cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1554cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param menu The options menu in which you place your items. 1555cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1556cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #setHasOptionsMenu 1557cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #onPrepareOptionsMenu 1558cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #onOptionsItemSelected 1559cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1560cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) { 1561cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1562cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1563cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 15649375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell * Prepare the Fragment host's standard options menu to be displayed. This is 1565cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * called right before the menu is shown, every time it is shown. You can 1566cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * use this method to efficiently enable/disable items or otherwise 1567cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * dynamically modify the contents. See 1568cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link Activity#onPrepareOptionsMenu(Menu) Activity.onPrepareOptionsMenu} 1569cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * for more information. 1570cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1571cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param menu The options menu as last shown or first initialized by 1572cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * onCreateOptionsMenu(). 1573cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1574cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #setHasOptionsMenu 1575cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #onCreateOptionsMenu 1576cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1577cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onPrepareOptionsMenu(Menu menu) { 1578cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1579cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1580cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1581cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when this fragment's option menu items are no longer being 1582cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * included in the overall options menu. Receiving this call means that 1583cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the menu needed to be rebuilt, but this fragment's items were not 1584cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * included in the newly built menu (its {@link #onCreateOptionsMenu(Menu, MenuInflater)} 1585cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * was not called). 1586cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1587cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onDestroyOptionsMenu() { 1588cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1589cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1590cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1591cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This hook is called whenever an item in your options menu is selected. 1592cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * The default implementation simply returns false to have the normal 1593cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * processing happen (calling the item's Runnable or sending a message to 1594cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * its Handler as appropriate). You can use this method for any items 1595cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * for which you would like to do processing without those other 1596cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * facilities. 1597cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1598cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p>Derived classes should call through to the base class for it to 1599cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * perform the default menu handling. 1600cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1601cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param item The menu item that was selected. 1602cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1603cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @return boolean Return false to allow normal menu processing to 1604cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * proceed, true to consume it here. 1605cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1606cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #onCreateOptionsMenu 1607cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1608cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public boolean onOptionsItemSelected(MenuItem item) { 1609cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return false; 1610cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1611cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1612cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1613cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This hook is called whenever the options menu is being closed (either by the user canceling 1614cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the menu with the back/menu button, or when an item is selected). 1615cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1616cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param menu The options menu as last shown or first initialized by 1617cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * onCreateOptionsMenu(). 1618cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1619cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onOptionsMenuClosed(Menu menu) { 1620cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1621cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1622cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1623cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Called when a context menu for the {@code view} is about to be shown. 1624cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Unlike {@link #onCreateOptionsMenu}, this will be called every 1625cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * time the context menu is about to be shown and should be populated for 1626cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the view (or item inside the view for {@link AdapterView} subclasses, 1627cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * this can be found in the {@code menuInfo})). 1628cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p> 1629cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Use {@link #onContextItemSelected(android.view.MenuItem)} to know when an 1630cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * item has been selected. 1631cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p> 1632cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * The default implementation calls up to 1633cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link Activity#onCreateContextMenu Activity.onCreateContextMenu}, though 1634cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * you can not call this implementation if you don't want that behavior. 1635cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p> 1636cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * It is not safe to hold onto the context menu after this method returns. 1637cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@inheritDoc} 1638cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1639d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy @Override 1640cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void onCreateContextMenu(ContextMenu menu, View v, ContextMenuInfo menuInfo) { 1641cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn getActivity().onCreateContextMenu(menu, v, menuInfo); 1642cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1643cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1644cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1645cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Registers a context menu to be shown for the given view (multiple views 1646cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * can show the context menu). This method will set the 1647cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link OnCreateContextMenuListener} on the view to this fragment, so 1648cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * {@link #onCreateContextMenu(ContextMenu, View, ContextMenuInfo)} will be 1649cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * called when it is time to show the context menu. 1650cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1651cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #unregisterForContextMenu(View) 1652cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param view The view that should show a context menu. 1653cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1654cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void registerForContextMenu(View view) { 1655cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn view.setOnCreateContextMenuListener(this); 1656cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1657cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1658cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1659cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Prevents a context menu to be shown for the given view. This method will 1660cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * remove the {@link OnCreateContextMenuListener} on the view. 1661cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1662cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @see #registerForContextMenu(View) 1663cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param view The view that should stop showing a context menu. 1664cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1665cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void unregisterForContextMenu(View view) { 1666cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn view.setOnCreateContextMenuListener(null); 1667cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1668cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 1669cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 1670cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * This hook is called whenever an item in a context menu is selected. The 1671cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * default implementation simply returns false to have the normal processing 1672cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * happen (calling the item's Runnable or sending a message to its Handler 1673cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * as appropriate). You can use this method for any items for which you 1674cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * would like to do processing without those other facilities. 1675cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p> 1676cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Use {@link MenuItem#getMenuInfo()} to get extra information set by the 1677cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * View that added this menu item. 1678cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * <p> 1679cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Derived classes should call through to the base class for it to perform 1680cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * the default menu handling. 1681cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1682cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param item The context menu item that was selected. 1683cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @return boolean Return false to allow normal context menu processing to 1684cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * proceed, true to consume it here. 1685cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1686cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public boolean onContextItemSelected(MenuItem item) { 1687cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn return false; 1688cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1689e0f27d39b0a4f0ef30ef6446e7b675279961cc94Chris Banes 1690cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn /** 16919306f07b1d66f4974a81f781d29739b30124fff0George Mount * When custom transitions are used with Fragments, the enter transition callback 16929f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is called when this Fragment is attached or detached when not popping the back stack. 16939f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 16949306f07b1d66f4974a81f781d29739b30124fff0George Mount * @param callback Used to manipulate the shared element transitions on this Fragment 16959f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * when added not as a pop from the back stack. 16969f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 1697b1413bc4de16e05ae0455cad93f1edfbcc4eced2George Mount public void setEnterSharedElementCallback(SharedElementCallback callback) { 16989306f07b1d66f4974a81f781d29739b30124fff0George Mount mEnterTransitionCallback = callback; 16999f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17009f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17019f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17029306f07b1d66f4974a81f781d29739b30124fff0George Mount * When custom transitions are used with Fragments, the exit transition callback 17039f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is called when this Fragment is attached or detached when popping the back stack. 17049f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17059306f07b1d66f4974a81f781d29739b30124fff0George Mount * @param callback Used to manipulate the shared element transitions on this Fragment 17069f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * when added as a pop from the back stack. 17079f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 1708b1413bc4de16e05ae0455cad93f1edfbcc4eced2George Mount public void setExitSharedElementCallback(SharedElementCallback callback) { 17099306f07b1d66f4974a81f781d29739b30124fff0George Mount mExitTransitionCallback = callback; 17109f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17119f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17129f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17139f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used to move Views into the initial scene. The entering 17149f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Views will be those that are regular Views or ViewGroups that have 17159f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17169f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as entering is governed by changing visibility from 17179f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link View#INVISIBLE} to {@link View#VISIBLE}. If <code>transition</code> is null, 17189f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * entering Views will remain unaffected. 17199f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17209f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use to move Views into the initial Scene. 17219f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 17229f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setEnterTransition(Object transition) { 17239f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mEnterTransition = transition; 17249f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17259f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17269f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17279f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns the Transition that will be used to move Views into the initial scene. The entering 17289f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Views will be those that are regular Views or ViewGroups that have 17299f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17309f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as entering is governed by changing visibility from 17319f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link View#INVISIBLE} to {@link View#VISIBLE}. 17329f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17339f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return the Transition to use to move Views into the initial Scene. 17349f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 17359f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getEnterTransition() { 17369f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mEnterTransition; 17379f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17389f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17399f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17409f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used to move Views out of the scene when the Fragment is 17419f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * preparing to be removed, hidden, or detached because of popping the back stack. The exiting 17429f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Views will be those that are regular Views or ViewGroups that have 17439f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17449f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as entering is governed by changing visibility from 17459f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link View#VISIBLE} to {@link View#INVISIBLE}. If <code>transition</code> is null, 17469f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * entering Views will remain unaffected. If nothing is set, the default will be to 17479f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * use the same value as set in {@link #setEnterTransition(Object)}. 17489f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17499f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use to move Views out of the Scene when the Fragment 17509f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is preparing to close. <code>transition</code> must be an 17519f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * android.transition.Transition. 17529f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 17539f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setReturnTransition(Object transition) { 17549f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mReturnTransition = transition; 17559f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17569f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17579f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17589f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns the Transition that will be used to move Views out of the scene when the Fragment is 17599f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * preparing to be removed, hidden, or detached because of popping the back stack. The exiting 17609f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Views will be those that are regular Views or ViewGroups that have 17619f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17629f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as entering is governed by changing visibility from 17639f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link View#VISIBLE} to {@link View#INVISIBLE}. If <code>transition</code> is null, 17649f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * entering Views will remain unaffected. 17659f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17669f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return the Transition to use to move Views out of the Scene when the Fragment 17679f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is preparing to close. 17689f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 17699f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getReturnTransition() { 17709f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mReturnTransition == USE_DEFAULT_TRANSITION ? getEnterTransition() 17719f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount : mReturnTransition; 17729f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17739f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17749f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17759f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used to move Views out of the scene when the 17769f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * fragment is removed, hidden, or detached when not popping the back stack. 17779f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * The exiting Views will be those that are regular Views or ViewGroups that 17789f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * have {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17799f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as exiting is governed by changing visibility 17809f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * from {@link View#VISIBLE} to {@link View#INVISIBLE}. If transition is null, the views will 17819f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * remain unaffected. 17829f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 17839f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use to move Views out of the Scene when the Fragment 17849f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is being closed not due to popping the back stack. <code>transition</code> 17859f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * must be an android.transition.Transition. 17869f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 17879f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setExitTransition(Object transition) { 17889f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mExitTransition = transition; 17899f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 17909f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 17919f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 17929f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns the Transition that will be used to move Views out of the scene when the 17939f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * fragment is removed, hidden, or detached when not popping the back stack. 17949f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * The exiting Views will be those that are regular Views or ViewGroups that 17959f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * have {@link ViewGroup#isTransitionGroup} return true. Typical Transitions will extend 17969f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.Visibility} as exiting is governed by changing visibility 17979f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * from {@link View#VISIBLE} to {@link View#INVISIBLE}. If transition is null, the views will 17989f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * remain unaffected. 17999f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18009f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return the Transition to use to move Views out of the Scene when the Fragment 18019f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * is being closed not due to popping the back stack. 18029f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18039f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getExitTransition() { 18049f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mExitTransition; 18059f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18069f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18079f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18089f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used to move Views in to the scene when returning due 18099f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * to popping a back stack. The entering Views will be those that are regular Views 18109f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * or ViewGroups that have {@link ViewGroup#isTransitionGroup} return true. Typical Transitions 18119f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * will extend {@link android.transition.Visibility} as exiting is governed by changing 18129f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * visibility from {@link View#VISIBLE} to {@link View#INVISIBLE}. If transition is null, 18139f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * the views will remain unaffected. If nothing is set, the default will be to use the same 18149f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * transition as {@link #setExitTransition(Object)}. 18159f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18169f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use to move Views into the scene when reentering from a 18179f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * previously-started Activity. <code>transition</code> 18189f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * must be an android.transition.Transition. 18199f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18209f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setReenterTransition(Object transition) { 18219f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mReenterTransition = transition; 18229f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18239f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18249f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18259f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns the Transition that will be used to move Views in to the scene when returning due 18269f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * to popping a back stack. The entering Views will be those that are regular Views 18279f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * or ViewGroups that have {@link ViewGroup#isTransitionGroup} return true. Typical Transitions 18289f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * will extend {@link android.transition.Visibility} as exiting is governed by changing 18299f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * visibility from {@link View#VISIBLE} to {@link View#INVISIBLE}. If transition is null, 18309f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * the views will remain unaffected. If nothing is set, the default will be to use the same 18319f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * transition as {@link #setExitTransition(Object)}. 18329f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18339f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return the Transition to use to move Views into the scene when reentering from a 18349f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * previously-started Activity. 18359f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18369f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getReenterTransition() { 18379f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mReenterTransition == USE_DEFAULT_TRANSITION ? getExitTransition() 18389f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount : mReenterTransition; 18399f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18409f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18419f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18429f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used for shared elements transferred into the content 18439f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. Typical Transitions will affect size and location, such as 18449f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.ChangeBounds}. A null 18459f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * value will cause transferred shared elements to blink to the final position. 18469f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18479f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use for shared elements transferred into the content 18489f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. <code>transition</code> must be an android.transition.Transition. 18499f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18509f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setSharedElementEnterTransition(Object transition) { 18519f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mSharedElementEnterTransition = transition; 18529f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18539f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18549f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18559f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns the Transition that will be used for shared elements transferred into the content 18569f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. Typical Transitions will affect size and location, such as 18579f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.ChangeBounds}. A null 18589f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * value will cause transferred shared elements to blink to the final position. 18599f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18609f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return The Transition to use for shared elements transferred into the content 18619f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. 18629f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18639f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getSharedElementEnterTransition() { 18649f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mSharedElementEnterTransition; 18659f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18669f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18679f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18689f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets the Transition that will be used for shared elements transferred back during a 18699f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * pop of the back stack. This Transition acts in the leaving Fragment. 18709f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Typical Transitions will affect size and location, such as 18719f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.ChangeBounds}. A null 18729f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * value will cause transferred shared elements to blink to the final position. 18739f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * If no value is set, the default will be to use the same value as 18749f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link #setSharedElementEnterTransition(Object)}. 18759f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18769f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param transition The Transition to use for shared elements transferred out of the content 18779f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. <code>transition</code> must be an android.transition.Transition. 18789f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18799f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setSharedElementReturnTransition(Object transition) { 18809f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mSharedElementReturnTransition = transition; 18819f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18829f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 18839f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 18849f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Return the Transition that will be used for shared elements transferred back during a 18859f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * pop of the back stack. This Transition acts in the leaving Fragment. 18869f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Typical Transitions will affect size and location, such as 18879f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link android.transition.ChangeBounds}. A null 18889f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * value will cause transferred shared elements to blink to the final position. 18899f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * If no value is set, the default will be to use the same value as 18909f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * {@link #setSharedElementEnterTransition(Object)}. 18919f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 18929f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return The Transition to use for shared elements transferred out of the content 18939f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Scene. 18949f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 18959f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public Object getSharedElementReturnTransition() { 18969f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return mSharedElementReturnTransition == USE_DEFAULT_TRANSITION ? 18979f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount getSharedElementEnterTransition() : mSharedElementReturnTransition; 18989f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 18999f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 19009f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 19019f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets whether the the exit transition and enter transition overlap or not. 19029f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * When true, the enter transition will start as soon as possible. When false, the 19039f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * enter transition will wait until the exit transition completes before starting. 19049f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 19059f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param allow true to start the enter transition when possible or false to 19069f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * wait until the exiting transition completes. 19079f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 19089f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setAllowEnterTransitionOverlap(boolean allow) { 19099f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mAllowEnterTransitionOverlap = allow; 19109f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 19119f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 19129f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 19139f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns whether the the exit transition and enter transition overlap or not. 19149f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * When true, the enter transition will start as soon as possible. When false, the 19159f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * enter transition will wait until the exit transition completes before starting. 19169f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 19179f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return true when the enter transition should start as soon as possible or false to 19189f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * when it should wait until the exiting transition completes. 19199f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 19209f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public boolean getAllowEnterTransitionOverlap() { 19219f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return (mAllowEnterTransitionOverlap == null) ? true : mAllowEnterTransitionOverlap; 19229f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 19239f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 19249f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 19259f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Sets whether the the return transition and reenter transition overlap or not. 19269f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * When true, the reenter transition will start as soon as possible. When false, the 19279f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * reenter transition will wait until the return transition completes before starting. 19289f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 19299f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @param allow true to start the reenter transition when possible or false to wait until the 19309f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * return transition completes. 19319f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 19329f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public void setAllowReturnTransitionOverlap(boolean allow) { 19339f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount mAllowReturnTransitionOverlap = allow; 19349f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 19359f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 19369f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 19379f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * Returns whether the the return transition and reenter transition overlap or not. 19389f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * When true, the reenter transition will start as soon as possible. When false, the 19399f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * reenter transition will wait until the return transition completes before starting. 19409f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * 19419f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * @return true to start the reenter transition when possible or false to wait until the 19429f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount * return transition completes. 19439f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount */ 19449f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount public boolean getAllowReturnTransitionOverlap() { 19459f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount return (mAllowReturnTransitionOverlap == null) ? true : mAllowReturnTransitionOverlap; 19469f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount } 19479f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount 19489f4a046cbeb22a24d322a644323b41022ad9d15aGeorge Mount /** 1949cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * Print the Fragments's state into the given stream. 1950cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * 1951cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param prefix Text to print at the front of each line. 1952cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param fd The raw file descriptor that the dump is being sent to. 1953cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param writer The PrintWriter to which you should dump your state. This will be 1954cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * closed for you after you return. 1955cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn * @param args additional arguments to the dump request. 1956cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn */ 1957cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn public void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args) { 1958cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mFragmentId=#"); 1959cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(Integer.toHexString(mFragmentId)); 19605506618c80a292ac275d8b0c1046b446c7f58836Dianne Hackborn writer.print(" mContainerId=#"); 1961cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(Integer.toHexString(mContainerId)); 1962cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mTag="); writer.println(mTag); 1963cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mState="); writer.print(mState); 1964cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mIndex="); writer.print(mIndex); 1965cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mWho="); writer.print(mWho); 1966cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mBackStackNesting="); writer.println(mBackStackNesting); 1967cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mAdded="); writer.print(mAdded); 1968cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mRemoving="); writer.print(mRemoving); 1969cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mFromLayout="); writer.print(mFromLayout); 1970cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mInLayout="); writer.println(mInLayout); 1971cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mHidden="); writer.print(mHidden); 1972e4417c91a0bb2fba42a0aaa99edcca1b238af21aDianne Hackborn writer.print(" mDetached="); writer.print(mDetached); 19732a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn writer.print(" mMenuVisible="); writer.print(mMenuVisible); 1974cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mHasMenu="); writer.println(mHasMenu); 19752a4d8518f36346ea25a22a736453ff28f2954165Dianne Hackborn writer.print(prefix); writer.print("mRetainInstance="); writer.print(mRetainInstance); 197679398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell writer.print(" mRetaining="); writer.print(mRetaining); 197779398eaefea45e61d839cf4e0534f0eafee70a09Adam Powell writer.print(" mUserVisibleHint="); writer.println(mUserVisibleHint); 1978cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mFragmentManager != null) { 1979cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mFragmentManager="); 1980cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.println(mFragmentManager); 1981cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1982d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy if (mHost != null) { 1983d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy writer.print(prefix); writer.print("mHost="); 1984d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy writer.println(mHost); 1985cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 19860adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mParentFragment != null) { 19870adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn writer.print(prefix); writer.print("mParentFragment="); 19880adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn writer.println(mParentFragment); 19890adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 1990cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mArguments != null) { 1991cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mArguments="); writer.println(mArguments); 1992cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1993cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mSavedFragmentState != null) { 1994cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mSavedFragmentState="); 1995cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.println(mSavedFragmentState); 1996cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 1997cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mSavedViewState != null) { 1998cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mSavedViewState="); 1999cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.println(mSavedViewState); 2000cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2001cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mTarget != null) { 2002cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mTarget="); writer.print(mTarget); 2003cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(" mTargetRequestCode="); 2004cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.println(mTargetRequestCode); 2005cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2006cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mNextAnim != 0) { 2007cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mNextAnim="); writer.println(mNextAnim); 2008cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2009cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mContainer != null) { 2010cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mContainer="); writer.println(mContainer); 2011cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2012cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mView != null) { 2013cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mView="); writer.println(mView); 2014cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2015cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mInnerView != null) { 2016cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mInnerView="); writer.println(mView); 2017cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2018cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mAnimatingAway != null) { 2019cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mAnimatingAway="); writer.println(mAnimatingAway); 2020cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.print("mStateAfterAnimating="); 2021cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.println(mStateAfterAnimating); 2022cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2023cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoaderManager != null) { 2024cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn writer.print(prefix); writer.println("Loader Manager:"); 2025cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoaderManager.dump(prefix + " ", fd, writer, args); 2026cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 20270adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20280adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn writer.print(prefix); writer.println("Child " + mChildFragmentManager + ":"); 20290adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dump(prefix + " ", fd, writer, args); 20300adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20310adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20320adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 20330adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn Fragment findFragmentByWho(String who) { 20340adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (who.equals(mWho)) { 20350adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return this; 20360adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20370adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20380adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return mChildFragmentManager.findFragmentByWho(who); 20390adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20400adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return null; 20410adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20420adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 20430adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void instantiateChildFragmentManager() { 2044e0f27d39b0a4f0ef30ef6446e7b675279961cc94Chris Banes mChildFragmentManager = new FragmentManagerImpl(); 2045d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mChildFragmentManager.attachController(mHost, new FragmentContainer() { 20460adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn @Override 20470fb3ec354da6c1f3ed1777bca5270710cc537e92Scott Kennedy @Nullable 20488491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy public View onFindViewById(int id) { 20490adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mView == null) { 20500adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new IllegalStateException("Fragment does not have a view"); 20510adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20520adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return mView.findViewById(id); 20530adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20547516316ffdf6fbf7b248c615404831191daa66a4George Mount 20557516316ffdf6fbf7b248c615404831191daa66a4George Mount @Override 20568491eb62f621cd5de4b4caed839be09c77011f53Todd Kennedy public boolean onHasView() { 20577516316ffdf6fbf7b248c615404831191daa66a4George Mount return (mView != null); 20587516316ffdf6fbf7b248c615404831191daa66a4George Mount } 20590adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn }, this); 20600adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20610adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 20620adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performCreate(Bundle savedInstanceState) { 20630adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20640adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.noteStateNotSaved(); 20650adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 206620735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = CREATED; 20670adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 20680adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onCreate(savedInstanceState); 20690adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 20700adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 20710adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onCreate()"); 20720adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20730adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20740adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 20750adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn View performCreateView(LayoutInflater inflater, ViewGroup container, 20760adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn Bundle savedInstanceState) { 20770adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20780adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.noteStateNotSaved(); 20790adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20800adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return onCreateView(inflater, container, savedInstanceState); 20810adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20820adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 20830adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performActivityCreated(Bundle savedInstanceState) { 20840adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20850adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.noteStateNotSaved(); 20860adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 208720735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = ACTIVITY_CREATED; 20880adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 20890adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onActivityCreated(savedInstanceState); 20900adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 20910adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 20920adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onActivityCreated()"); 20930adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 20940adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 20950adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchActivityCreated(); 20960adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 2097cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2098cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn 20999c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn void performStart() { 21000adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21010adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.noteStateNotSaved(); 21020adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.execPendingActions(); 21030adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 210420735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = STARTED; 21050adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 21069c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn onStart(); 21070adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 21080adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 21090adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onStart()"); 21100adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21110adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21120adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchStart(); 21130adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21149c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn if (mLoaderManager != null) { 21159c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mLoaderManager.doReportStart(); 21169c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 21179c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 21189c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn 21190adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performResume() { 21200adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21210adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.noteStateNotSaved(); 21220adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.execPendingActions(); 21230adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 212420735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = RESUMED; 21250adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 21260adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onResume(); 21270adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 21280adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 21290adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onResume()"); 21300adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21310adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21320adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchResume(); 21330adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.execPendingActions(); 21340adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21350adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21360adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 21375fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian void performMultiWindowModeChanged(boolean isInMultiWindowMode) { 21385fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian onMultiWindowModeChanged(isInMultiWindowMode); 21395fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian if (mChildFragmentManager != null) { 21405fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian mChildFragmentManager.dispatchMultiWindowModeChanged(isInMultiWindowMode); 21415fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 21425fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 21435fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 21445fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian void performPictureInPictureModeChanged(boolean isInPictureInPictureMode) { 21455fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian onPictureInPictureModeChanged(isInPictureInPictureMode); 21465fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian if (mChildFragmentManager != null) { 21475fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian mChildFragmentManager.dispatchPictureInPictureModeChanged(isInPictureInPictureMode); 21485fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 21495fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian } 21505fa6d3dd3f408ceb2ff7368fd0259713d9382ad8Andrii Kulian 21510adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performConfigurationChanged(Configuration newConfig) { 21520adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onConfigurationChanged(newConfig); 21530adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21540adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchConfigurationChanged(newConfig); 21550adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21560adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21570adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 21580adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performLowMemory() { 21590adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onLowMemory(); 21600adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21610adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchLowMemory(); 21620adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21630adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21640adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 21650adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn /* 21660adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performTrimMemory(int level) { 21670adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onTrimMemory(level); 21680adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21690adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchTrimMemory(level); 21700adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21710adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21720adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn */ 21730adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 21740adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean performCreateOptionsMenu(Menu menu, MenuInflater inflater) { 21750adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean show = false; 21760adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mHidden) { 21770adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mHasMenu && mMenuVisible) { 21780adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn show = true; 21790adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onCreateOptionsMenu(menu, inflater); 21800adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21810adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21820adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn show |= mChildFragmentManager.dispatchCreateOptionsMenu(menu, inflater); 21830adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21840adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21850adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return show; 21860adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21870adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 21880adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean performPrepareOptionsMenu(Menu menu) { 21890adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean show = false; 21900adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mHidden) { 21910adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mHasMenu && mMenuVisible) { 21920adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn show = true; 21930adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onPrepareOptionsMenu(menu); 21940adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21950adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 21960adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn show |= mChildFragmentManager.dispatchPrepareOptionsMenu(menu); 21970adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21980adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 21990adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return show; 22000adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22010adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 22020adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean performOptionsItemSelected(MenuItem item) { 22030adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mHidden) { 22040adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mHasMenu && mMenuVisible) { 22050adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (onOptionsItemSelected(item)) { 22060adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return true; 22070adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22080adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22090adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22100adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager.dispatchOptionsItemSelected(item)) { 22110adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return true; 22120adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22130adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22140adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22150adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return false; 22160adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22170adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 22180adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn boolean performContextItemSelected(MenuItem item) { 22190adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mHidden) { 22200adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (onContextItemSelected(item)) { 22210adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return true; 22220adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22230adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22240adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager.dispatchContextItemSelected(item)) { 22250adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return true; 22260adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22270adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22280adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22290adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn return false; 22300adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22310adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 22320adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performOptionsMenuClosed(Menu menu) { 22330adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mHidden) { 22340adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mHasMenu && mMenuVisible) { 22350adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onOptionsMenuClosed(menu); 22360adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22370adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22380adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchOptionsMenuClosed(menu); 22390adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22400adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22410adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22420adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 22430adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performSaveInstanceState(Bundle outState) { 22440adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onSaveInstanceState(outState); 22450adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22460adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn Parcelable p = mChildFragmentManager.saveAllState(); 22470adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (p != null) { 22480adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn outState.putParcelable(FragmentActivity.FRAGMENTS_TAG, p); 22490adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22500adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22510adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22520adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 22530adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performPause() { 22540adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22550adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchPause(); 22560adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 225720735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = STARTED; 22580adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 22590adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onPause(); 22600adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 22610adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 22620adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onPause()"); 22630adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22640adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 22650adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 2266cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn void performStop() { 22670adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22680adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchStop(); 22690adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 227020735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = STOPPED; 22710adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 2272cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn onStop(); 22730adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 22740adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 22750adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onStop()"); 22760adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 2277681a6fb06bdedb8661a68a1b9e34727b6059aa39Dianne Hackborn } 2278681a6fb06bdedb8661a68a1b9e34727b6059aa39Dianne Hackborn 2279218c1e661578e2a17928f7dbb590b43d1c79aeb7Dianne Hackborn void performReallyStop() { 22800adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 22810adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchReallyStop(); 22820adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 228320735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = ACTIVITY_CREATED; 2284cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoadersStarted) { 2285cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoadersStarted = false; 2286cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (!mCheckedForLoaderManager) { 2287cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mCheckedForLoaderManager = true; 2288d608cf6e08769bf320c1b595cbbd9a7664160449Todd Kennedy mLoaderManager = mHost.getLoaderManager(mWho, mLoadersStarted, false); 2289cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2290cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn if (mLoaderManager != null) { 229164ece2df3d6d789f7a642692acbe85fa1b998d6bTodd Kennedy if (mHost.getRetainLoaders()) { 2292cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn mLoaderManager.doRetain(); 22932bdd09a243b422960168170e2344274cc9cfd788Todd Kennedy } else { 22942bdd09a243b422960168170e2344274cc9cfd788Todd Kennedy mLoaderManager.doStop(); 2295cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2296cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2297cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 2298cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn } 22999c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn 23009c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn void performDestroyView() { 23010adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 23020adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchDestroyView(); 23030adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 230420735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = CREATED; 23050adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 23069c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn onDestroyView(); 23070adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 23080adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 23090adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onDestroyView()"); 23100adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 23119c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn if (mLoaderManager != null) { 23129c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn mLoaderManager.doReportNextStart(); 23139c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 23149c53b844bd525e6a04e17291efc38713893074cdDianne Hackborn } 23150adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn 23160adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn void performDestroy() { 23170adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (mChildFragmentManager != null) { 23180adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mChildFragmentManager.dispatchDestroy(); 23190adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 232020735a45289fdad3d5d31228992e0dccd3d5dd4fAdam Powell mState = INITIALIZING; 23210adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn mCalled = false; 23220adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn onDestroy(); 23230adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn if (!mCalled) { 23240adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn throw new SuperNotCalledException("Fragment " + this 23250adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn + " did not call through to super.onDestroy()"); 23260adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 23274706c089880423ee5929d4635c6dfc5c3151b20fGeorge Mount mChildFragmentManager = null; 23280adacc1aa313d757ae1c517152cef838e0f35c13Dianne Hackborn } 23299375145b63d854c64aad99e6e50c5b7e5ba32b95Adam Powell 2330916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell void performDetach() { 2331916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell mCalled = false; 2332916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell onDetach(); 2333916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell if (!mCalled) { 2334916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell throw new SuperNotCalledException("Fragment " + this 2335916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell + " did not call through to super.onDetach()"); 2336916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell } 2337916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell 2338916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell // Destroy the child FragmentManager if we still have it here. 2339916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell // We won't unless we're retaining our instance and if we do, 2340916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell // our child FragmentManager instance state will have already been saved. 2341916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell if (mChildFragmentManager != null) { 2342916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell if (!mRetaining) { 2343916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell throw new IllegalStateException("Child FragmentManager of " + this + " was not " 2344916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell + " destroyed and this fragment is not retaining instance"); 2345916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell } 2346916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell mChildFragmentManager.dispatchDestroy(); 2347916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell mChildFragmentManager = null; 2348916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell } 2349916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell } 2350916455675ddb34d0eb848b2355550268d82c3ce7Adam Powell 2351cba2e2c881e8e16ea5025b564c94320174d65f01Dianne Hackborn} 2352