Android中文API(114)——TabWidget

 

前言

  本章内容是android.widget.TabWidget,版本为Android 3.0 r1,本章配备完善的截图、链接和示例代码,翻译来自"madgoat",欢迎大家访问他的博客:http://madgoat.cn/,再次感谢"madgoat" !期待你加入Android 中文翻译组,联系我over140@gmail.com。

 

声明

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

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

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

 

正文

  一、结构

  public class TabWidget extends LinearLayout

implements View.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 void addView (View child)

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

      参数

      child          新增的子视图

 

  public void childDrawableStateChanged (View child)

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

      参数

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

 

  public void dispatchDraw (Canvas canvas)

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

      参数

      canvas      绘制视图的画布(canvas)

 

  public void focusCurrentTab (int index)

    设置当前选项卡并且让其获得焦点。此方法确保获取焦点的选项卡窗口匹配选中的窗口,一般情况下类似 setCurrentTab(int)。通常当我们通过操作UI实现时,这些都不是问题,因为UI负责调用TabWidget.onFocusChanged(),但如果我们通过程序控制选中选项卡窗口,那么我们就必须确认保持焦点。(译者注:setCurrentTab(int)执行后,选中指定索引的选项卡窗口,但不获取焦点。focusCurrentTab(int)执行后,不仅通过调用setCurrentTab(int)选中指定索引的选项卡窗口还获取焦点。)

      参数

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

      参见

      setCurrentTab(int)

 

  public View getChildTabViewAt (int index)

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

      参数

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

      返回值

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

 

  public int getTabCount ()

    返回选项卡的数量

    返回值

    选项卡指示符视图的数量

 

  public boolean isStripEnabled ()

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

 

  public void onFocusChange (View v, boolean hasFocus)

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

      参数

      v                 状态变化的视图

      hasFocus    视图的新焦点状态。

 

    public void sendAccessibilityEventUnchecked (AccessibilityEvent event)

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

                   参数

                            event        事件

 

  public void setCurrentTab (int index)

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

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

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

      参数

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

      参见

      focusCurrentTab(int)

 

  public void setDividerDrawable (Drawable drawable)

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

      参数

      drawable          用于分隔的可绘制对象

 

  public void setDividerDrawable (int resId)

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

      参数

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

 

  public void setEnabled (boolean enabled)

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

      参数

      enabled    是否启动

 

  public void setLeftStripDrawable (int resId)

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

      参数

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

 

  public void setLeftStripDrawable (Drawable drawable)

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

      参数

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

 

  public void setRightStripDrawable (int resId)

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

      参数

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

 

  public void setRightStripDrawable (Drawable drawable)

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

      参数

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

 

  public void setStripEnabled (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

      AndroidTAB选项卡放在屏幕底部

    示例代码

       

      

      

      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:

<?xml version="1.0" encoding="utf-8"?>
<TabHost xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width
="fill_parent" android:layout_height="fill_parent"
    android:id
="@android:id/tabhost">
    
<LinearLayout android:layout_width="fill_parent"
        android:orientation
="vertical" android:layout_height="fill_parent">
          
        
<TabWidget android:id="@android:id/tabs"
            android:layout_width
="fill_parent" android:layout_height="wrap_content"></TabWidget>
        
<FrameLayout android:id="@android:id/tabcontent"
            android:layout_height
="wrap_content" android:layout_width="fill_parent">
            
<LinearLayout android:id="@+id/LinearLayout001" android:orientation="vertical"
                android:layout_width
="fill_parent" android:layout_height="fill_parent">
            
<Button android:id="@+id/btnVisiable" android:text="显示状态切换"
                    android:layout_width
="fill_parent" android:layout_height="wrap_content"></Button>
                
<Button android:id="@+id/btnStrip" android:layout_width="fill_parent"
                    android:layout_height
="wrap_content" android:text="分隔线状态切换"></Button>
                
<TextView android:id="@+id/TextView1" android:layout_width="fill_parent"
                    android:layout_height
="wrap_content" android:text="小龙是好人!!!"></TextView>
                
            
</LinearLayout>
            
<LinearLayout android:id="@+id/LinearLayout002"
                android:layout_width
="fill_parent" android:layout_height="fill_parent">
                
<TextView android:id="@+id/TextView2" android:layout_width="fill_parent"
                    android:layout_height
="wrap_content" android:text="小龙是坏蛋!"></TextView>
            
</LinearLayout>
            
<LinearLayout android:id="@+id/LinearLayout003"
                android:layout_width
="fill_parent" android:layout_height="fill_parent">
                
<TextView android:id="@+id/TextView3" android:layout_width="fill_parent"
                    android:layout_height
="wrap_content" android:text="小龙还是坏蛋!"></TextView>
            
</LinearLayout>
        
</FrameLayout>
    
</LinearLayout>
</TabHost>

 

结束

  每次合集发布就像受检部队在接受检阅,紧张而又荣耀。为了每次的检阅,大家尽心尽力的筹备,做同一件事情,鼓励自己坚持,鼓励“战友”坚持。致力于可持续发展开源事业的建设。
posted @ 2011-04-12 10:07  农民伯伯  阅读(31738)  评论(5编辑  收藏  举报