Java ME MIDP GUI API：Form 與 Item 元件詳細說明

Form：容器畫面

Form 繼承 Screen，可包含任意 Item 子類元件，垂直排列 (類清單)，支援動態增刪改。

Form form = new Form("Choose an Item"); // 空表單
Form form2 = new Form("Title", new Item[] { item1, item2 }); // 帶初始項目

常用方法：append(Image/String/Item), delete(index), get(index), insert(index, Item), set(index, Item), size()。

Item 抽象基類

所有可放入 Form/Alert 的元件基類，提供 getLabel()/setLabel(String)。

ChoiceGroup：選項群組

• 實作 Choice 介面，類似 List 但放入 Form。
• 兩種模式：EXCLUSIVE (單選)、MULTIPLE (多選)。**無 IMPLICIT**。
• 建構子：ChoiceGroup(label, type) 或帶初始字串/圖示陣列。
• 操作方法同 List：append/insert/delete/set/getString/getImage, getSelectedIndex/isSelected/setSelectedIndex, getSelectedFlags/setSelectedFlags。
• **必須加入 Form 才能顯示**：form.append(choiceGroup)。

DateField：日期/時間輸入

• 三種模式：DATE, TIME, DATE_TIME。
• 建構子：DateField(label, mode) 或指定 TimeZone。
• 方法：getDate()/setDate(Date), getInputMode()/setInputMode(), toString()。

Gauge：進度條/條狀圖

• 建構子：Gauge(label, interactive, maxValue, initialValue)。
• interactive=true：用戶可編輯 (如音量控制)；false：唯讀進度顯示。
• 方法：getValue()/setValue(), getMaxValue()/setMaxValue()。

StringItem：唯讀文字

• 建構子：StringItem(label, text)。
• 外觀可設定字體、外觀模式 (PLAIN, HYPERLINK, BUTTON 等)。

TextField：可編輯文字欄位

• 功能類 TextBox 但放入 Form。
• 建構子：TextField(label, text, maxSize, constraints)。
• 約束條件同 TextBox (ANY, EMAILADDR, NUMBER, PASSWD, PHONENUMBER, URL)。

ImageItem：圖片元件

• 建構子：ImageItem(label, image, layout, altText)。
• layout 控制對齊 (LAYOUT_LEFT/CENTER/RIGHT/NEWLINE_BEFORE/AFTER...)。

完整 Form 範例

Form form = new Form("User Info");
form.append(new StringItem("Name:", "John Doe"));
form.append(new TextField("Email", "", 50, TextField.EMAILADDR));
form.append(new DateField("Birthday", DateField.DATE));
form.append(new ChoiceGroup("Gender", Choice.EXCLUSIVE,
    new String[]{"Male", "Female"}, null));
form.append(new Gauge("Volume", true, 100, 50));
display.setCurrent(form);