3.5 Form類及其組件

3.5.1 Form類介紹

TextBox、List、Alert類只能實(shí)現(xiàn)單一的功能，手機(jī)屏幕在某一時(shí)刻只能顯示一個(gè)對(duì)象，所以很多時(shí)候無法滿足人們對(duì)界面的設(shè)計(jì)，例如，【例3-5】中為了實(shí)現(xiàn)用戶名和密碼的校驗(yàn)不得不切換界面，如果可以在一個(gè)界面中同時(shí)輸入用戶名和密碼就會(huì)使程序和界面都簡化很多，F(xiàn)orm類的提出很大程度上解決了這個(gè)問題。Form為屏幕表單類，本身是高級(jí)屏幕類Screen的子類，可以作為setCurrent（）方法的參數(shù)直接被使用，但是Form中并沒有提供與用戶進(jìn)行交互的界面，它是通過在其中添加其他組件完成交互的，所添加的組件即是Item的子類，包括文本域、日期域、進(jìn)度條等共計(jì)8種。首先介紹Form類本身所提供的常用方法，如表3-11所示。

表3-11 Form類的常用方法

創(chuàng)建并使用Form對(duì)象：

Display display；
Form mainForm；
display=Display.getDisplay（this）；
mainForm=new Form（"屏幕表單及其組件"）；
display.setCurrent（mainForm）；

執(zhí)行效果如圖3-14所示。

3.5.2 StringItem字符串顯示類

StringItem類是包含一個(gè)字符串的表單組件，只用做顯示而不能編輯內(nèi)容，但通過程序代碼可以更改它的標(biāo)簽和文本內(nèi)容。StringItem類的常用方法如表3-12所示。

表3-12 StringItem類的常用方法

創(chuàng)建并使用StringItem對(duì)象：

StringItem si1=new StringItem（"StringItem組件","顯示字符串信息"）；
mainForm.append（si1）；

執(zhí)行效果如圖3-15所示。

StringItem類有兩個(gè)構(gòu)造函數(shù)，第2個(gè)構(gòu)造函數(shù)需要3個(gè)參數(shù)，除了標(biāo)題和內(nèi)容外還要給出外觀模式，在StringItem中一共定義了3種外觀模式。

Item.PLAIN：值為0，無特殊模式。

Item.HYPERLINK：值為1，顯示為超級(jí)鏈接。

Item.BUTTON：值為2，顯示為按鈕。

【例3-8】 添加和修改StringItem對(duì)象。

import javax.microedition.lcdui.*；
import javax.microedition.midlet.MIDlet；
import javax.microedition.midlet.MIDletStateChangeException；
public class mainMidlet extends MIDlet implements CommandListener {
    Display disp；
    Form form；
    StringItem si；
    Command cmd；
    public mainMidlet（） {
        disp=Display.getDisplay（this）；
        form=new Form（"StringItem實(shí)例"）；
        si=new StringItem（"內(nèi)容：","修改前"）；
        cmd=new Command（"修改文本",Command.OK,1）；
        form.append（si）；
        form.addCommand（cmd）；
        form.setCommandListener（this）；
    }
    protected void destroyApp（boolean arg0） throws MIDletStateChangeException {
    }
    protected void pauseApp（） {
    }
    protected void startApp（） throws MIDletStateChangeException {
    disp.setCurrent（form）；
    }
    public void commandAction（Command arg0, Displayable arg1） {
        if（cmd==arg0）
        {
             si.setText（"修改后"）；
        }
    }
}

執(zhí)行效果如圖3-16所示。

3.5.3 ImageItem圖像顯示類

ImageItem類能夠在Form中顯示圖片，從而實(shí)現(xiàn)比較豐富而復(fù)雜的顯示界面，其常用方法如表3-13所示。

表3-13 ImageItem類的常用方法

創(chuàng)建和使用ImageItem對(duì)象，要想創(chuàng)建ImageItem，首先需要?jiǎng)?chuàng)建Image對(duì)象。代碼格式為Image img=Image.createImage（“/xm.png”）；其中參數(shù)為圖像的路徑。導(dǎo)入圖像時(shí)要做異常處理，具體代碼如下：

