類 List
java.lang.Object
java.awt.Component
java.awt.List
所有已實現的接口：
ImageObserver, ItemSelectable, MenuContainer, Serializable, Accessible
--------------------------------------------------------------------------------
public class Listextends Componentimplements ItemSelectable, AccessibleList 組件為用戶提供了壹個可滾動的文本項列表。可設置此 list，使其允許用戶進行單項或多項選擇。
例如以下代碼：
--------------------------------------------------------------------------------
List lst = new List(4, false);
lst.add("Mercury");
lst.add("Venus");
lst.add("Earth");
lst.add("JavaSoft");
lst.add("Mars");
lst.add("Jupiter");
lst.add("Saturn");
lst.add("Uranus");
lst.add("Neptune");
lst.add("Pluto");
cnt.add(lst);
--------------------------------------------------------------------------------
當 cnt 為容器時，將生成以下滾動列表：
如果 List 允許進行多項選擇，則單擊已選中的項時，將取消選中該項。在上面的示例中，壹次只能從滾動列表中選擇壹項，因為創建新的滾動列表時，第二個參數為 false。如果 List 不允許進行多項選擇，則選擇某壹項會導致其他選中的項取消選中。
註意，本示例中顯示的列表是用四個可視行創建的。創建該列表之後，不可更改可視行的數量。默認的 List 是用四行創建的，所以 lst = new List() 與 list = new List(4, false) 等效。
從 Java 1.1 開始，AWT（Abstract Window Toolkit，抽象窗口工具包）會把列表上發生的所有鼠標、鍵盤和焦點事件發送給 List 對象。（維護舊的 AWT 事件模型的目的是為了向後兼容，不推薦使用它。）
當用戶選中或取消選中某項時，AWT 將向列表發送壹個 ItemEvent 實例。當用戶雙擊滾動列表中的某壹項時，AWT 會在緊隨項事件後向列表發送壹個 ActionEvent 實例。當用戶選中列表中的某項，按下 return 鍵時，AWT 也會生成壹個動作事件。
如果應用程序需要基於此列表中用戶選中或激活的項執行某個動作，則應該相應地實現 ItemListener 或 ActionListener，並註冊新的偵聽器，以便在此列表中接收事件。
對於多項選擇滾動列表，使用外部動作（如單擊按鈕）來觸發動作被認為是壹種更好的用戶界面。
從以下版本開始：
JDK1.0
另請參見：
ItemEvent, ItemListener, ActionEvent, ActionListener, 序列化表格
--------------------------------------------------------------------------------
嵌套類摘要
protected class List.AccessibleAWTList
此類實現 List 類的可訪問性支持。
從類 java.awt.Component 繼承的嵌套類/接口
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
字段摘要
從類 java.awt.Component 繼承的字段
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
從接口 java.awt.image.ImageObserver 繼承的字段
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
構造方法摘要
List()
創建新的滾動列表。
List(int rows)
創建壹個用指定可視行數初始化的新滾動列表。
List(int rows, boolean multipleMode)
創建壹個初始化為顯示指定行數的新滾動列表。
方法摘要
void add(String item)
向滾動列表的末尾添加指定的項。
void add(String item, int index)
向滾動列表中索引指示的位置添加指定的項。
void addActionListener(ActionListener l)
添加指定的動作偵聽器以從此列表接收動作事件。
void addItem(String item)
已過時。 由 add(String) 取代。
void addItem(String item, int index)
已過時。 由 add(String, int) 取代。
void addItemListener(ItemListener l)
添加指定的項偵聽器以接收此列表的項事件。
void addNotify()
創建列表的同位體。
boolean allowsMultipleSelections()
已過時。 從 JDK version 1.1 開始，由 isMultipleMode() 取代。
void clear()
已過時。 從 JDK version 1.1 開始，由 removeAll() 取代。
int countItems()
已過時。 從 JDK version 1.1 開始，由 getItemCount() 取代。
void delItem(int position)
已過時。 由 remove(String) 和 remove(int) 取代。
void delItems(int start, int end)
已過時。 從 JDK version 1.1 開始，後來不再公開使用。只希望作為包私有方法時保留此方法。
void deselect(int index)
取消選擇指定索引處的項。
AccessibleContext getAccessibleContext()
獲取與此 List 關聯的 AccessibleContext。
ActionListener[] getActionListeners()
返回已在此列表上註冊的所有動作偵聽器的數組。
String getItem(int index)
獲取與指定索引關聯的項。
int getItemCount()
獲取列表中的項數。
ItemListener[] getItemListeners()
返回已在此列表上註冊的所有項偵聽器的數組。
String[] getItems()
獲取列表中的項。
<T extends EventListener>
T[]
getListeners(Class<T> listenerType)
返回目前已在此 List 上註冊為 FooListener 的所有對象的數組。
Dimension getMinimumSize()
確定此滾動列表的最小大小。
Dimension getMinimumSize(int rows)
獲取具有指定行數的列表的最少維數。
Dimension getPreferredSize()
獲取此滾動列表的首選大小。
Dimension getPreferredSize(int rows)
獲取具有指定行數的列表的首選維數。
int getRows()
獲取此列表中的可視行數。
int getSelectedIndex()
獲取列表中選中項的索引。
int[] getSelectedIndexes()
獲取列表中選中的索引。
String getSelectedItem()
獲取此滾動列表中選中的項。
String[] getSelectedItems()
獲取此滾動列表中選中的項。
Object[] getSelectedObjects()
獲取對象數組中此滾動列表的選中項。
int getVisibleIndex()
獲取上次由 makeVisible 方法使其可視的項的索引。
boolean isIndexSelected(int index)
確定是否已選中此滾動列表中的指定項。
boolean isMultipleMode()
確定此列表是否允許進行多項選擇。
boolean isSelected(int index)
已過時。 從 JDK version 1.1 開始，由 isIndexSelected(int) 取代。
void makeVisible(int index)
使指定索引處的項可視。
Dimension minimumSize()
已過時。 從 JDK version 1.1 開始，由 getMinimumSize() 取代。
Dimension minimumSize(int rows)
已過時。 從 JDK version 1.1 開始，由 getMinimumSize(int) 取代。
protected String paramString()
返回表示此滾動列表狀態的參數字符串。
Dimension preferredSize()
已過時。 從 JDK version 1.1 開始，由 getPreferredSize() 取代。
Dimension preferredSize(int rows)
已過時。 從 JDK version 1.1 開始，由 getPreferredSize(int) 取代。
protected void processActionEvent(ActionEvent e)
處理發生在此列表上的動作事件，方法是將這些事件指派給所有已註冊的 ActionListener 對象。
protected void processEvent(AWTEvent e)
此滾動列表的進程事件。
protected void processItemEvent(ItemEvent e)
處理發生在此列表上的項事件，方法是將這些事件指派給所有已註冊的 ItemListener 對象。
void remove(int position)
從此滾動列表中移除指定位置處的項。
void remove(String item)
從列表中移除項的第壹次出現。
void removeActionListener(ActionListener l)
移除指定的動作偵聽器，以便不再從此列表接收動作事件。
void removeAll()
從此列表中移除所有項。
void removeItemListener(ItemListener l)
移除指定的項偵聽器，以便不再從此列表接收項事件。
void removeNotify()
移除此列表的同位體。
void replaceItem(String newValue, int index)
使用新字符串替換滾動列表中指定索引處的項。
void select(int index)
選擇滾動列表中指定索引處的項。
void setMultipleMode(boolean b)
設置確定此列表是否允許進行多項選擇的標誌。
void setMultipleSelections(boolean b)
已過時。 從 JDK version 1.1 開始，由 setMultipleMode(boolean) 取代。