范例说明
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"