Image img；
try {
      img=Image.createImage（"/xm.png"）；
    } catch （Exception e） {
    }
ImageItem ii=new ImageItem（"圖像",img,ImageItem.LAYOUT_CENTER,"文本"）；
mainForm.append（ii）；

執(zhí)行效果如圖3-17所示。

構(gòu)造函數(shù)中的第3個(gè)參數(shù)為ImageItem的布局樣式，ImageItem中共定義了6種布局樣式。

ImageItem.LAYOUT_DEFAULT：值為0，使用系統(tǒng)默認(rèn)的圖像布局。

ImageItem.LAYOUT_LEFT：值為1，圖像靠近繪圖區(qū)域的左邊緣。

ImageItem.LAYOUT_RIGHT：值為2，圖像靠近繪圖邊緣的右邊緣。

ImageItem.LAYOUT_CENTER：值為3，圖像位于繪圖區(qū)域的水平中間。

ImageItem.LAYOUT_NEWLINE_BEFORE：值為4，繪制圖像前開始新的一行。

ImageItem.LAYOUT_NEWLINE_AFTER：值為5，繪制圖像后開始新的一行。

【例3-9】 ImageItem實(shí)例。

import javax.microedition.lcdui.*；
import javax.microedition.midlet.MIDlet；
import javax.microedition.midlet.MIDletStateChangeException；
public class ImageItemTest extends MIDlet {
    Display disp；
    Form form；
    ImageItem ii1,ii2,ii3；
    Image img；
     public ImageItemTest（） {
         disp=Display.getDisplay（this）；
         form=new Form（"ImageItem實(shí)例"）；
         try {
         img=Image.createImage（"/_ack_8.png"）；
         } catch （Exception e） {
         }
         ii1=new ImageItem（"左對(duì)齊",img,ImageItem.LAYOUT_LEFT,""）；
         ii2=new ImageItem（"居中對(duì)齊",img,ImageItem.LAYOUT_CENTER,""）；
         ii3=new ImageItem（"右對(duì)齊",img,ImageItem.LAYOUT_RIGHT,""）；
         form.append（ii1）；
         form.append（ii2）；
         form.append（ii3）；
     }
     protected void destroyApp（boolean arg0） throws MIDletStateChangeException {
     }
     protected void pauseApp（） {
     }
     protected void startApp（） throws MIDletStateChangeException {
         disp.setCurrent（form）；
     }
}

執(zhí)行效果如圖3-18所示。

3.5.4 TextField文本域類

TextField為文本域類，主要用來輸入和顯示文本內(nèi)容，TextField類的常用方法如表3-14所示。

表3-14 TextField類的常用方法

創(chuàng)建并使用TextField對(duì)象：

TextField tf=new TextField （"任意字符", "初始字符",20,TextField.ANY）；

TextField的構(gòu)造函數(shù)與TextBox非常類似，第1個(gè)參數(shù)是標(biāo)簽文本，第2參數(shù)是初始時(shí)顯示的字符，第3個(gè)參數(shù)是能夠容納的最大字符數(shù)，最后一個(gè)參數(shù)是輸入的文本約束。

TextField和TextBox的區(qū)別是前者是Item的子類，不能直接被setCurrent方法調(diào)用，只能被添加到Form上才能被顯示在手機(jī)屏幕上，后者則是Screen類的子類，可以直接被setCurrent（）方法調(diào)用顯示，但是某一時(shí)刻只可以顯示一個(gè)TextBox對(duì)象。

這里首先利用TextField對(duì)象的特點(diǎn)修改一下【例3-5】，修改后的結(jié)果參見【例3-10】。

【例3-10】 TextField的用戶名和密碼驗(yàn)證。

