Java手機軟件圖形界面API之screen相關API

  看過一個關於screen的例子後，你應該會問起：你是如何來組織這些screen的？在它們之間是如何導航的？你是如何管理顯示及輸入設備的？回答是，所有的功能皆由Display類來實現，它提供了相應的方法用於把對象顯示在設備的屏幕上以及用於檢索設備的屬性等。

1. Display

一個指向設備的display的引用可以通過提供一個MIDlet引用給靜態方法getDisplay()而取得。

public static Display getDisplay(MIDlet c);
This is typically done in the startApp( ) method of a MIDlet, as follows:
public class MyMIDlet extends MIDlet {
Display display = null;
public MyMIDlet( ) {}
public void startApp( ) {
display = Display.getDisplay(this);
}
// 其它方法
}
提示:在調用MIDlet的startApp( )方法後，應該調用getDisplay( )方法，如前所述。但絕不應該從MIDlet的構造器內調用這個方法，正如每一本MIDP說明書上所述，因為應用程序管理器在這時可能還沒有完成它的初始化。

在你獲得一個對設備的顯示參考後，只需創建一個用於顯示的GUI組件即可。注意在圖 5-2所有的GUI組件都實現了抽象類Displayable。你可以傳遞你產生的GUI組件給Display的兩個setCurrent( )方法：

public void setCurrent(Displayable d);
public void setCurrent(Alert alert, Displayable d);
第二個方法用於顯示一個臨時的警告信息，後面跟著可顯示的GUI元素。後面我們再討論alert。

想確定當前在設備上顯示的內容，可以使用getCurrent()方法，它返回一個當前正顯示的Displayable對象的參考。

public Displayable getCurrent( );
而且，該Display類(其實際上是設備管理器)還提供方法用於查詢display以決定它支持的顏色數目：

public void boolean inColor( );
public int numColors( );
第一個方法isColor( )返回一個布爾值：true-如果設備支持彩色；false-如果僅支持灰度。numColors( )方法返回設備支持的不同顏色的整數序號。

2. Screen

如前所述，在用戶和設備之間交互的基本單元是screen，它是一個封裝了設備相關圖形用戶輸入接口的對象。如在圖1的類圖中所見，共有四類高層的screen：TextBox，List，Alert和Form。

圖1.包lcdui中的主要類間的類關系圖

     然而，Screen僅是一個有其自身一些功能的抽象類。每個Screen可以有兩個額外的特性：標題和ticker。標題是顯示在screen 內容之上的一個字符串。Ticker是一個圖形組件，它顯示在標題上方，可用於橫向卷動顯示給用戶的信息。二者皆是可選的，盡管標題串有一個缺省的內容。如果省略了ticker，則一點不顯示並把相應的空間讓給screen。後面我們要討論Ticker組件。但是，圖 2顯示了Screen 對象的標題和ticker 屬性之間的相對位置關系。

圖 2.屏幕上的標題和ticker

Screen 類的下列方法可以分別用於設置和檢索標題和ticker。

public void setTitle(String title);
public String getTitle( );
public void setTicker(Ticker ticker);
public Ticker getTicker( );
3. Ticker

Ticker類可用橫跨顯示區顯示一串連續的文本。它可以依附於一個或多個前面已述的screen上：Alert，TextBox，List和Form。可以用Ticker構造器創建一個ticker對象：

public Ticker(String str);
你可以用下面方法存取ticker中的文本串：

public String getString( );
public void setString(String s);
一旦生成一個ticker，就可以用該screen的setTicker( )方法把它依附於該screen。如，下列代碼生成一個List screen並把一個ticker依附於它：

Display display = Display.getDisplay( );
List list = new List("Trade Stocks", Choice.EXCLUSIVE);
list.append("Buy", null);
list.append("Sell", null);
list.setTicker(new Ticker("Welcome to my discount broker"));
display.setCurrent(list);
圖 3 顯示了ticker的外觀，它處於當前顯示的List組件的上方。

