Android 2.3 r1 API中文文档——TabHost(madgoat).doc

TabHost 译者署名： madgoat 译者链接： 翻译时间：2010-11-25 版本：Android 2.3 r1 结构 继承关系 public class TabHost extends FrameLayout implements ViewTreeObserver.OnTouchModeChangeListener java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.TabHost 类概述 提供Tab页的窗口视图容器一组是用户可以选择指定Tab页的标签另一组是FrameLayout用来显示该Tab页的内容个别元素通常控制使用这个容器对象，而不是设置在子元素本身的值。nterface TabHost.OnTabChangeListener 接口定义了当选项卡更改时被调用的回调函数 interface TabHost.TabContentFactory 当某一选项卡被选中时生成选项卡的内容 class TabHost.TabSpec 单独的选项卡，每个选项卡都有一个选项卡指示符,内容和tag标签,以便于记录. 公共方法 public void addTab (TabHost.TabSpec tabSpec) 新增一个选项卡 参数 tabSpec public void clearAllTabs () 从tab widget中移除所有关联到当前tab host的选项卡 public boolean dispatchKeyEvent (KeyEvent event) 分发按键事件到焦点传递路线上的下一视图。焦点传递路线从视图树的顶层开始一直到当前获取焦点的视图停止。如果此视图已经获取焦点,将分发给它自身。否则，将分发到焦点传递路线的下一节点。此方法会触发任何一个按键监听器. （译者注：关于focus path,可以参考以下地址: /maxleng/archive/2010/05/04/5557758.aspx) 参数 event 返回值 public void dispatchWindowFocusChanged (boolean hasFocus) 当窗口包含的此视图获取或丢失焦点时触发此方法.ViewGroups应该重写以路由到他的子元素 参数 hasFocus public int getCurrentTab () （译者注：获取当前选项卡的id） public String getCurrentTabTag () （译者注：当前选项卡的Tag标签内容） public View getCurrentTabView () （译者注：获取当前选项卡的视图view） public View getCurrentView () （译者注：获取当前的视图view） public FrameLayout getTabContentView () 获取保存tab内容的FrameLayout public TabWidget getTabWidget () （译者注：根据系统规定的id：tabs来找到TabWidget，并返回，注意，这里的ID必须是tabs。源代码中表示如下： private TabWidget mTabWidget; mTabWidget=(TabWidget)findViewById(ernal.R.id.tabs);） public TabHost.TabSpec newTabSpec (String tag) 获取一个新的TabHost.TabSpec，并关联到当前tab host 参数 tag public void onTouchModeChanged (boolean isInTouchMode) 当触摸模式发生改变时调用的回调函数. 参数 isInTouchMode public void setCurrentTab (int index) （译者注：设置当前的选项卡 参数 Index 为当前选项卡的索引。） public void setCurrentTabByTag (String tag) （译者注：根据选项卡的Tab标签来设置当前的选项卡 参数 tag 想要被设置为当前选项卡的tag标签值。） public void setOnTabChangedListener (TabHost.OnTabChangeListener l) 注册一个回调函数，当选项卡中的任何一个tab的选中状态发生改变时调用。 （译者注：setCurrentTab(index)时会触发调用） 参数 l public