Android 3.0 r1 API中文文档(105) —— ViewParent

前言

　　本章内容是android.view.ViewParent，版本为Android 3.0 r1，翻译来自"逝憶流緣"，欢迎你们访问他的微波："http://t.qq.com/pansonphy"，再次感谢"逝憶流緣" ！期待你加入Android API 中文的翻译，联系我over140@gmail.com。

 

声明

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

　　　　农民伯伯：http://over140.blog.51cto.com/

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

正文

　　1、结构

 

public interface ViewParent

        

android.view.ViewParent

 

间接子类

AbsListView, AbsSpinner, AbsoluteLayout, AdapterView<T extends Adapter>, AppWidgetHostView, DatePicker, DialerFilter, ExpandableListView, FrameLayout, Gallery, GestureOverlayView, GridView, HorizontalScrollView, ImageSwitcher, LinearLayout, ListView, MediaController, RadioGroup, RelativeLayout, ScrollView, SlidingDrawer, Spinner, TabHost, TabWidget, TableLayout, TableRow, TextSwitcher, TimePicker, TwoLineListItem, ViewAnimator, ViewFlipper, ViewGroup, ViewSwitcher, WebView, ZoomControls

 

 

　　2、类概述

　　　　定义了一些做为View父类，它所具备的功能（译者注：也能够理解为方法）。当一个View与父类交互时，就能够用到这些API了。（译者注：Android中子控件维系一个ViewParent对象，该对象象征着整个控件树的管理者，子控件产生影响整个控件树的事件时，会通知到ViewParent，ViewParent会将其转换成一个自顶向下的事件，分发下去。参照这里）
 

 

　　3、公共方法

 

　　public abstract void bringChildToFront (View child)

           把该视图置于其余全部子视图之上。（译者注：如在FrameLayout中切换被叠放的视图）

　　参数

                 　　child         须要改变顺序的子视图

                  

　　public abstract void childDrawableStateChanged (View child)

           当子视图的drawable状态发生变化的时候，调用该方法。

　　参数

                            child         drawable状态发生变化的子视图

                  

　　public abstract void clearChildFocus (View child)

           当子视图失去焦点的时候调用该方法。

　　参数

                 　　child         失去焦点的子视图

                  

　　public abstract void createContextMenu (ContextMenu menu)

           若是该指定的ContextMenu须要增长菜单，则会由它的父类去填充（同时会向上递归）。

　　参数

                 　　menu       须要填充的菜单

                  

　　public abstract View focusSearch (View v, int direction)

           在指定的方向找到最近的View来切换焦点。

　　参数

                 　　v              当前视图

                 　　direction    FOCUS_UP, FOCUS_DOWN, FOCUS_LEFT, 与FOCUS_RIGHT中取值

 

　　public abstract void focusableViewAvailable (View v)

           通知父类一个新的而且可以取得焦点的子视图能够使用了。用于处理从没有可取得焦点的视图到出现第一个能够取得焦点的视图的转变。

　　参数

                 　　v　　新出现的能够取得焦点的视图

 

　　public abstract boolean getChildVisibleRect (View child, Rect r, Point offset)

        

　　public abstract ViewParent getParent ()

           若是存在父视图，则返回该视图；不然返回NULL。

　　返回

                 　　若是不存在父视图，则返回null

 

　　public abstract void invalidateChild (View child, Rect r)

           重绘当前child指定的范围。

　　参数

                 　　child         当前视图

                 　　r               child中无效的范围区域

 

　　public abstract ViewParent invalidateChildInParent (int[] location, Rect r)

           重绘当前child的所有或者一部分指定范围。location是长度为2的×××数组，两个数分别为child左边和上边的坐标。若是父视图中指定的区域r是无效的，则返回该ViewParent的父视图。若是父视图中指定区域是有效的或者父视图不存在，则返回null。若是方法返回对象不为空，则须要把location数组中的数值更新为返回的ViewParent的左边和上边的坐标值。

　　参数

　　location 　 长度为2的×××数组，数据为须要失效的child左边和上边的坐标值

                 　　r               child中无效的范围区域

　　返回

                 　　ViewParent，若是不存在父视图，则返回null

 

　　public abstract boolean isLayoutRequested ()

           返回该视图父类是否有layout控件被请求。

　　返回

                 　　true须要，false 不须要

 

　　public abstract void recomputeViewAttributes (View child)

           通知父类和子类全部的View属性须要从新生成。

　　参数

                 　　child         改变属性的View

 

　　public abstract void requestChildFocus (View child , View focused)

           当须要转换子类焦点时调用。

　　参数

　　child         该ViewParent须要取得焦点的视图。该视图包含当前聚焦视图。但事实上也不必定会得到焦点

　　focused    child的一个有焦点的子视图

 

　　public abstract boolean requestChildRectangleOnScreen (View child, Rect rectangle, boolean immediate)

           当该child视图须要显示在屏幕特定位置时调用。ViewGroup若是须要重写该方法，能够遵循如下几点：

　　* child必须是该group的直接子类

　　* rectangle要是child中的坐标

　　　　ViewGroup要重写该方法，要坚持几下几点：

　　* 若是rectangle规定的区域已是可见的，那么该方法将什么都不会改变

　　* 只有在rectangle区域可见时，该视图才会有滚动条

　　参数

　　child                  以起请求的直接子视图

　　rectangle          须要显示到屏幕上的区域范围

                       immediate        true禁止有滚动 false 则有

　　返回值

                 　　处理请求操做后是否有滚动

 

　　public abstract void requestDisallowInterceptTouchEvent (boolean disallowIntercept)

           让父类不用onInterceptTouchEvent(MotionEvent)来拦截触屏事件。

           该父类须要把该方法传递给它的父类。同时也要服从触屏的请求（也就是说，只有在按上Up或者clear后才能清除该标识）。

　　参数

　　disallowIntercept    true表示child不让父类拦截触屏事件

 

　　public abstract void requestLayout ()

           当父视图的一个child的Layout控件失效时调用。该方法将会从新请求一个Layout控件。

 

　　public abstract void requestTransparentRegion (View child)

           当一个child但愿视图层去收集透明区域并报告给窗口排序服务时调用。例如SurfaceView能够用这个接口来提升接口性能。若是在当前层次没有视图，没有必要用该方法优化，不然有可能会轻微影响该层的性能。

　　参数

　　child          要求透明区域进行处理的视图

 

　　public abstract boolean showContextMenuForChild (View originalView)

           显示该视图或者其祖先类的上下文菜单。

           大多数状况下，子类不须要重写该方法。可是，当该子类被直接加到窗口管理器上时（例如：addView(View, android.view.ViewGroup.LayoutParams)），就会重写该方法，并显示上下文菜单。

　　参数

　　originalView     须要显示上下文菜单的视图

　　返回

                 　　显示上下文菜单时返回true

 

　　　　public abstract ActionMode startActionModeForChild (View originalView, ActionMode.Callback callback)      Since: API Level 11

　　为指定视图启动一个操做模式。

　　大多数状况下，一个子类并不须要从新此类。可是，若是子类是直接添加到窗口管理器（例如，addView(View, android.view.ViewGroup.LayoutParams)），那么应重写此方法并启动操做模式。（译者注：关于ActionMode参见这里）

　　参数

　　originalView  操做模式首页调用的源视图

　　callback          处理操做模式生命周期的回调函数

　　返回值

　　　　　　　　 若是新的操做模式已经启动，返回该操做模式，不然返回 null 。

 

 

　　4、补充
 

 

　　　　文章精选

                   [推荐]深刻Android 【六】 —— 界面构造

                   Android UI Event Listener