TabWidget

版本：Android 3.0 r1

结构

继承关系

public classTabWidgetextendsLinearLayout

implementsView.OnFocusChangeListener

java.lang.Object

android.view.View

android.view.ViewGroup

android.widget.LinearLayout

android.widget.TabWidget

类概述

显示选项卡标签的列表，用于代表父选项卡集合的每一页。当前widget的容器对象是TabHost。当用户选择一个选项卡时，此对象给父容器对象TabHost发送一个消息，告诉TabHost切换到对应的页面显示。此对象上的很多方法，你通常不会直接使用。容器TabHost被用来添加标签，添加并管理回调函数。你可能会调用此对象以迭代选项卡列表，或者调整选项卡列表的布局，但大多数方法应该是通过容器TabHost对象调用。

参见Tab Layout tutorial。

XML属性

属性名称	描述
android:divider	可绘制对象，被绘制在选项卡窗口间充当分割物。
android:tabStripEnabled	确定是否在选项卡绘制
android:tabStripLeft	被用来绘制选项卡下面的分割线左边部分的可视化对象。
android:tabStripRight	被用来绘制选项卡下面的分割线右边部分的可视化对象。

公共方法

public voidaddView(View child)

增加子视图。如果子视图没有设置布局参数，那么将为子视图设置此ViewGroup默认的布局参数。

参数

child新增的子视图

public voidchildDrawableStateChanged(View child)

如果调用addStatesFromChildren函数返回true，刷新此组的可视化对象的状态（包括它的子元素的状态）。

参数

child可视化对象状态被改变的子元素。

public voiddispatchDraw(Canvas canvas)

绘制时调用此方法来绘制子视图。派生类在被绘制之前，为获取控制可能会重写此方法（但必须在它自己的视图已经被绘制之后）。

参数

canvas绘制视图的画布(canvas)

public voidfocusCurrentTab(int index)

设置当前选项卡并且让其获得焦点。此方法确保获取焦点的选项卡窗口匹配选中的窗口，一般情况下类似setCurrentTab(int)。通常当我们通过操作UI实现时，这些都不是问题，

因为UI负责调用TabWidget.onFocusChanged()，但如果我们通过程序控制选中选项卡窗口，那么我们就必须确认保持焦点。（译者注：setCurrentTab(int)执行后，选中指定索引的选项卡窗口，但不获取焦点。focusCurrentTab(int)执行后，不仅通过调用setCurrentTab(int)

选中指定索引的选项卡窗口还获取焦点。）

参数

index你想要设置焦点（橘色高亮）并且选中（选项卡被至于部件widget的前端）的选项卡。

参见

setCurrentTab(int)

public ViewgetChildTabViewAt(int index)

返回位于指定索引位置的选项卡标识符的视图

参数

index选项卡指示符视图返回的从零开始的索引

返回值

在提供的索引位置上的选项卡指示符视图

public intgetTabCount()

返回选项卡的数量

返回值

选项卡指示符视图的数量

public booleanisStripEnabled()

指明选项卡指示符的底部分隔线是否绘制

public voidonFocusChange(View v, boolean hasFocus)

当视图的焦点状态被改变时调用。

参数

v状态变化的视图

hasFocus视图的新焦点状态。

public voidsendAccessibilityEventUnchecked(AccessibilityEvent event)

处理用于发送AccessibilityEvent的请求。如果再发送之前调度事件，本方法不保证可访问性检查。可以通过调用者调用isEnabled()检查。

参数

event事件

public void setCurrentTab (int index)

设置当前选项卡。此方法被用来将选项卡置于widget的前部，并且通知其它的UI元素，一个不同的选项卡被调整到了前台。注意，这不同于传统的“焦点”，是从视图逻辑的焦点。

例如，如果我们在选项卡式视图中有一个列表，一个用户可能会上下移动列表，通过列表选项移动UI焦点（橘色高亮）。光标的移动并不影响选项卡的选中状态，因为滚动是在同一个选项卡上的。选中的选项卡仅仅当我们在选项卡上切换时（在此例中，从列表视图移到下一选项卡视图）更改。如果想要一次性的设置焦点并选中选项卡，请使用setCurrentTab(int)。

正常情况下，视图逻辑关注调整焦点，除非你规避了UI，你可能仅仅将你的兴趣集中在这里。

参数

index你想要指做选中选项卡的选项卡索引（选项卡被显示到widget的前部）

参见

focusCurrentTab(int)

public voidsetDividerDrawable(Drawable drawable)

设置用于在选项窗口指示符间分隔的可绘制对象

参数

drawable用于分隔的可绘制对象

public voidsetDividerDrawable(int resId)

设置用于在两个选项卡标识符之间进行分隔的可绘制对象

参数

resId被用来分隔的可绘制对象的资源标识

public voidsetEnabled(boolean enabled)

设置当前视图的启用状态。子类的不同而其对应的启用状态的解释也不相同。

参数

enabled是否启动

