Java手机软件图形界面API之Form相关API

　4. DateField

　　一个DateField对象是一个可编辑的组件，它描述了可以显示在表单对象上的日历中的日期和时间信息。它可以用于显示日期或者时间信息，或者二者皆有。一个DateField对象可以用下面构造器创建：

public DateField(String label, int mode); public DateField(String label, int mode, TimeZone timeZone);

　　第一个构造器用于创建有指定的标签和模式的DateField对象。这种模式可以通过提供一个静态字段(DateField.DATE，DateField.TIME或者DateField.DATE_TIME)来指定。DateField.DATE输入模式允许你设置日期信息，DateField.TIME则用于设置时间信息(小时和分钟)，DateField.DATE_TIME用于设置日期和时间两种信息。

　　DateField对象用下列方法来存取加到表单对象上的属性(记住标签属性在抽象类Item 中定义):

public Date getDate( ) public int getInputMode( ) public void setDate(Date date); public void setInputMode(int mode);

　　而且，你可以用toString( )方法来输出一个基于字符串的date或者time数据的拷贝。

public String toString( );

　　作为一个例子，下面代码创建一个对象，标签是"Today’s date"，方式为DateField.DATE：

DateField date = new DateField("Today’s date", DateField.DATE);

　　为了显示一个date域，可先创建一个Form对象，然后使用它的方法append( )添加date域。

Form form = new Form("Date Info"); form.append(date); Display.setCurrent(form);

　　在这个例子中，既然选择了DATE输入方式，MIDlet将显示一个<date>项备用户选择，如图4示。一旦选择，它将显示当前的日历日期，你还可以设置一个新的日期。

图 4.一个描述日历上日期的date域

　　如果使用了DateField.TIME输入方式，MIDlet将会显示<time>项备用户选择，如图5示。一旦选择，它将显示当前的时间信息，同样你还可以设置一个新的时间。

图 5.描述时钟上时间信息的date域

　　最后，如果使用了DateField.DATE_TIME输入方式，MIDlet将会显示<date>和<time>项，并允许你做出选择。

　　注意在显示组件前你可以初始化日期和时间，可以用下面代码来实现：

d = new DateField("Today: ", DateField.DATE); d.setDate(new Date( )); form = new Form("Date & Time"); form.append(d); display.setCurrent(form);

　　到此，一个date可以显示当前的date和time，如下图6。

图 6.用DATE_TIME常数描述的日期域的情形

　　第二个DateField构造器用于创建一个日期域，同时指定它的标签，输入模式，和时间带信息.如，下面代码创建一个DateField对象，其时间带是GMT：

DateField date = new DateField("date", DateField.DATE, TimeZone.getTimeZone("GMT"));

　　如果TimeZone域取值null，则使用缺省的时间带(基于应用程序运行的时间带)。因而，下列两行代码作用一样：

DateField date1 = new DateField("date", DateField.DATE); DateField date2 = new DateField("date", DateField.DATE, TimeZone.getDefault( ));

　　TimeZone类是包java.util中的一部分，该包继承自J2SE。

　　5. Gauge

　　一个Gauge对象描述了一个可以使用在表单中的条形图。Gauge类的构造器如下：

public Gauge(String label, boolean interactive, int maxValue, int initialValue);

　　该构造器用于创建一新的Gauge对象，并给出标签，以交互或非交互方式，限定最大值并给出初始值。在交互方式下，允许用户修改Gauge的当前值；而在非交互方式下，不允许用户修改Gauge的值(正如你在一个进度条中所见的一样)。你可以用下面方法查询是否当前gauge处于非交互方式：

public boolean isInteractive( );

　　Gauge对象还提供下列方法以存取它的当前值和最大值属性：

public int getMaxValue( ); public int getValue( ); public void setMaxValue(int maxValue); public void setValue(int value);

　　Gauge对象将总是维持一个在零和指定的最大值之间的当前值。例如，下面的代码创建一个其最大值是20，初始值为0的交互式的gauge：

Gauge gauge = new Gauge("graph", true, 20, 0);

　　一旦创建Gauge 对象，就可以把它放到表单上去：

Form form = new Form("item"); form.append(gauge);

　　这个交互的gauge显示在图7中。注意gauge的样式是一个从右向左递增的弧形，正如你在一个LED volume控件所看到的。

图 7.一个交互式gauge的例子

　　如果该gauge用于反映进度，应用程序将保持更新它。在这种情况下，应用程序需要保持一个对它的参照并不断地调用方法setValue( )以反映最新的进度。

　　下面代码显示出一个非交互的gauge的例子，它反映了一个进度条：

