Android类参考---FragmentManager

长平狐 发布于 2012/10/16 10:20
阅读 6K+
收藏 2

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. 类说明

嵌套(内部)类

interface FragmentManager.BackStackEntry

代表了Fragment回退堆栈的一个项目实体,调用FragmentTransaction.addToBackStack()方法时会创建这个项目实体。

interface 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。


原文链接:http://blog.csdn.net/fireofstar/article/details/7582190
加载中
返回顶部
顶部