import javax.microedition.lcdui.*；
import javax.microedition.midlet.*；
public class mainMidlet extends MIDlet implements CommandListener {
    Display display；
    Form form；
    TextField tfName,tfPwd；
    StringItem si；
     Command cmdEnter；
    public mainMidlet（） {
        display=Display.getDisplay（this）；
        form=new Form（"登錄界面"）；
        tfName=new TextField（"請(qǐng)輸入用戶名","",12,TextField.ANY）；
        tfPwd=new TextField（"請(qǐng)輸入密碼","",6,TextField.NUMERIC）；
        cmdEnter=new Command（"確定",Command.OK,1）；
        si=new StringItem（"",""）；
        form.append（tfName）；
        form.append（tfPwd）；
        form.addCommand（cmdEnter）；
        form.setCommandListener（this）；
    }
    protected void destroyApp（boolean arg0）throws MIDletStateChangeException{ }
    protected void pauseApp（） { }
    protected void startApp（） throws MIDletStateChangeException {
        display.setCurrent（form）；
    }
    public void commandAction（Command c, Displayable d） {
        if（c==cmdEnter ）
        {
             if（tfName.getString（）.equals（"abc"）&&tfPwd.getString（）. equals（"123"））
                 si.setText（"輸入正確"）；
             else
                 si.setText（"輸入錯(cuò)誤"）；
             form.deleteAll（）；
             form.append（si）；
        }
    }
}

執(zhí)行效果如圖3-19所示。

3.5.5 DateField日期域類

DateField為日期域類，主要用來輸入和顯示日期和時(shí)間。DateField類的常用方法如表3-15所示。

表3-15 DateField類的常用方法

創(chuàng)建并使用DateField對(duì)象：

DateField df=new DateField（"出生日期", DateField.DATE）；

DateField有兩個(gè)構(gòu)造函數(shù)，第1個(gè)構(gòu)造函數(shù)DateField（String label,int mode）使用指定的標(biāo)簽和輸入模式來構(gòu)建DateField對(duì)象，第2個(gè)構(gòu)造函數(shù)DateField（String label,int mode,TimeZone timeZone）則需要在指定標(biāo)簽和輸入模式的同時(shí)還指定時(shí)區(qū)，如果TimeZone的值為null，則使用系統(tǒng)默認(rèn)時(shí)區(qū)。

DateField類中共定義了3種輸入模式：DateField.DATE（日期）、DateField.TIME（時(shí)間）和DateField.DATE_TIME（日期加時(shí)間）。

構(gòu)造完成后，DateField還處于未初始化狀態(tài)，沒有具體的日期時(shí)間，可以使用setDate（Date date）方法為其設(shè)置初始值。

將DateField對(duì)象添加到Form對(duì)象中：

mainForm.append（df）；

執(zhí)行效果如圖3-20所示。

下面運(yùn)用DateField類來看看不同的輸入模式的表現(xiàn)有何不同，具體實(shí)現(xiàn)參見【例3-11】。

【例3-11】 DateField類的不同輸入模式。

