javaGUI学习25：AWT-项目选择：复选框，选择框和列表

1、复选框

1.1 java.awt.ItemSelectable接口

实现 ItemSelectable接口的类具有零个或多个可被选定的项目。

实现 ltemSelectable接口的类激发item事件，并实现项目监听者注册方法。在 ltemListener接口中，定义了一个方法: void itemStateChanged ( ltemEvent)。只要ltemSelectable中的项目发生改变，就向当前所有已经注册的项目监听者激发项目事件。

方法：

void addItemListener(ItemListener l) //添加侦听器以在用户更改项目状态时接收项目事件。  
Object[] getSelectedObjects() //如果未选择任何项目，则返回所选项目或 null 。  
void removeItemListener(ItemListener l) //删除项侦听器。  

1.2 java.awt.Checkbox

复选框是表示逻辑状态的构件。

无论什么时候，只要复选框被选中或取消选中，复选框就激发项目事件。

为了对选中或取消选中做出反应，向复选框添加一个项目监听者。当复选框激发项目事件时，调用项目监听者的itenStateChanged方法，并向此方法传递lItemEvent实例。

既然复选框经常存在于互相排斥的组中，它们可以添加到java.awt.CheckboxGroup中。

java.awt. CheckboxGroup确保在任何给定的时间里，组中只有一个复选框被选中。

注意CheckboxGroup不是构件，因此不能被添加到容器中。结果，无论是否向复选框组添加复选框，都必须单独地向复选框存在的容器添加复选框。
一般情况下，复选框使用在下面两种环境中：一组复选框相互之间相容，或一组复选框之间相互排斥。

构造方法：

Checkbox() //创建一个复选框，其标签为空字符串。  
Checkbox(String label) //创建具有指定标签的复选框。  
Checkbox(String label, boolean state) //创建具有指定标签的复选框并设置指定的状态。  
Checkbox(String label, boolean state, CheckboxGroup group) //构造具有指定标签，设置为指定状态和指定复选框组的复选框。  
Checkbox(String label, CheckboxGroup group, boolean state) //在指定的复选框组中创建具有指定标签的复选框，并将其设置为指定的状态。 

2、选择框和列表

选择框和列表都显示选定的字符串列表。但是列表支持多项选择，而选择框只允许选定其一个项目。列表一般用来显示一个或多个项目;而选择框在被激活以前只显示选定的项目，在激活时为了选择，可以看见项目的下拉式菜单。

2.1 使用场景选择

选择框和列表之间的互换使用是很常见的。在特定的情形下，使用列表还是选择框，可以依据下面的条件来判定:

• 可利用的屏幕空间。
• 是否希望在所有时间显示多个项目。
• 是否需要多项选择。
• 如果同时需要显示多个项目或进行多项选择，则列表是可行的方法。
• 如果屏幕可用空间较少并且只需要一个选项，那么最好使用选择框。

2.2 java.awt.Choice

构造方法：

Choice() 创建一个新的选择菜单。  

方法：

void add(String item) //将项添加到此 Choice菜单。  
void addItem(String item) //从Java 2平台v1.1开始已过时。  
void addItemListener(ItemListener l) //添加指定的项侦听器以从此 Choice菜单接收项事件。  
void addNotify() //创建 Choice的同行。  
int countItems() //已过时。 截至JDK 1.1版，由getItemCount()取代。  
AccessibleContext getAccessibleContext() //获取 AccessibleContext与此相关 Choice 。  
String getItem(int index) //获取此 Choice菜单中指定索引处的字符串。  
int getItemCount() //返回此 Choice菜单中的项目数。  
ItemListener[] getItemListeners() //返回在此选项上注册的所有项侦听器的数组。  
<T extends EventListener>
T[] getListeners(类<T> listenerType) //在此 Choice返回当前注册为 FooListener s的所有对象的数组。 
int getSelectedIndex() //返回当前所选项的索引。  
String getSelectedItem() //获取当前选择的字符串表示形式。  
Object[] getSelectedObjects() //返回包含当前所选项的数组（长度为1）。  
void insert(String item, int index) //在指定位置将项目插入此选项。  
protected String paramString() //返回表示此 Choice菜单状态的字符串。  
protected void processEvent(AWTEvent e) //处理此选择的事件。  
protected void processItemEven(ItemEvent e) //处理此 Choice菜单上发生的项目事件， Choice是将它们分派给任何已注册的 ItemListener对象。  
void remove(int position) //从指定位置的选择菜单中删除项目。  
void remove(String item) //从 Choice菜单中删除第一次出现的 item 。  
void removeAll() //从选择菜单中删除所有项目。  
void removeItemListener(ItemListener l) //删除指定的项侦听器，以便它不再从此 Choice菜单接收项事件。  
void select(int pos) //将此 Choice菜单中的选定项目设置为指定位置的项目。  
void select(String str) //将此 Choice菜单中的所选项目设置为名称等于指定字符串的项目。  

2.3 java.awt.List

构造方法：

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 1.1版，由isMultipleMode()取代。  
void clear() 已过时。 
截至JDK 1.1版，由removeAll()取代。  
int countItems() 已过时。 
截至JDK 1.1版，由getItemCount()取代。  
void delItem​(int position) 已过时。 
由remove(String)和remove(int)取代。  
void delItems​(int start, int end) 已过时。 
从JDK 1.1版开始，未来不会公开使用。  
void deselect​(int index) 取消选择指定索引处的项目。  
AccessibleContext getAccessibleContext() 获取与 AccessibleContext相关的 List 。  
ActionListener[] getActionListeners() 返回在此列表中注册的所有动作侦听器的数组。  
String getItem​(int index) 获取与指定索引关联的项。  
int getItemCount() 获取列表中的项目数。  
ItemListener[] getItemListeners() 返回在此列表中注册的所有项侦听器的数组。  
String[] getItems() 获取列表中的项目。  
<T extends EventListener>
T[] getListeners​(类<T> listenerType) 返回当前注册的所有对象的数组 FooListener在这个S List 。  
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 1.1版，由isIndexSelected(int)取代。  
void makeVisible​(int index) 使指定索引处的项目可见。  
Dimension minimumSize() 已过时。 
截至JDK 1.1版，由getMinimumSize()取代。  
Dimension minimumSize​(int rows) 已过时。 
截至JDK 1.1版，由getMinimumSize(int)取代。  
protected String paramString() 返回表示此滚动列表状态的参数字符串。  
Dimension preferredSize() 已过时。 
截至JDK 1.1版，由getPreferredSize()取代。  
Dimension preferredSize​(int rows) 已过时。 
截至JDK 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 1.1版，由setMultipleMode(boolean)取代。