Android 中文API （61） —— ViewSwitcher

 

前言

　　本章內容是 android.widget.ViewSwitcher，版本為Android 2.3 r1，翻譯來自"ivanlee"，再次感謝"ivanlee" ！期待你一起參與Android中文API的翻譯，聯絡我over140@gmail.com。

 

聲明

　　歡迎轉載，但請保留文章原始出處:)

　　　　部落格園：http://www.cnblogs.com/

　　　　Android中文翻譯組：http://code.taobao.org/project/view/404/

 

本文

　　一、結構

public class ViewSwitcher extends ViewAnimator

        

java.lang.Object

android.view.View

         android.view.ViewGroup

                   android.widget.FrameLayout

                            android.widget.ViewAnimator

                                     android.widget.ViewSwitcher

 

已知直接子類

ImageSwitcher, TextSwitcher

 

　　二、概述

　　　　 在兩個視圖間轉換時顯示動畫，有一個可以建立這些視圖的工廠類。你可以用工廠來建立這些視圖，也可以自己建立。一個ViewSwitcher只允許包含兩個子視圖，且一次僅能顯示一個。

　　（譯者註：與ViewFlipper類相似，但該類不常用，常用其兩個子類ImageSwitcher：轉換圖片時增加動畫效果; TextSwitcher： 轉換文字時增加動畫效果; 其執行個體見apidemos中ImageSwitcher執行個體和TextSwitcher執行個體）

 

　　三、內部類

　　　　interface          ViewSwitcher.ViewFactory     

　　　　在一個ViewSwitcher裡建立視圖

 

　　四、建構函式

　　　　public ViewSwitcher (Context context)

　　　　構造一個新的空的視圖轉換器(ViewSwitcher)。

　　　　參數

　　　　context  應用環境（譯者註：應用程式上下文）

 

　　　　public ViewSwitcher (Context context, AttributeSet attrs)

　　　　構造一個指定上下文、屬性集合的空的視圖轉換器(ViewSwitcher)。

　　　　參數

　　　　context  應用環境（譯者註：應用程式上下文）

　　　　attrs        屬性集合

 

　　五、公用方法

　　public void addView(View child, int index, ViewGroup.LayoutParams params)

    　　  添加一個指定布局參數的子視圖

          　　參數

　　child         添加的子視圖

　　index       添加的子視圖的索引

　　params    子視圖的布局參數

　 異常

　　IllegalStateException       如果切換器中已經包含了兩個視圖時。

   

　　public View getNextView ()

　　返回下一個要顯示的視圖

　　返回  

       　  　　視圖切換之後將要顯示出的下一個視圖

 

　　public void reset ()

　　重設視圖轉換器(ViewSwitcher）來隱藏所有存在的視圖，並使轉換器達到一次動畫都還沒有播放的狀態。

 

　　public void setFactory (ViewSwitcher.ViewFactory factory)

　　設定用來產生將在視圖轉換器中切換的兩個視圖的工廠。也可以調用兩次 addView(android.view.View, int, android.view.ViewGroup.LayoutParams)來替代使用工廠的方法。

　　參數

　　factory   用來產生轉換器內容的視圖工廠

 

　　六、補充

           文章精選

                   android UI ViewSwitcher的使用（續二）

             Android: Don’t Overlook ViewSwitcher

             Using a ViewSwitcher in your Android xml layouts