android 2.3 r1 中文 api (58) —— TabHost
正文 一、结构 public classTabHost extendsFrameLayoutimplementsViewTreeObserver.OnTouchModeChangeListener java.lang.Object android.view.View android.view.ViewGroup android.widget.FrameLayout android.widget.TabHost 二、概述 提供选项卡（Tab页）的窗口视图容器。此对象包含两个子对象：一组是用户可以选择指定Tab页的标签；另一组是FrameLayout用来显示该Tab页的内容。个别元素通常控制使用这个容器对象，而不是设置在子元素本身的值。 （译者注：即使使用的是单个元素，也最好把它放到容器对象ViewGroup里） 三、内部类 interface TabHost.OnTabChangeListener 接口定义了当选项卡更改时被调用的回调函数 interface TabHost.TabContentFactory 当某一选项卡被选中时生成选项卡的内容 class TabHost.TabSpec 单独的选项卡，每个选项卡都有一个选项卡指示符,内容和tag标签,以便于记录. 四、公共方法 public voidaddTab(TabHost.TabSpec tabSpec) 新增一个选项卡 参数 tabSpec指定怎样创建指示符和内容. public voidclearAllTabs() 从tab widget中移除所有关联到当前tab host的选项卡 public booleandispatchKeyEvent(KeyEvent event) 分发按键事件到焦点传递路线上的下一视图。焦点传递路线从视图树的顶层开始一直到当前获取焦点的视图停止。如果此视图已经获取焦点,将分发给它自身。否则，将分发到焦点传递路线的下一节点。此方法会触发任何一个按键监听器. （译者注：关于focus path,可以参考以下地址: http://blog.csdn.net/maxleng/archive/2010/05/04/5557758.aspx） 参数 event分发的按键事件 返回值 如果事件已经处理则返回true,否则返回false. public voiddispatchWindowFocusChanged(boolean hasFocus) 当窗口包含的此视图获取或丢失焦点时触发此方法.ViewGroups应该重写以路由到他的子元素 参数 hasFocus如果窗口包含的此view依获取焦点,返回true,否则返回false. public intgetCurrentTab() （译者注：获取当前选项卡的id） public StringgetCurrentTabTag() （译者注：当前选项卡的Tag标签内容） public ViewgetCurrentTabView() （译者注：获取当前选项卡的视图view） public ViewgetCurrentView() （译者注：获取当前的视图view） public FrameLayoutgetTabContentView() 获取保存tab内容的FrameLayout public TabWidgetgetTabWidget() （译者注：根据系统规定的id：tabs来找到TabWidget，并返回，注意，这里的ID必须是tabs。源代码中表示如下： private TabWidget mTabWidget; mTabWidget=(TabWidget)findViewById(com.android.internal.R.id.tabs);） public TabHost.TabSpecnewTabSpec(String tag) 获取一个新的TabHost.TabSpec，并关联到当前tab host 参数 tag所需的选项卡标签(tag) public voidonTouchModeChanged(boolean isInTouchMode) 当触摸模式发生改变时调用的回调函数. 参数 isInTouchMode如果视图结构当前处于触摸模式,返回true,否则返回false. public voidsetCurrentTab(int index) （译者注：设置当前的选项卡 参数 Index为当前选项卡的索引。） public voidsetCurrentTabByTag(String tag) （译者注：根据选项卡的Tab标签来设置当前的选项卡 参数 tag想要被设置为当前选项卡的tag标签值。） public voidsetOnTabChangedListener(TabHost.OnTabChangeListener l) 注册一个回调函数，当选项卡中的任何一个tab的选中状态发生改变时调用。 （译者注：setCurrentTab(index)时会触发调用） 参数 l将运行的回调函数 public voidsetup() 如果使用findViewById()加载TabHost，那么在新增一个选项卡tab之前，需要调用setup()。然而，当你在一个TabActivity里使用getTabHost()获取TabHost，你就不再需要调用setup()了。（译者注：实现tab窗口的两种方法：继承activity时，使用findViewById()查找TabHost，然后调用setup()；继承TabActivity，通过getTabHost()查找，此时不用调用setup()）例子： public voidsetup(LocalActivityManager activityGroup) 如果你使用setContent(android.content.Intent)，那么当activityGroup用于加载本地activity之时，必须调用此方法。如果你拓展（继承）TabActivity将自动调用setup()方法。 参数 activityGroup用来为选项卡内容加载activities的ativityGroup 五、受保护方法 protected voidonAttachedToWindow() 当视图附加到窗口上时被调用。在这个点的表面进行绘制。注意此函数确保在onDraw(Cancas)之前调用，然而它可能在第一次执行onDraw之前的任何时间被调用——包括的onMeasure(int,int)的之前或之后。 protected void onDetachedFromWindow () 当视图从窗口分离时被调用。在这个点的表面不再有画面绘制。 六、补充 文章链接 史上最全的Android的Tab与TabHost讲解 Android UI设计Tab TabHost标签页的使用 Android控件之TabHost Tab页 动态Tab页 示例代码 截图： JAVA文件： public class Tabs1 extends TabActivity{ @Override protected void onCreate(BundlesavedInstanceState){ super .onCreate(savedInstanceState); TabHosttabHost = getTabHost(); LayoutInflater.from( this ).inflate(R.layout.tabs1,tabHost.getTabContentView(), true ); tabHost.addTab(tabHost.newTabSpec( " tab1 " ) .setIndicator( " tab1 " ) .setContent(R.id.view1)); tabHost.addTab(tabHost.newTabSpec( " tab3 " ) .setIndicator( " tab2 " ) .setContent(R.id.view2)); tabHost.addTab(tabHost.newTabSpec( " tab3 " ) .setIndicator( " tab3 " ) .setContent(R.id.view3)); } } XML文件： <? xmlversion="1.0"encoding="utf-8" ?> < FrameLayout xmlns:android ="http://schemas.android.com/apk/res/android" android:layout_width ="match_parent" android:layout_height ="match_parent" > < TextView android:id ="@+id/view1" android:background ="@drawable/blue" android:layout_width ="match_parent" android:layout_height ="match_parent" android:text ="@string/tabs_1_tab_1" /> < TextView android:id ="@+id/view2" android:background ="@drawable/red" android:layout_width ="match_parent" android:layout_height ="match_parent" android:text ="@string/tabs_1_tab_2" /> < TextView android:id ="@+id/view3" android:background ="@drawable/green" android:layout_width ="match_parent" android:layout_height ="match_parent" android:text ="@string/tabs_1_tab_3" /> </ FrameLayout > 详细参见apidemo/view/tabs1 本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582561，如需转载请自行联系原作者
