范例说明
Android的Widget,有许多是为了与User交互而特别设计的,但也有部分是作为程序提示、显示程序运行状态的Widget。现在介绍的范例,与前一章介绍过的ProgressDialog对话框的应用目的相似,但由于前章介绍的ProgressDialog是继承自Android.app.ProgressDialog所设计的互动对话窗口,在应用时,必须新建ProgressDialog对象,在运行时会弹出“对话框”作为提醒,此时应用程序后台失去焦点,直到进程结束后,才会将控制权交给应用程序,如果在Activity当中不希望后台失焦,又希望提示User有某后台程序正处于忙碌阶段,此时,ProgressBar就会派上用场了。

Android提供的ProgressBar Widget控件与ProgressDialog应用目标不同,在程序一开始即可在main.xml Layout当中布局,先将部署在Layout里的ProgressBar的属性设为隐藏(一开始看不见),而后使用进程来“假装”程序忙碌中,但不同的是,可在进程当中取得运行时的进度,在“运行”的过程中,将运行进度通过TextView显示出来。本范例除了学习ProgressBar Widget的显示及使用之外,另一个学习关键则是Handler的使用,因为新起的进程无法访问Activity里的Widget,也无法将运行状态外送出来,所以需要通过Handler及Message对象,将进程里的状态往外传递,最后由Activity的Handler事件接收取得运行的状态。
范例程序
src/irdc.ex04_17/EX04_17.java
为了让Thread运行过程中,可以不断地将信息往Activity传递,所以用了Android.os.Handler对象及Android.os.Message对象,且在类成员变量中声明了两个整数:GUI_STOP_NOTIFIER与GUI_THREADING_NOTIFIER,这两个整数将作为信息传递出来时的信号标识,前者为当Thread需要喊停的时候处理,后者为进程正在运行过程中所需处理的标识。

程序中设计了一个按钮,此按钮的工作是让原本部署在main.xml里的ProgressBar显示出来(原来是设置为Android:visibility=”gone”),而因为默认在main.xml中没有指定它的indeterm- inate属性,所以即便在程序中强制调用了ProgressBar的setIndeterminate()方法,也无法改变ProgressBar.getProgress()的值,这个值将永远为0。因此,笔者想要使用循环图片动画作为运行过程中的动画,并用了一个Counter(整数)来递增,表示运行的百分比。范例说明
Android的Widget,有许多是为了与User交互而特别设计的,但也有部分是作为程序提示、显示程序运行状态的Widget。现在介绍的范例,与前一章介绍过的ProgressDialog对话框的应用目的相似,但由于前章介绍的ProgressDialog是继承自Android.app.ProgressDialog所设计的互动对话窗口,在应用时,必须新建ProgressDialog对象,在运行时会弹出“对话框”作为提醒,此时应用程序后台失去焦点,直到进程结束后,才会将控制权交给应用程序,如果在Activity当中不希望后台失焦,又希望提示User有某后台程序正处于忙碌阶段,此时,ProgressBar就会派上用场了。

Android提供的ProgressBar Widget控件与ProgressDialog应用目标不同,在程序一开始即可在main.xml Layout当中布局,先将部署在Layout里的ProgressBar的属性设为隐藏(一开始看不见),而后使用进程来“假装”程序忙碌中,但不同的是,可在进程当中取得运行时的进度,在“运行”的过程中,将运行进度通过TextView显示出来。本范例除了学习ProgressBar Widget的显示及使用之外,另一个学习关键则是Handler的使用,因为新起的进程无法访问Activity里的Widget,也无法将运行状态外送出来,所以需要通过Handler及Message对象,将进程里的状态往外传递,最后由Activity的Handler事件接收取得运行的状态。
范例程序
src/irdc.ex04_17/EX04_17.java
为了让Thread运行过程中,可以不断地将信息往Activity传递,所以用了Android.os.Handler对象及Android.os.Message对象,且在类成员变量中声明了两个整数:GUI_STOP_NOTIFIER与GUI_THREADING_NOTIFIER,这两个整数将作为信息传递出来时的信号标识,前者为当Thread需要喊停的时候处理,后者为进程正在运行过程中所需处理的标识。

程序中设计了一个按钮,此按钮的工作是让原本部署在main.xml里的ProgressBar显示出来(原来是设置为Android:visibility=”gone”),而因为默认在main.xml中没有指定它的indeterm- inate属性,所以即便在程序中强制调用了ProgressBar的setIndeterminate()方法,也无法改变ProgressBar.getProgress()的值,这个值将永远为0。因此,笔者想要使用循环图片动画作为运行过程中的动画,并用了一个Counter(整数)来递增,表示运行的百分比。

/* import程序略 */

public class EX04_17 extends Activity
{
  private TextView mTextView01;
  private Button mButton01;
  private ProgressBar mProgressBar01;
  public int intCounter=0;

  /* 自定义Handler信息代码,用以作为标识事件处理 */
  protected static final int GUI_STOP_NOTIFIER = 0x108;
  protected static final int GUI_THREADING_NOTIFIER = 0x109;

