progressobserver.java

手机记事本程序

/*
 * Created on 2005-2-26
 *
 * 进度条与线程模型
 */
package com.favo.ui;

import javax.microedition.lcdui.Display;

/**
 * @author Favo
 * 
 * 这是仿照Smart Ticket制作的进度条观察者，这个模型的优点是
 * 1，低耦合度。你可以通过Form,Canvas等来实现这个接口
 * 2，可中断任务的支持。是通过在内部设置flag来实现的，后台线程可以
 * 通过查询这个flag从而知道用户是否中断过Task
 */
public interface ProgressObserver {
	/**
	 * 将进度条复位,主要为了重复利用进度条
	 */
	public void reset();
	
	/**
	 * 将进度条的值为设置最大
	 */
	public void setMax();

	/**
	 * 将自己绘制在屏幕上，如果进度条要开启自身的线程用于自动更新画面， 
	 * 也在这里构造并开启绘画线程（常用于动画滚动条）
	 */
	public void show(Display display);

	
	/**
	 * 如果进度条曾经开启自身的线程用于自动更新画面,（常用于动画滚动条），在这里关闭动画线程
	 * 如果没有请忽略此方法
	 */
	public void exit();

	/**
	 * 更新进度条，参数任意
	 */
	public void updateProgress(Object param1);

	/**
	 * 查询进度条是否可以暂停
	 */
	public boolean isStoppable();

	/**
	 * 设置进度条是否可以暂停
	 * @param stoppable
	 */
	public void setStoppable(boolean stoppable);

	/**
	 * 查询用户是否暂停了任务
	 * @return
	 */
	public boolean isStopped();
	
	/**
	 * 设置任务暂停标记
	 */
	public void setStopped(boolean stopped);

	/**
	 * 设置标题
	 */
	public void setTitle(String title);

	/**
	 * 设置提示
	 */
	public void setPrompt(String prompt);
	
	/**
	 * 设置是否取消Task时回调的函数对象
	 * @param co
	 */
	public void setCancelalbeObject(Cancelable co);
}