Display display = Display.getDisplay(this); Gauge progressbar = new Gauge("Progress", false, 20, 9); Form form = new Form("Configuring App); form.append(progressbar);

　　进度条被显示在图8中。注意在此一个非交互的是从右到左水平方向的。

图 8.一个非交互的gauge，描述了一个进度条

　　6. Image和ImageItem

　　一个ImageItem对象是图像组件，它包含到一Image对象的参考。首先,简短让我们介绍一下Image类。当我们谈论关于低低API时，将再分析它。

　　Image类用于图形图像数据的容器。依赖于图像产生的方式，它们可以是不可改变的或者可改变的。不可改变的图像通常是通过从绑定的资源中装入数据或者文件中或者通过网络的方式创建的。一旦他们被创造，他们不能被修改。另一方面，可改变的图像在脱屏内存中创建，可以被修改。

　　放置于Alert，Form或ImageItem中的图像必须是，既然系统要在不通知应用程序的情况下使用它们来更新显示。另一方面，包含图像的Alert或者Form在每一次图形调用时必须被更新。

　　一可变的图像能被通过使用Image类的静态方法createImage( )创建。

public static Image createImage(int width, int height);

　　其它三个静态的createImage()方法用来创建不可改变的图像:

public static Image createImage(Image image); public static Image createImage(String name); public static Image createImage(byte[] imageData, int imageOffset, int imageLength);

　　下面的例子生成一幅源于图形文件的不可改变的图像：

Image image = Image.createImage("/Duke.png");

　　这样，该图像即可image以典型的方式放置到表单上去：

Form form = new Form("Duke"); form.append(image);

　　注意图形文件有扩展名png。这个缩略词代表便携式计算机网络图形。所有的MIDP实现均要求支持至少1.0版本的PNG图象。在该文中，没有讨论另外的图形格式化。另外,如果你在使用J2ME无线开发包的Ktoolbar应用程序提供的仿真器，注意对Duke的引用，使用了/duke.png，这意味着Duke在res目录c:\j2mewtk\apps\Myproject\res下。图 9描述了这个例子的结果。

图9.放置一个图像到表单上去

　　图像类提供一些方法用于返回图像的高度，宽度和可变状态：

public int getHeight( ); public int getWidth( ); public boolean isMutable( );

　　另外,如果图像是可变的，你可以使用下面方法取得图像的Graphics对象(当我们讨论低级图形API时，将更详细地讨论它)。

public Graphics getGraphics( );

　　现在,让我们看怎么使用ImageItem类，当Image对象被加到一个form或者alert上时该类用于控制并进行布局。为了创建一ImageItem对象，可以使用ImageItem 构造器:

public ImageItem(String label, Image img, int layout,String altText);

　　这个构造器被用于创建一个新的不可改变的ImageItem对象，同时指定一个标签，图像,布局指示及一个可选择的文本串。The altText参数指定用一个字符串来取代显示图像，如果它超过了显示屏的最大容量的话。layout参数 是下面值的一个组合，它们是ImageItem 类的静态字段成员：

　　ImageItem.LAYOUT_CENTER 图像应该放到水平中央位置

　　ImageItem.LAYOUT_DEFAULT 应该使用图像容器的默认格式化

　　ImageItem.LAYOUT_LEFT 图像应该放到绘制区域的左边缘

　　ImageItem.LAYOUT_NEWLINE_AFTER 在图像被绘制后应开始新的一行

　　ImageItem.LAYOUT_NEWLINE_BEFORE 在图像被绘制前应开始新的一行

　　ImageItem.LAYOUT_RIGHT 图像应该放到绘制区域的右边缘

　　关于如何组合使用上面的值有一些规则：

　　·ImageItem.LAYOUT_DEFAULT不能与任何其它指令相结合。

　　·ImageItem.LAYOUT_LEFT, ImageItem.LAYOUT_RIGHT和ImageItem.LAYOUT_CENTER是互相独占的。

　　·你能用ImageItem.LAYOUT_NEWLINE_AFTER和ImageItem.LAYOUT_NEWLINE_BEFORE结合ImageItem.LAYOUT_LEFT, ImageItem.LAYOUT_RIGHT和ImageItem.LAYOUT_CENTER。

　　提示：布局指示仅作为一种提示，但是它可以被系统所忽略。Sun的MIDP参考实现就是如此。

　　ImageItem 类也包含下列方法来存取刚才我们在构造器中看到的属性：

public String getAltText( ); public Image getImage( ); public int getLayout( ); public void setAltText(String altText); public void setImage(Image img); public void setLayout(int layout);

　　因此，为了创建一个ImageItem对象，你可以使用上面的ImageItem：

Image img = Image.createImage("/Duke.png"); ImageItem imageItem = new ImageItem("Image", img, ImageItem.LAYOUT_CENTER, "img"); Form form = new Form("Duke"); form.append(imageItem);

　　该例子产生一个很类似于图18的结果，除了这里的ImageItem 对象有一个标题。