AWT List 类
简介
List 表示文本项列表。可以配置列表,以便用户可以选择一个或多个项。
类声明
以下是 java.awt.List 类的声明:
public class List extends Component implements ItemSelectable, Accessible
类构造函数
S.N. | 构造函数 &描述 |
---|---|
1 | List() 创建一个新的滚动列表。 |
2 | List(int rows) 创建一个新的滚动列表,初始化为指定数量的可见行。 |
3 | List(int rows, boolean multipleMode) 创建一个新的滚动列表,初始化为显示指定数量的行。 |
类方法
S.N. | 方法& 描述 |
---|---|
1 | void add(String item) 将指定的项目添加到滚动列表的末尾。 |
2 | void add(String item, int index) 将指定的项目添加到滚动列表中索引指示的位置。 |
3 | void addActionListener(ActionListener l) 添加指定的操作侦听器以从此列表接收操作事件。 |
4 | void addItem(String item) 已弃用。由 add(String) 替换。 |
5 | void addItem(String item, int index) 已弃用。由 add(String, int) 替换。 |
6 | void addItemListener(ItemListener l) 添加指定的项目侦听器以从此列表接收项目事件。 |
7 | void addNotify() 为列表创建对等体。 |
8 | boolean allowingMultipleSelections() 已弃用。从 JDK 1.1 版开始,由 isMultipleMode() 取代。 |
9 | void clear() 已弃用。从 JDK 1.1 版开始,由 removeAll() 取代。 |
10 | int countItems() 已弃用。从 JDK 1.1 版开始,由 getItemCount() 取代。 |
11 | void delItem(int position) 已弃用。由 remove(String) 和 remove(int) 取代。 |
12 | void delItems(int start, int end) 已弃用。从 JDK 1.1 版开始,将来不再供公众使用。该方法预计仅作为包私有方法保留。 |
13 | void deselect(int index) 取消选择指定索引处的项目。 |
14 | AccessibleContext getAccessibleContext() 获取与此列表关联的 AccessibleContext。 |
15 | ActionListener[] getActionListeners() 返回此列表上注册的所有动作侦听器的数组。 |
16 | String getItem(int index) 获取项目与指定索引关联的。 |
17 | int getItemCount() 获取列表中的项目数。 |
18 | ItemListener[] getItemListeners() 返回此列表上注册的所有项目侦听器的数组。 |
19 | String[] getItems() 获取列表中的项目。 |
20 | Dimension getMinimumSize() 确定此滚动列表的最小大小。 |
21 | Dimension getMinimumSize(int rows) 获取具有指定行数的列表的最小尺寸。 |
22 | Dimension getPreferredSize() 获取此滚动列表的首选大小。 |
23 | Dimension getPreferredSize(int rows) 获取具有指定行数的列表的首选尺寸。 |
24 | int getRows() 获取此列表中可见行的数量。 |
25 | int getSelectedIndex() 获取列表中选定项目的索引, |
26 | int[] getSelectedIndexes() 获取列表中选定的索引。 |
27 | String getSelectedItem() 获取此滚动列表中选定的项目。 |
28 | String[] getSelectedItems() 获取此滚动列表中选定的项目列表。 |
29 | Object[] getSelectedObjects() 获取此滚动列表中对象数组中的选定项。 |
30 | int getVisibleIndex() 获取最后通过方法 makeVisible 可见的项的索引。 |
31 | boolean isIndexSelected(int index) 确定此滚动列表中的指定项是否被选中。 |
32 | boolean isMultipleMode() 确定此列表是否允许多项选择。 |
33 | boolean isSelected(int index) 已弃用。从 JDK 1.1 版开始,由 isIndexSelected(int) 取代。 |
34 | void makeVisible(int index) 使指定索引处的项目可见。 |
35 | Dimension minimumSize() 已弃用。从 JDK 1.1 版开始,由 getMinimumSize() 取代。 |
36 | Dimension minimumSize(int rows) 已弃用。从 JDK 1.1 版开始,由 getMinimumSize(int) 取代。 |
37 | protected String paramString() 返回表示此滚动列表状态的参数字符串。 |
38 | Dimension preferredSize() 已弃用。从 JDK 1.1 版开始,由 getPreferredSize() 取代。 |
39 | Dimension preferredSize(int rows) 已弃用。从 JDK 1.1 版开始,由 getPreferredSize(int) 取代。 |
40 | protected void processActionEvent(ActionEvent e) 通过将发生在此组件上的动作事件分派给任何已注册的 ActionListener 对象来处理它们。 |
41 | protected void processEvent(AWTEvent e) 处理此滚动列表上的事件。 |
42 | protected void processItemEvent(ItemEvent e) 通过将发生在此列表上的项目事件分派给任何已注册的 ItemListener 对象来处理它们。 |
43 | void remove(int position) 从此滚动列表中移除指定位置的项目。 |
44 | void remove(String item) 从列表中移除第一个出现的项目。 |
45 | void removeActionListener(ActionListener l) 移除指定的操作侦听器,使其不再接收来自此列表的操作事件。 |
46 | void removeAll() 从此列表中移除所有项目。 |
47 | void removeItemListener(ItemListener l) 删除指定的项目侦听器,使其不再接收来自此列表的项目事件。 |
48 | void removeNotify() 删除此列表的对等项。 |
49 | void replaceItem(String newValue, int index) 用新字符串替换滚动列表中指定索引处的项目。 |
50 | void select(int index) 选择滚动列表中指定索引处的项目列表。 |
51 | void setMultipleMode(boolean b) 设置确定此列表是否允许多项选择的标志。 |
52 | void setMultipleSelections(boolean b) 已弃用。从 JDK 1.1 版开始,由 setMultipleMode(boolean) 取代。 |
继承的方法
此类从以下类继承方法:
java.awt.Component
java.lang.Object
List 示例
使用您选择的任何编辑器在 D:/ > AWT > com > tutorialspoint > gui > 中创建以下 Java 程序
AwtControlDemo.javapackage com.tutorialspoint.gui; import java.awt.*; import java.awt.event.*; public class AwtControlDemo { private Frame mainFrame; private Label headerLabel; private Label statusLabel; private Panel controlPanel; public AwtControlDemo(){ prepareGUI(); } public static void main(String[] args){ AwtControlDemo awtControlDemo = new AwtControlDemo(); awtControlDemo.showListDemo(); } private void prepareGUI(){ mainFrame = new Frame("Java AWT Examples"); mainFrame.setSize(400,400); mainFrame.setLayout(new GridLayout(3, 1)); mainFrame.addWindowListener(new WindowAdapter() { public void windowClosing(WindowEvent windowEvent){ System.exit(0); } }); headerLabel = new Label(); headerLabel.setAlignment(Label.CENTER); statusLabel = new Label(); statusLabel.setAlignment(Label.CENTER); statusLabel.setSize(350,100); controlPanel = new Panel(); controlPanel.setLayout(new FlowLayout()); mainFrame.add(headerLabel); mainFrame.add(controlPanel); mainFrame.add(statusLabel); mainFrame.setVisible(true); } private void showListDemo(){ headerLabel.setText("Control in action: List"); final List fruitList = new List(4,false); fruitList.add("Apple"); fruitList.add("Grapes"); fruitList.add("Mango"); fruitList.add("Peer"); final List vegetableList = new List(4,true); vegetableList.add("Lady Finger"); vegetableList.add("Onion"); vegetableList.add("Potato"); vegetableList.add("Tomato"); Button showButton = new Button("Show"); showButton.addActionListener(new ActionListener() { public void actionPerformed(ActionEvent e) { String data = "Fruits Selected: " + fruitList.getItem(fruitList.getSelectedIndex()); data += ", Vegetables selected: "; for(String vegetable:vegetableList.getSelectedItems()){ data += vegetable + " "; } statusLabel.setText(data); } }); controlPanel.add(fruitList); controlPanel.add(vegetableList); controlPanel.add(showButton); mainFrame.setVisible(true); } }
使用命令提示符编译程序。转到 D:/ > AWT 并键入以下命令。
D:\AWT>javac com utorialspoint\gui\AwtControlDemo.java
如果没有错误,则表示编译成功。使用以下命令运行程序。
D:\AWT>java com.tutorialspoint.gui.AwtControlDemo
验证以下输出