  /** Called when the activity is first created. */
  @Override
  public void onCreate(Bundle savedInstanceState)
  {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

    mButton01 = (Button)findViewById(R.id.myButton1); 
    mTextView01 = (TextView)findViewById(R.id.myTextView1);

    /* 设置ProgressBar widget对象 */
    mProgressBar01 = (ProgressBar)findViewById(R.id.myProgressBar1);

    /* 调用setIndeterminate方法赋值indeterminate模式为false */
    mProgressBar01.setIndeterminate(false);

    /* 当单击按钮后,开始进程工作 */
    mButton01.setOnClickListener(new Button.OnClickListener()
    {
      @Override
      public void onClick(View v)
      {
        // TODO Auto-generated method stub

        /* 单击按钮让ProgressBar显示 */
        mTextView01.setText(R.string.str_progress_start);

        /* 将隐藏的ProgressBar显示出来 */
        mProgressBar01.setVisibility(View.VISIBLE);

        /* 指定Progress为最多100 */
        mProgressBar01.setMax(100);

        /* 初始Progress为0 */
        mProgressBar01.setProgress(0);

        /* 开始一个进程 */
        new Thread(new Runnable()
        {
          public void run()
          {
            /* 默认0至9,共运行10次的循环语句 */
            for (int i=0;i<10;i++)
            {
              try
              {
                /* 成员变量,用以识别加载进度 */
                intCounter = (i+1)*20;
                /* 每运行一次循环,即暂停1秒 */
                Thread.sleep(1000);

                /* 当Thread运行5秒后显示运行结束 */
                if(i==4)
                {
                  /* 以Message对象,传递参数给Handler */
                  Message m = new Message();

                  /* 以what属性指定User自定义 */
                  m.what = EX04_17.GUI_STOP_NOTIFIER;
                  EX04_17.this.myMessageHandler.sendMessage(m);
                  break;
                }
                else
                {
                  Message m = new Message();
                  m.what = EX04_17.GUI_THREADING_NOTIFIER;
                  EX04_17.this.myMessageHandler.sendMessage(m);
                }
              }
              catch(Exception e)
              {
                e.printStackTrace();
              }
            }
          }
        }).start();
      }
    });
  }

  /* Handler构建之后,会监听传来的信息代码 */
  Handler myMessageHandler = new Handler()
  {
    // @Override 
    public void handleMessage(Message msg)
    { 
      switch (msg.what)
      { 
        /* 当取得标识为离开进程时所取得的信息 */
        case EX04_17.GUI_STOP_NOTIFIER:

          /* 显示运行终了 */
          mTextView01.setText(R.string.str_progress_done);

          /* 设置ProgressBar Widget为隐藏 */
          mProgressBar01.setVisibility(View.GONE);
          Thread.currentThread().interrupt();
          break;

        /* 当取得标识为持续在进程当中时所取得的信息 */
        case EX04_17.GUI_THREADING_NOTIFIER:
          if(!Thread.currentThread().isInterrupted())
          {
            mProgressBar01.setProgress(intCounter);
            /* 将显示进度显示于TextView当中 */
            mTextView01.setText
            (
              getResources().getText(R.string.str_progress_start)+
              "("+Integer.toString(intCounter)+"%)/n"+
              "Progress:"+
              Integer.toString(mProgressBar01.getProgress())+
              "/n"+"Indeterminate:"+
              Boolean.toString(mProgressBar01.isIndeterminate())
            );
          }
          break;
      } 
      super.handleMessage(msg); 
    }
  };
}

扩展学习
范例程序中,调用mProgressBar01.setIndeterminate(false),不显示背景进度Bar,若设置为mProgressBar01.setIndeterminate(true),也无法让默认的ProgressBar图片(转圈圈)有正确的进度提示,理由是默认的ProgressBar不支持indeterminate mode循环图片方式,所以即便setIn- determinate(true)也无法正确显示进度。在本程序中,为刻意写出作为对照练习,一般在未知“进度”的情况下,可改用文字的方式显示进度百分比,通过调用mProgressBar01.getProgress()取得运行进度值,显示在文字中。请将Layout里的ProgressBar Widget定义中,加上一个android: indeterminateOnly属性,指定其值为false,不显示后台进度Bar.
如下所示:

<ProgressBar
  android:id="@+id/myProgressBar1"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:max="100"
  android:progress="0"
  android:orientation="horizontal" 
  android:progressBarStyle=
  "@android:style/Widget.ProgressBar.Horizontal"
  android:indeterminateOnly="false"
  android:visibility="gone"
/>

ProgressBar除了上述关于Android:progressBarStyle的属性设置之外,笔者也调查了在线Android的源代码(http://source.android.com),一些原本Android所使用的progressBarStyleHori- zontal属性,除默认“圆形”的图片之外,还有其他的主题及方形图片Drawable模式可以使用。

<resources>
  <declare-styleable name="Theme">
  <!-- snip -->
  <attr name="progressBarStyleHorizontal" format="reference" />
</resources>

接下来看看,这段主题中的属性名称progressBarStyleHorizontal定义在frameworks/base/ core/res/res/values/ styles.xml里,如下所示:

<resources>
  <style name="Widget.ProgressBar.Horizontal">
    <item name="android:indeterminateOnly">false</item>
    <item name="android:progressDrawable">
      @android:drawable/progress_horizontal
    </item>
    <item name="android:indeterminateDrawable">
      @android:drawable/progress_indeterminate_horizontal
    </item>
    <item name="android:minHeight">20dip</item>
    <item name="android:maxHeight">20dip</item>
  </style>
</resources>

由此可见,如果想让Android使用其他样式的ProgressBar,可以在原本的Layout(main.xml)里添加以下两项属性,以观察运行过程中的图片变化。

android:progressDrawable="@android:drawable/progress_horizontal"
android:indeterminateDrawable=
"@android:drawable/progress_indeterminate_horizontal"