圖 3.一個ticker的例子

      在使用ticker時要注意以下幾點：

·沒有提供啟動和停止該ticker的方法函數。

·該ticker字符串連續卷動。也就是說，當該字符串在顯示屏上顯示結束，該ticker接著在該串的起始位置開始顯示。在串的結尾加上一些空格可能有助於使得字符串的顯示看上去不是連接在一起的。

·卷動的方向和速度由MIDP系統的實現來決定。

 4. TextBox

TextBox對象是一個允許用戶輸入和編輯文本的screen。在MIDlet程序需要用戶輸入諸如姓名，電話號碼，e-mail地址或者口令字時，你可以選用TextBox控件。你可以通過指定四個參數給TextBox的構造器來創建一個TextBox 對象：

public TextBox(String title, String text, int maxSize, int constraints);
title被復用作該screen的標題，參數text和maxSize用於指定初始(缺省的)文本和該文本框的最大尺寸。最後，constraints參數可用於限制用戶的輸入。Constraints取值為TextBox類的靜態常整型常量，由TextField和TextBox類共享使用，如下：

常量說明TextField.ANY允許用戶輸入任何字符TextField.EMAILADDR必須輸入一個e-mail地址TextField.NUMBER 必須輸入一個整型值TextField.PASSWD文本以*蒙蓋，因此輸入的文本是不可見的TextField.PHONENUMBER必須輸入一個電話號碼TextField.URL必須輸入一個URL地址
如果你給constraints的指定值不是TextField.ANY，系統將執行校驗以確保輸入滿足要求。

注意：約束值TextField.PASSWD可以和任何其它約束值值通過OR(|)運算符相結合。如，如果你要產生一個TextBox，並限制輸入為電話號碼，但又想隱藏輸入數據，可以如下創建對象：

TextBox t=new TextBox("Tel","",12,TextField.PHONENUMBER|TextField.PASSWD);
如果你想檢索當前活動的TextBox的約束值，可以如下：

public int getConstraints( );
public void setConstrants(int c);
另外應該指出的是，一個文本框有一個容量限定（即最大字符數）。但是，每一個MIDP系統實現都將對該最大容量設置一個邊界值，它可能比應用程序要求的尺寸要小。系統允許的最大尺寸可以用方法getMaxSize( )來檢索，也可應用方法setMaxSize( )來復位。

public int getMaxSize( );
public void setMaxSize(int size);
一個書寫良好的MIDP應用程序應該總是比較它要求的大小和當前的最大值。

在當前MIDP的來自於Sun Microsystems的參考實現中，getMaxSize( )方法總是返回MIDlet要求的尺寸。但是不要因此而放棄比較的習慣。
你還可以通過使用方法setString( )和getString( )來設置或者檢索TextBox對象的完整的文本：

public String getString( );
public void setString(String s);
另外，如果你要知道輸入的字符數，可以用方法size( )：

public int size( );
你還可以使用下列方法對文本框進行刪除，插入，替換等等：

public void delete(int offset, int length);
public void insert(char[] data, int offset, int length, int position);
public void insert(String src, int position);
public void setChars(char[] data, int offset, int length);
最後，要確定插入點位置，可以用下面方法：

public int getCaretPosition( );
下面的小例創建一個文本框，標簽為"TextBox"，初始文本值為"This is a text box"，最大尺寸為20個字符，可以輸入任何字符。

TextBox tb = new TextBox("TextBox", "This is a textbox", 20, TextField.ANY);
Display display = Display.getDisplay(this);
display.setCurrent(tb);
如果你寫一個完整的MIDlet程序並在模擬器中運行，會看到如圖 4所示的效果。注意，如果要顯示的文本長於一屏的，系統將允許用戶卷動查看並進行編輯-具體依賴於系統的實現。

圖 4.display和screen之間的關系<