Posted on 2007-06-04 11:52
my 閱讀(317)
評論(0) 編輯 收藏 所屬分類:
手機相關(guān)
除了基于屏幕的組件外,你還應(yīng)該掌握使用表單把多個組件組織到一個屏幕上去。這一部分將討論Form類和可以放置到表單上去的組件。
1. Form
一個表單對象是一個screen,它可以包含任意的項,包括只讀的和可編輯的文本框,圖像,日期域,gauge以及選項組組件。前面已提到,任何Item類的子類都可以放置到表單對象上去。Form類的構(gòu)造器如下:
public Form(String title);
public Form(String title, Item[] items);
第一個構(gòu)造器創(chuàng)建一個空的表單,僅有一個標(biāo)題。第二個構(gòu)造器創(chuàng)建一個含有標(biāo)題和初始內(nèi)容的表單。如,下面的程序創(chuàng)建一個空的表單,其標(biāo)題是"Choose an Item",
Form form = new Form("Choose an Item");
Form對象并不使用任何布局管理器。代之的是,F(xiàn)orm對象將象一個列表一樣安排它的組件,通常是從頂?shù)降住>拖笠粋€列表中的選項,表單中的各個項可以進(jìn)行編輯,如插入,添加和刪除。Form類的方法列舉如下。
把一個圖像加到表單的結(jié)尾,可以用:
public int append(Image img);
下面方法添加一個Item 的子類化對象到表單的結(jié)尾:
public int append(Item item);
下面方法添加一個字符串到表單的結(jié)尾:
public int append(String str);
下面方法刪除表單上在給定位置的項,同時改變表單的大小:
public void delete(int itemNum);
你可以使用下面方法存取表單上的任何項,而表單內(nèi)容保持不變。
public Item get(int itemNum);
下面方法在表單上插入一項,插在指定索引的前面:
public void insert(int itemNum, Item item);
下面方法替換表單上的前一項:
public int set(int itemNum, Item item);
最后,你可用下面size( )方法來查找表單上的項的當(dāng)前序號:
public int size( );
可以放置到一個表單上去的GUI組件有:ChoiceGroup,DateField,Gauge,ImageItem,StringItem和TextField。所有這些都是抽象類Item 的子類。稍后,我們將看到如何把這些項放置到屏幕上去。首先讓我們依次作一下介紹。
2. Item
Item抽象類用作可以放置到表單或者alert上的組件的基類。所有的Item對象都有一個標(biāo)簽(如有一個字符串依附到其上),這可以用下面方法存取:
public String getLabel( );
public void setLabel(String s);
該抽象類僅有這兩個方法。
3. ChoiceGroup
ChoiceGroup對象描述了一組放置在表單上的可選擇的選項。類似于List類,它也實現(xiàn)了Choice接口,而且還繼承了Item抽象類。該對象可以指明選擇一項,或者進(jìn)行多個選擇。ChoiceGroup類構(gòu)造器如下:
public ChoiceGroup(String label, int choiceType);
public ChoiceGroup(String label, int choiceType,String[] stringElements, Image[] imageElements);
第一個構(gòu)造器創(chuàng)建一個空的ChoiceGroup組件,同時指明其標(biāo)簽和類型。既然該類實現(xiàn)了接口Choice,你可能想到應(yīng)該有三種選擇。但是,在使用一個ChoiceGroup組件時,只有兩個選項可用: EXCLUSIVE和MULTIPLE。IMPLICIT類型不適用于ChoiceGroup,就象對于List組件一樣。在一個表單中不需要有一個象菜單的選項域(記住EXCLUSIVE方式只允許一次選擇一項;MULTIPLE方式則允許一次選擇多個項)。
第二個ChoiceGroup構(gòu)造器用于創(chuàng)建一個新的ChoiceGroup對象,同時指明其標(biāo)簽和類型,還有一個字符串?dāng)?shù)組和一個圖像數(shù)組來設(shè)置它的初始值。
一旦你創(chuàng)建一個空的選擇,你就可以插入,添加或替換其中的選項,就象在一個List組件上一樣。而且,每一個選項有一個整數(shù)索引值來代表其在列表中的位置。第一個選項從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( )返回一個索引值(正是我們創(chuàng)建該項時指定給它的),以備后面之用。
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);
如果你想設(shè)置,取消設(shè)置,檢索當(dāng)前選項組中選擇的索引,或者查詢?nèi)魏嗡饕源_定它是否為當(dāng)前選定的項,可以用下面方法:
public int getSelectedIndex( )
public boolean isSelected(int index);
public setSelectedIndex(int index, boolean selected);
最后,就象操作List組件一樣,你可以使用一個布爾選項標(biāo)志數(shù)組為設(shè)置整個選項組的選擇狀態(tài)。注意,getSelectedFlags( )方法并不返回一個布爾數(shù)組,而是修改一個已傳入的布爾數(shù)組(并作為一種優(yōu)化技術(shù),返回以整數(shù)形式表示的被選取的元素的序號)。該數(shù)組的長度至少要等于該列表中元素數(shù)目,如果還長一些,其余的數(shù)組元素值被置為false。
public int getSelectedFlags(boolean[] selectedArray);
public void setSelectedFlags(boolean[] selectedArray);
對于MULTIPLE型的列表,setSelectedFlags( )用于設(shè)置在列表中每個元素的狀態(tài)。對于EXCLUSIVE型的列表,布爾數(shù)組中只有一項可為true;如果沒有為true的元素,則第一個元素被選中。如果有兩個或者多個元素為true,系統(tǒng)選擇第一個為true的元素并選擇之。
下面語句創(chuàng)建一個新的空ChoiceGroup對象,其標(biāo)題為"Selection",類型為EXCLUSIVE:
ChoiceGroup choices = new ChoiceGroup("Method of payment", Choice.EXCLUSIVE);
下面代碼把幾個新的選項添加到選擇組上。
choices.append("Visa", null);
choices.append("Master Card", null);
choices.append("Amex", null);
類似于一個列表中的選項,在一個選項組中的項可以用插入,添加,刪除等方法進(jìn)行編輯。而且,每一個選項被其索引值所參照。如,下面一句可刪除最后一項:
choices.delete(2);
特別注意,一旦一個選項組被創(chuàng)建并投入使用,你不可能象操作列表一樣,用setCurrent( )方法來顯示之。一個選項組是Item的子類,必須放置到表單上去,表單對象是可用方法setCurrent( )顯示的。
Form form = new Form("Choose one");
form.append(choices);
Display.setCurrent(form);