Java手機軟件圖形界面API之Form相關API – JAVA編程語言程序開發技術文章

除瞭基於屏幕的組件外,你還應該掌握使用表單把多個組件組織到一個屏幕上去。這一部分將討論Form類和可以放置到表單上去的組件。

   1. Form

  一個表單對象是一個screen,它可以包含任意的項,包括隻讀的和可編輯的文本框,圖像,日期域,gauge以及選項組組件。前面已提到,任何Item類的子類都可以放置到表單對象上去。Form類的構造器如下:

public Form(String title);
public Form(String title, Item[] items);

  第一個構造器創建一個空的表單,僅有一個標題。第二個構造器創建一個含有標題和初始內容的表單。如,下面的程序創建一個空的表單,其標題是”Choose an Item”,見圖1。這是一個常規的屏幕。


圖 1.一個空的form

Form form = new Form(“Choose an Item”);
  Form對象並不使用任何佈局管理器。代之的是,Form對象將象一個列表一樣安排它的組件,通常是從頂到底。就象一個列表中的選項,表單中的各個項可以進行編輯,如插入,添加和刪除。Form類的方法列舉如下。

  把一個圖像加到表單的結尾,可以用:

public int append(Image img);
  下面方法添加一個Item 的子類化對象到表單的結尾:

public int append(Item item);
  下面方法添加一個字符串到表單的結尾:

public int append(String str);
  下面方法刪除表單上在給定位置的項,同時改變表單的大小:

public void delete(int itemNum);
  你可以使用下面方法存取表單上的任何項,而表單內容保持不變。

public Item get(int itemNum);
  下面方法在表單上插入一項,插在指定索引的前面:

public void insert(int itemNum, Item item);
  下面方法替換表單上的前一項:

public int set(int itemNum, Item item);
  最後,你可用下面size( )方法來查找表單上的項的當前序號:

public int size( );
  可以放置到一個表單上去的GUI組件有:ChoiceGroup,DateField,Gauge,ImageItem,StringItem和TextField。所有這些都是抽象類Item 的子類。稍後,我們將看到如何把這些項放置到屏幕上去。首先讓我們依次作一下介紹。

  2. Item

  Item抽象類用作可以放置到表單或者alert上的組件的基類。所有的Item對象都有一個標簽(如有一個字符串依附到其上),這可以用下面方法存取:

public String getLabel( );
public void setLabel(String s);

  該抽象類僅有這兩個方法。

  3. ChoiceGroup

  ChoiceGroup對象描述瞭一組放置在表單上的可選擇的選項。類似於List類,它也實現瞭Choice接口,而且還繼承瞭Item抽象類。該對象可以指明選擇一項,或者進行多個選擇。ChoiceGroup類構造器如下:

public ChoiceGroup(String label, int choiceType);
public ChoiceGroup(String label, int choiceType,String[] stringElements, Image[] imageElements);

  第一個構造器創建一個空的ChoiceGroup組件,同時指明其標簽和類型。既然該類實現瞭接口Choice,你可能想到應該有三種選擇。但是,在使用一個ChoiceGroup組件時,隻有兩個選項可用: EXCLUSIVE和MULTIPLE。IMPLICIT類型不適用於ChoiceGroup,就象對於List組件一樣。在一個表單中不需要有一個象菜單的選項域(記住EXCLUSIVE方式隻允許一次選擇一項;MULTIPLE方式則允許一次選擇多個項)。

  第二個ChoiceGroup構造器用於創建一個新的ChoiceGroup對象,同時指明其標簽和類型,還有一個字符串數組和一個圖像數組來設置它的初始值。

  一旦你創建一個空的選擇,你就可以插入,添加或替換其中的選項,就象在一個List組件上一樣。而且,每一個選項有一個整數索引值來代表其在列表中的位置。第一個選項從0開始,最後一項索引值是該列表的最大長度減1。ChoiceGroup 類提供瞭下面方法來完成這些操作。

public int append(String stringElement, Image imageElement);
public void insert(int index, String stringElement, Image imageElement);
public void set(int index, String stringElement, Image imageElement);

  註意一個選項由一個字符串和一個可選的圖像組成。如,下面代碼演示瞭如何添加幾個選項到前述的列表中。註意,方法append( )返回一個索引值(正是我們創建該項時指定給它的),以備後面之用。

int saveIndex = list.append(“save”, null);
int deleteIndex = list.append(“delete”, null);

  而且,你可以用下面方法從該選項組中刪除任何索引:

public void delete(int index);
  如果你想檢索任何索引指定的串元素或圖像元素,可用下面方法:

public String getString(int index);
public Image getImage(int index);

  如果你想設置,取消設置,檢索當前選項組中選擇的索引,或者查詢任何索引以確定它是否為當前選定的項,可以用下面方法:

public int getSelectedIndex( )
public boolean isSelected(int index);
public setSelectedIndex(int index, boolean selected);

  最後,就象操作List組件一樣,你可以使用一個佈爾選項標志數組為設置整個選項組的選擇狀態。註意,getSelectedFlags( )方法並不返回一個佈爾數組,而是修改一個已傳入的佈爾數組(並作為一種優化技術,返回以整數形式表示的被選取的元素的序號)。該數組的長度至少要等於該列表中元素數目,如果還長一些,其餘的數組元素值被置為false。

public int getSelectedFlags(boolean[] selectedArray);
public void setSelectedFlags(boolean[] selectedArray);

  對於MULTIPLE型的列表,setSelectedFlags( )用於設置在列表中每個元素的狀態。對於EXCLUSIVE型的列表,佈爾數組中隻有一項可為true;如果沒有為true的元素,則第一個元素被選中。如果有兩個或者多個元素為true,系統選擇第一個為true的元素並選擇之。
下面語句創建一個新的空ChoiceGroup對象,其標題為”Selection”,類型為EXCLUSIVE:

ChoiceGroup choices = new ChoiceGroup(“Method of payment”, Choice.EXCLUSIVE);
  下面代碼把幾個新的選項添加到選擇組上。

choices.append(“Visa”, null);
choices.append(“Master Card”, null);
choices.append(“Amex”, null);

  類似於一個列表中的選項,在一個選項組中的項可以用插入,添加,刪除等方法進行編輯。而且,每一個選項被其索引值所參照。如,下面一句可刪除最後一項:

choices.delete(2);
  特別註意,一旦一個選項組被創建並投入使用,你不可能象操作列表一樣,用setCurrent( )方法來顯示之。一個選項組是Item的子類,必須放置到表單上去,表單對象是可用方法setCurrent( )顯示的。

Form form = new Form(“Choose one”);
form.append(choices);
Display.setCurrent(form);

  圖 2展示瞭一種EXCLUSIVE型的選項組,圖3 展示瞭一種MULTIPLE型的選項組。註意,IMPLICIT值對於ChoiceGroup類是不可用的;如果使用之,將顯示一個IllegalArgumentException異常。


圖2.一種互斥的選項組 圖3.有多個選項的選項組
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); <B

發佈留言