import javax.microedition.midlet.*；
import javax.microedition.lcdui.*；
import java.util.Date；
public class DateFieldTest extends MIDlet implements CommandListener{
    private Form form；
    private List startmenu；
    private long date, time；
    //計(jì)算一天有多少毫秒
    private long dayInMillis=24*60*60*1000；
    private String choices[]={"DATE mode","TIME mode", "DATE_TIME mode"}；
    private Command backCommand = new Command（"Back", Command.BACK, 1）；
    private Command okCommand = new Command（"OK", Command.OK, 1）；
    private Command exitCommand = new Command（"EXIT", Command.EXIT, 1）；
    private Display display；
    public DateFieldTest（） {
       //創(chuàng)建List對(duì)象作為起始菜單
    startmenu= new List（"Chooise a input mode",List.IMPLICIT,choices,null）；
    startmenu.addCommand（exitCommand）；
    startmenu.setCommandListener（this）；
       //創(chuàng)建Form對(duì)象
       form= new Form（"DateField Test"）；
       DateField df=new DateField（"",DateField.DATE_TIME）；
       //System.currentTimeMillis（）表示系統(tǒng)的當(dāng)前時(shí)間
       time=System.currentTimeMillis（）%dayInMillis；
       date=System.currentTimeMillis（）-time；
       df.setDate（new Date（date+time））；
       form.append（df）；
       form.addCommand（okCommand）；
       form.addCommand（backCommand）；
       form.setCommandListener（this）；
       display=Display.getDisplay（this）；
    }
    public void startApp（） throws MIDletStateChangeException {
        display.setCurrent（startmenu）；
    }
    public void pauseApp（） {
    }
    public void destroyApp（boolean unconditional） {
       form=null；
       startmenu=null；
       backCommand = null；
       okCommand=null；
       exitCommand = null；
       display=null；
    }
    public void commandAction（Command c, Displayable d） {
       if（d==startmenu && c==List.SELECT_COMMAND） {
           //form.get（0）表示獲取form界面中的第一個(gè)組件
           DateField df= （DateField） form.get（0）；
           //保存設(shè)置的日期或時(shí)間
           if（df.getInputMode（）==DateField.DATE） {
               date=df.getDate（）.getTime（）；
           }
           else if（df.getInputMode（） == DateField.TIME） {
               time=df.getDate（）.getTime（）；
           }
           else {
               time=df.getDate（）.getTime（）%dayInMillis；
               date=df.getDate（）.getTime（）-time；
           }
           //設(shè)置時(shí)間和輸入模式
           df.setLabel（choices[startmenu.getSelectedIndex（）]）；
           switch（startmenu.getSelectedIndex（）） {
           case 0:
               df.setInputMode（DateField.DATE）；
               df.setDate（new Date（date））；
               break；
           case 1:
               df.setInputMode（DateField.TIME）；
               df.setDate（new Date（time））；
               break；
           case 2:
               df.setInputMode（DateField.DATE_TIME）；
               df.setDate（new Date（date+time））；
               break；
           }
           display.setCurrent（form）；
       }
       else if（d==form && c==okCommand） {
           DateField df= （DateField） form.get（0）；
       System.out.println（"Time set in millis: "+df.getDate（）.getTime（））；
         }
         else if（c==backCommand） {
             display.setCurrent（startmenu）；
         }
         else if（c==exitCommand） {
             destroyApp（true）；
             notifyDestroyed（）；
         }
    }
}

執(zhí)行效果如圖3-21所示。

3.5.6 Gauge類圖形標(biāo)尺

Gauge類實(shí)現(xiàn)了一個(gè)圖像標(biāo)尺，通常被用來表示一個(gè)過程的進(jìn)展情況，例如進(jìn)度條、音量調(diào)節(jié)界面等。Gauge類的常用方法如表3-16所示。

表3-16 Gauge類的常用方法

創(chuàng)建并使用Gauge對(duì)象：

Gauge gauge=new Gauge（"圖形標(biāo)尺",true,5,0）；

Gauge只有一個(gè)構(gòu)造方法，其中第1個(gè)參數(shù)為圖形標(biāo)尺的標(biāo)簽，可以設(shè)置為null，第2個(gè)參數(shù)表示是否允許用戶交互，第3個(gè)參數(shù)表示標(biāo)尺的最大值，必須大于0，第4個(gè)參數(shù)表示標(biāo)尺的初始值。

將Gauge對(duì)象添加到Form界面中：

gauge.setLayout（Item.LAYOUT_CENTER）；//設(shè)置布局模式居中
mainForm.append（gauge）；

如果是否允許交互值為true，則執(zhí)行效果如圖3-22（a）所示；如果為false，則效果如圖3-22（b）所示。

Gauge類的完整實(shí)例程序參見【例3-12】。

【例3-12】 Gauge類對(duì)象的應(yīng)用。

