Android类参考---FragmentManager


1. 继承关系
java.lang.Object
    |____android.app.FragmentManager
2. 类概要
这个类提供了与Activity内部的Fragment对象进行交互的接口。
虽然FragmentManager的API是在HONEYCOMB的版本中被引入的，但是在旧的平台上还有一个通过FragmentActivity类来使用的API版本。
HONEYCOMB：http://developer.android.com/reference/android/os/Build.VERSION_CODES.html#HONEYCOMB
3. 类说明
嵌套(内部)类
inte易做图ce FragmentManager.BackStackEntry
代表了Fragment回退堆栈的一个项目实体，调用FragmentTransaction.addToBackStack()方法时会创建这个项目实体。
inte易做图ce FragmentManager.OnBackStackChangedListener
观察回退堆栈变化的接口
常量
public static final int POP_BACK_STACK_INCLUSIVE
针对popBackStack(String, int)和popBackStack(int, int)方法所设置的标记。如果在调用这两个方法时，设置了这个标记，并且已经提供了回退堆栈中项目实体的名称或ID，那么堆栈中所有匹配的项目实体都会被消耗，直到没有匹配的，或到达堆栈的底部为止。
常量值：1（0x00000001）
Public 构造器
FragmentManager()
Public 方法
public abstract void addOnBackStackChanageListener(FragmentManager.OnBackStackChangedListener)
添加一个新的易做图，用于监听Fragment回退堆栈的变化。
public abstract FragmentTransaction beginTransaction()
启动一个跟FragmentManager关联的一系列的与Fragment对象相关的编辑操作。
注意：一个Fragment事务只能在Activity保存其状态期间被创建/被提交。如果在Activity.onSaveInstanceState()方法调用之后，提交事务则会发生错误。这是因为系统框架需要保存当前Fragment对象的状态，并且如果在状态保存之后来改变Fragment，那么改变的结果也会丢失。
public abstract void dump(String prefix, FileDescriptor fd, PrintWriter writer, String[] args)
把FragmentManager的状态打印输出到给定的流中。
参数：
prefix--->在每行文本的前面要打印输出的文本。
fd--->要输出的转存文件的描述。
writer--->给转存操作设置的一个PrintWriter对象。
args--->给转存请求提供一组额外的参数。
public static void enableDebugLogging(boolean enabled)
控制是否打开框架内Fragment管理器的调试日志（log）。如果开启调试日志，那么就会在Logcat中看到框架执行Fragment操作的日志信息。
public abstract boolean executePendingTransactions()
在用FragmentTransaction.commit()方法提交FragmentTransaction对象后，会在进程的主线程中，用异步的方式来执行。如果想要立即执行这个等待中的操作，就要调用这个方法（只能在主线程中调用）。要注意的是，所有的回调和相关的行为都会在这个调用中被执行完成，因此要仔细确认这个方法的调用位置。
返回值：如果等待中的事务被执行，那么就会返回true。
public abstract Fragment findFragmentById(int id)
这个方法用于查找由给定的id所标识的那个Fragment对象。这个id既可以是源自布局填充时的XML，也可以是添加事务时的容器ID。这个方法首先会搜索被添加到当前管理的Activity中的Fragment对象，如果没有找到，它会搜索当前回退堆栈中所有的Fragment对象，以便找到跟这个ID匹配的Fragment对象。
返回值：如果找到，则返回一个Fragment对象，否则返回null。
public abstract Fragment findFragmentByTag(String tag)
这个方法用于查找由给定的标签所标识的一个Fragment对象，这个标签既可以源自布局填充时XML，也可以是在添加事务时所提供的。这个方法首先会搜索被添加到当前管理的Activity中的Fragment对象，如果没有找到，它会搜索当前回退堆栈中所有的Fragment对象，以便找到跟这个标签匹配的Fragment对象。
返回值：如果找到，则返回一个Fragment对象，否则返回null。
public abstract FragmentManager.BackStackEntry getBackStackEntryAt(int index)
这个方法返易做图退堆栈中由index索引所标识的BackStackEntry对象，索引0指向堆栈底部的实体对象。
public abstract int getBackStackEntryCount()
返易做图退堆栈中当前实体对象的数量。
public abstract Fragment getFragment(Bundle bundle, String key)
返回最近一次用putFragment(Bundle, String, Fragment)方法放置的Fragment对象实例。
参数：
bundle--->制指定要从哪个Bundle对象中获取Fragment引用。
key--->指定Bundle对象中实体对象的名称。
返回值：返回跟给定引用关联的当前Fragment对象实例。
public void invalidateOptionsMenu()
必要的时候，让依附于Activity的选项菜单失效。直到Activity转移到恢复（resumed）状态，这种失效状态才会被终止。
public abstract void popBackStack()
把顶部的状态弹出回退堆栈。这个方法是异步执行的。它会按照请求的顺序来执行弹出操作，但是这个操作直到应用程序把控制权返回给事件循环之后，才能够执行这个操作。
public abstract void popBackStack(String name, int flags)
从管理器的Fragment回退堆栈中把最后放入的由name参数所指定的Fragment对象弹出。这个函数是异步的，它会按照请求的顺序来执行弹出操作，但是直到应用程序把控制权返回给事件循环之后，才会执行这个操作。
参数：
name--->如果这个参数是非空的，那么就要在回退堆栈中查找这个名称所指向的Fragment对象。如果找到，那么这个状态之上的所有状态都会被弹出。POP_BACK_STACK_INCLUSIVE标记能够用于控制命名状态本身是否要被弹出。如果这个参数是null，则只有顶部状态会被弹出。
flags--->既可以是0，也可以是POP_BACK_STACK_INCLUSIVE。
public abstract void popBackStack(int id, int flags)
把给定ID标识所指定的状态之上的所有状态都弹出回退堆栈。这个方法是异步，它会按照请求的顺序来执行弹出操作。但是直到应用程序把控制权返回个事件循环之后才会执行这个操作。
参数：
id--->这个参数设定了要弹出的状态的标识。如果被标识的状态不存在，则什么也不做。POP_BACK_STACK_INCLUSIVE标记能够用于控制id所标识的状态本身是否会被弹出堆栈。
flags--->即可以是0，也可以是POP_BACK_STACK_INCLUSIVE。
public abstract boolean popBackStackImmediate(int id, int flags)
与popBackStack(int, int)方法类似，但是在这个调用的内部，会立即执行弹出操作。就像调用executePendingTransactions()方法之后的效果一样。
返回值：如果弹出了某些状态，则返回true，否则返回false。
public abstract boolean popBackStackImmediate(String name, int flags)
与popBackStack(String, int)方法类似，但是在这个调用的内部，会立即执行弹出操作。就像调用executePendingTransactions()方法之后的效果一样。
返回值：如果弹出了某些状态，则返回true，否则返回false。
public abstract boolean popBackStackImmediate()
与popBackStack()方法类似，但是在这个调用的内部，会立即执行弹出操作。就像调用executePendingTransactions()方法之后的效果一样。
返回值：如果弹出了某些状态，则返回true，否则返回false。
public abstract void putFragment(Bundle bundle, String key, Fragment fragment)
把一个指定的Fragment对象放入一个Bundle对象中。这个Bundle对象能够作为持久的状态来保存，并且在后续的调用getFragment(Bundle, String)方法来恢复的时候，它会返回一个与当前实例相同的Fragment对象。
参数：
bundle--->这个参数指定了一个Bundle对象，方法执行时，会把指定的Fragment对象引用放到这个Bundle对象中。
key--->这参数指定在Bundle对象中这个实体的名称。
fragment--->这个参数指定要保存的Fragment对象的引用。
public abstract void removeOnBackStackChangedListener(FragmentManager.OnBackStackChangedListener listener)
删除之前用addOnBackStackChangedListener(OnBackStackChangedListener)方法添加的一个易做图。
public abstract Fragment.SavedState saveFragmentInstanceState(Fragment f)
保存给定的Fragment对象的当前状态。在创建一个新的Fragment对象实例，并且把它添加到Fragment管理器中之后，能够使用这个方法来创建一个跟Fragment对象的当前状态匹配的状态对象。使用这个方法时要注意以下限制：
1. Fragment对象必须跟当前的FragmentManager对象绑定；
2. 使用这个被保存的状态来创建一个新的Fragment对象，必须与创建这个状态的Fragment对象有相同的类类型。
3. 被保存的状态不能包含对其他的Fragment对象依赖，也就是说，不能使用putFragment(Bundle, String, Fragment)方法来保存一个Fragment对象的引用，因为这个引用这个引用在后续使用时可能是无效的。同样Fragment对象的目标和结果代码也不能包含在这个要保存的状态中。
参数：
f--->要保存状态的Fragment对象。
返回值：
生成的状态对象，如果没有感兴趣的由Fragment所创建的状态，那么这个方易做图返回null。
 
 
摘自 FireOfStar的专栏

补充：移动开发 , Android ,