Android 3.0 r1中文API文档(104) —— ViewTreeObserver

前言

　　本章内容是android.view.ViewTreeObserver，版本为Android 3.0 r1，翻译来自"首当其冲"，再次感谢"首当其冲" ！期待你加入Android API 中文的翻译，联系我over140@gmail.com。

声明

　　欢迎转载，但请保留文章原始出处:)

　　　　博客园：http://www.cnblogs.com/

　　　　Android中文翻译组：http://goo.gl/6vJQl

正文

　　一、结构

public final class ViewTreeObserver extends Object

        

java.lang.Object

         android.view.ViewTreeObserver

　　二、概述

　　　　用于注册监听的视图树观察者(observer)，在视图树种全局事件改变时得到通知。这个全局事件不仅还包括整个树的布局，从绘画过程开始，触摸模式的改变等。ViewTreeObserver不能够被应用程序实例化，因为它是由视图提供，参照getViewTreeObserver()以查看更多信息。

 

　　三、内部类

　　　　interface          ViewTreeObserver.OnGlobalFocusChangeListener        

　　　　当在一个视图树中的焦点状态发生改变时，所要调用的回调函数的接口类

　　　　interface          ViewTreeObserver.OnGlobalLayoutListener

　　　　当在一个视图树中全局布局发生改变或者视图树中的某个视图的可视状态发生改变时，所要调用的回调函数的接口类

　　　　interface          ViewTreeObserver.OnPreDrawListener

　　　　当一个视图树将要绘制时，所要调用的回调函数的接口类

　　　　interface          ViewTreeObserver.OnScrollChangedListener

　　　　当一个视图树中的一些组件发生滚动时，所要调用的回调函数的接口类

　　　　interface          ViewTreeObserver.OnTouchModeChangeListener

　　　　当一个视图树的触摸模式发生改变时，所要调用的回调函数的接口类

 

　　四、公共方法

　　public void addOnGlobalFocusChangeListener (ViewTreeObserver.OnGlobalFocusChangeListener listener)

　　注册一个回调函数，当在一个视图树中的焦点状态发生改变时调用这个回调函数。

　　参数

                 　　listener    将要被添加的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false

                           

　　public void addOnGlobalLayoutListener (ViewTreeObserver.OnGlobalLayoutListener listener)

　　注册一个回调函数，当在一个视图树中全局布局发生改变或者视图树中的某个视图的可视状态发生改变时调用这个回调函数。

　　参数

                 　　listener    将要被添加的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false

                  

　　public void addOnPreDrawListener (ViewTreeObserver.OnPreDrawListener listener)

　　注册一个回调函数，当一个视图树将要绘制时调用这个回调函数。

　　参数

                 　　listener    将要被添加的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false

                           

　　public void addOnScrollChangedListener (ViewTreeObserver.OnScrollChangedListener listener)     

　　注册一个回调函数，当一个视图发生滚动时调用这个回调函数。

　　参数

                 　　listener    将要被添加的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false

                           

　　public void addOnTouchModeChangeListener (ViewTreeObserver.OnTouchModeChangeListener listener)

　　注册一个回调函数，当一个触摸模式发生改变时调用这个回调函数。

　　参数

                 　　listener    将要被添加的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false

　　public final void dispatchOnGlobalLayout ()

　　当整个布局发生改变时通知相应的注册监听器。如果你强制对视图布局或者在一个没有附加到一个窗口的视图的层次结构或者在GONE状态下，它可以被手动的调用

                           

　　public final boolean dispatchOnPreDraw ()

　　当一个视图树将要绘制时通知相应的注册监听器。如果这个监听器返回true，则这个绘制将被取消并重新计划。如果你强制对视图布局或者在一个没有附加到一个窗口的视图的层次结构或者在一个GONE状态下，它可以被手动的调用

                   返回值

                            当前绘制能够取消并重新计划则返回true，否则返回false。

        

　　public boolean isAlive ()

　　指示当前的ViewTreeObserver是否可用(alive)。当observer不可用时，任何方法的调用（除了这个方法）都将抛出一个异常。如果一个应用程序保持和ViewTreeObserver一个历时较长的引用，它应该总是需要在调用别的方法之前去检测这个方法的返回值。

                   返回值

                            但这个对象可用则返回true，否则返回false             

 

　　public void removeGlobalOnLayoutListener (ViewTreeObserver.OnGlobalLayoutListener victim)

　　移除之前已经注册的全局布局回调函数。

　　参数

                 　　victim 将要被移除的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false        

　　public void removeOnGlobalFocusChangeListener (ViewTreeObserver.OnGlobalFocusChangeListener victim)

　　移除之前已经注册的焦点改变回调函数。

　　参数

                 　　victim 将要被移除的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false 

                           

　　public void removeOnPreDrawListener (ViewTreeObserver.OnPreDrawListener victim)

　　移除之前已经注册的预绘制回调函数。

　　参数

                 　　victim 将要被移除的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false 

 

　　public void removeOnScrollChangedListener (ViewTreeObserver.OnScrollChangedListener victim)

　　移除之前已经注册的滚动改变回调函数。

　　参数

                 　　victim 将要被移除的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false 

 

　　public void removeOnTouchModeChangeListener (ViewTreeObserver.OnTouchModeChangeListener victim)

　　移除之前已经注册的触摸模式改变回调函数

　　参数

                 　　victim 将要被移除的回调函数

                 异常

                 　　IllegalStateException       如果isAlive() 返回false 

 

　　五、补充

　　文章链接

　　 Android的选择及文字颜色