public voidsetLeftStripDrawable(int resId)

设置被用来当作选项卡指示符下面的分割线，左边部分的可绘制对象。

参数

resId the被用来当作左边分隔线的可绘制对象的资源标识符

public voidsetLeftStripDrawable(Drawable drawable)

设置被用来当作选项卡指示符下面的分割线，左边部分的可绘制对象。

参数

drawable左边分隔线的可绘制对象

public voidsetRightStripDrawable(int resId)

设置被用来当作选项卡指示符下面的分割线，右边部分的可绘制对象。

参数

resId被用来当作右边分隔线的可绘制对象的资源标识符

public voidsetRightStripDrawable(Drawable drawable)

设置被用来当作选项卡指示符下面的分割线，右边部分的可绘制对象。

参数

drawable右边分隔线的可绘制对象

public voidsetStripEnabled(boolean stripEnabled)

控制选项卡指示符底部的分隔线是否绘制。默认是绘制。如果用户为选项卡指示符指定一个定制的视图，那么TabHost类调用此方法以禁用绘制底部分割线。

参数

stripEnabled如果需要绘制底部分割线为true

受保护方法

protected int getChildDrawingOrder (int childCount, int i)

返回要绘制的子元素在当前迭代中的索引。如果你需要修改子元素的绘制顺序，可以覆写此方法。默认情况下返回参数i值。

注意：为使此方法被调用，你必须先通过调用setChildrenDrawingOrderEnabled(boolean)启用子元素排序

参数

i当前的迭代值

返回值

将要绘制的子元素在当前迭代的索引

protected void onSizeChanged (int w, int h, int oldw, int oldh)

布局过程中，当此视图的大小发生改变时被调用的。如果你只是添加到视图的层次结构，你调用时可以使用0当作之前的值（old value）。

参数

w此视图的当前宽度

h此视图的当前高度

oldw Old此视图之前的宽度

oldh此视图之前的高度

补充

术语对照

indicator指示符

drawable可绘制对象

iteration迭代

strips分割线

文章链接

Android选项卡(TabWidget)例子

{Android学习指南}TabWidget

Android将TAB选项卡放在屏幕底部

示例代码

Java：

public class TabDemo1 extends Activity implements OnClickListener {

TabHost mTabHost = null;

TabWidget mTabWidget = null;

Button btnVisiable, btnStrip;

@Override

protected void onCreate(Bundle savedInstanceState) {

// TODO Auto-generated method stub

super.onCreate(savedInstanceState);

setContentView(R.layout.tabdemo1);

mTabHost = (TabHost) findViewById(android.R.id.tabhost);

mTabHost.setup();

mTabWidget = mTabHost.getTabWidget();

mTabHost.addTab(mTabHost.newTabSpec("tab1").setContent(

R.id.LinearLayout001).setIndicator("Tab1"));

mTabHost.addTab(mTabHost.newTabSpec("tab2").setContent(

R.id.LinearLayout002).setIndicator("Tab2"));

mTabHost.addTab(mTabHost.newTabSpec("tab3").setContent(

R.id.LinearLayout003).setIndicator("Tab3"));

// mTabHost.setCurrentTab(1);

btnVisiable = (Button) findViewById(R.id.btnVisiable);

btnStrip = (Button) findViewById(R.id.btnStrip);

btnVisiable.setOnClickListener(this);

btnStrip.setOnClickListener(this);

setTitle("共有" + mTabWidget.getTabCount() + "个tab");

}

@Override

public void onClick(View v) {

// TODO Auto-generated method stub

switch (v.getId()) {

case R.id.btnVisiable:

if (mTabWidget.getVisibility() != android.view.View.VISIBLE)

mTabWidget.setVisibility(android.view.View.VISIBLE);

else

mTabWidget.setVisibility(android.view.View.INVISIBLE);

break;

case R.id.btnStrip:

mTabWidget.setStripEnabled(!mTabWidget.isStripEnabled());

mTabWidget.setRightStripDrawable(android.R.color.transparent);

break;

default:

break;

}

}

}

XML：

android:layout_width="fill_parent" android:layout_height="fill_parent"

android:id="@android:id/tabhost"

>

android:orientation="vertical" android:layout_height="fill_parent"

>

android:layout_width="fill_parent" android:layout_height="wrap_content"

>

android:layout_height="wrap_content" android:layout_width="fill_parent"

>

android:layout_width="fill_parent" android:layout_height="fill_parent"

>

显示状态切换"

android:layout_width="fill_parent" android:layout_height="wrap_content"

>

android:layout_height="wrap_content" android:text="分隔线状态切换"

>

android:layout_height="wrap_content" android:text="小龙是好人!!!"

>

android:layout_width="fill_parent" android:layout_height="fill_parent"

>

android:layout_height="wrap_content" android:text="小龙是坏蛋!"

>

android:layout_width="fill_parent" android:layout_height="fill_parent"

>

android:layout_height="wrap_content" android:text="小龙还是坏蛋!"

>