import javax.microedition.midlet.*；
import javax.microedition.lcdui.*；
public class GaugeTest extends MIDlet implements CommandListener{
    private Form form；
    private List startmenu；
    private String choices[]={"Interactive Gauge","Non-interactive Gauge"}；
    private Command backCommand = new Command（"Back", Command.BACK, 1）；
    private Command exitCommand = new Command（"EXIT", Command.EXIT, 1）；
    private Display display；
    public GaugeTest（） {
    startmenu= new List（"Chooise a Gauge type",List.IMPLICIT,choices,null）；
    startmenu.addCommand（exitCommand）；
    startmenu.setCommandListener（this）；
        form= new Form（"Gauge Test"）；
        form.addCommand（backCommand）；
        form.setCommandListener（this）；
        display=Display.getDisplay（this）；
    }
    public void startApp（） throws MIDletStateChangeException {
        display.setCurrent（startmenu）；
    }
    public void pauseApp（） {
    }
    public void destroyApp（boolean unconditional） {
        form=null；
        startmenu=null；
        backCommand = null；
        exitCommand = null；
        display=null；
    }
    public void commandAction（Command c, Displayable d） {
        if（d==startmenu && c==List.SELECT_COMMAND） {
            if（form.size（）>0） form.delete（0）；
            if（startmenu.getSelectedIndex（）==0） {
               form.append（new Gauge（"Interactive Gauge",true,10,4））；
            }
            else {
            form.append（new Gauge（"Non-interactive Gauge",false,10,4））；
            }
            display.setCurrent（form）；
    }
        else if（c==backCommand） {
            display.setCurrent（startmenu）；
        }
        else if（c==exitCommand） {
            destroyApp（true）；
            notifyDestroyed（）；
        }
    }
}

執(zhí)行效果如圖3-23所示。

3.5.7 Spacer類

Spacer類是MIDP 2.0中特有的不可見組件，通常是提供其他組件之間的垂直和水平間隔，用于定位。Spacer類的常用方法如表3-17所示。

表3-17 Spacer類的常用方法

創(chuàng)建和使用Spacer對(duì)象：

Spacer sp=new Spacer（30,30）；
mainForm.append（sp）；

效果如圖3-24所示，其中（a）為未使用Spacer組件效果，（b）為使用Spacer組件效果。

3.5.8 CustomItem類自定義組件

已有的高級(jí)屏幕類組件并不能滿足開發(fā)者對(duì)界面的要求，所以在MIDP 2.0中引入了CustomItem自定義組件類實(shí)現(xiàn)像素級(jí)別的繪制和內(nèi)部事件的處理。

CustomItem類為抽象類，在實(shí)際運(yùn)用時(shí)需要派生一個(gè)CustomItem的子類，在子類中通過實(shí)現(xiàn)CustomItem的抽象方法及定義自己的方法來完善實(shí)際的功能，從而繪制較復(fù)雜的畫面，這些與普通的Item類略有不同。CustomItem類的常用方法如表3-18所示。

表3-18 CustomItem類的常用方法

CustomItem的功能介于高級(jí)和低級(jí)之間的用戶界面，它既可以添加到Form中，也可以擴(kuò)展為圖像用戶界面，通過實(shí)現(xiàn)一系列抽象方來繪制具體的圖形。實(shí)現(xiàn)自定義界面的代碼參見【例3-13】。

【例3-13】 利用CustomItem類繪制自定義表格。

（1）建立MIDlet類。

import javax.microedition.lcdui.*；
import javax.microedition.midlet.*；
public class CustomMidlet extends MIDlet {
     Display display；
     Form mainForm；
     MyCustomItem custom；
    public CustomMidlet（） {
        display=Display.getDisplay（this）；
        mainForm=new Form（"自定義組件"）；
        custom=new MyCustomItem（"表格"）；
        mainForm.append（custom）；
    }
    protected void destroyApp（boolean arg0） throws MIDletStateChange Exception { }
    protected void pauseApp（） { }
    protected void startApp（） throws MIDletStateChangeException {
        display.setCurrent（mainForm）；
    }
}

（2）MyCustomItem類的基本框架。

import javax.microedition.lcdui.*；
public class MyCustomItem extends CustomItem {
    public MyCustomItem（String label） {
        super（label）；
    }
    protected int getMinContentHeight（） {
        return 0；
    }
    protected int getMinContentWidth（） {
        return 0；
    }
    protected int getPrefContentHeight（int arg0） {
        return 200；
    }
    protected int getPrefContentWidth（int arg0） {
        return 200；
    }
    protected void paint（Graphics arg0, int arg1, int arg2） {
        for（int i=0；i<=5；i++）
        { arg0.drawLine（0, i*20, 100, i*20）；
          arg0.drawLine（i*20, 0, i*20, 100）；
        }
    }
}

（3）執(zhí)行效果如圖3-25所示。