(一): 基本交互组件:获取用户的输入或者显示状态的简单组件。
1. 按钮(JButton):文本可提示快捷键,可相对图标任意放置,使用ActionListener;
2. 复选框(JCheckBox):可以选中或取消,使用ItemListener,复选框和单选钮都是开关钮JToggleButton的子类。
3. 组合框(JComboBox):可以从多个选项中选择一个或自编辑,可用数组、集合或模型ComboBoxModel构造,通过getSelected(Index|Item)判断选中项,使用ItemListener,如果用户自己编辑内容,则索引会是-1,而元素是用户的输入;可用ListCellRenderer渲染选项(默认是JLabel),用ComboBoxEditor编辑当前项(默认是JTextField)。
4. 列表框(JList):可多列显示setLayoutOrientation,可多项选择setSelectionMode,可用数组、集合或模型ListModel构造(可动态增减),使用ListSelectionListener(getValueIsAdjusting为假时),用ListCellRenderer渲染,用ensureIndexIsVisible使索引可见。
5. 菜单项(JMenuItem):菜单栏JMenuBar包含多个菜单JMenu,菜单可以有子菜单JMenu、菜单项JMenuItem、分组栏JSeparator、复选菜单JCheckBoxMenuItem、单选菜单JRadioButtonMenuItem,菜单可以有文本(字体颜色、大小、样式)和图标。
6. 单选钮(JRadioButton):通常用ButtonGroup组合起来(操作模型ButtonModel),每组单选钮只能选中一个,使用ActionListener。
7. 滑块(JSlider):有水平或垂直样式,有大小标尺及标签,使用ChangeListener(当getValueIsAdjusting为假时),用setLabelTable(HashTable<Integer,JLabel>)自定义标签,或使用createStandardLabels创建等距标签,通常滑块和JFormattedTextField配对而精确定位数值(NumberFormatter(NumberFormat.getIntegerInstance()))。
8. 微调(JSpinner):用SpinnerModel构造(数字范围SpinnerNumberModel、日期跨度SpinnerDateModel、数组集合SpinnerListModel),各模型有对应的编辑器和组件,使用ChangeListener。
9. 文本框(JTextField):有初始串和列宽,用getText获得文本,使用ActionListener。
10. 密码框(JPasswordField):用setEchoChar设置回显字符,用getPassword获得密码。
(二): 不可编辑组件:用于显示信息或提示。
11. 标签(JLabel):显示文本和图标,用setDisplayedMnemonic和setLabelFor为目标设置快捷键,用set(Vertical|Horizontal)(Alignment|TextPosition)设置图标和文字位置,可以使用html显示多行超文本。
12. 进度条(JProgressBar):可用值范围构建JProgressBar,用setValue和setString更改进度和文字,用setStringPainted显示文字;进度条可能是不确定的,等到可以确定时用setIndeterminate变回来(适合于复杂控制、多进度条、重用的场合);高级进度监视器ProgressMonitor,用parent、title、note和min、max构建,用setProgress和setNote更新状态,isCanceled判断是否取消,setMillisToPopup显示延迟时间(适合于简单提示、易于取消的场合);另外还有ProgressMonitorInputStream包装流,如果读取费时超过延迟时间会显示进度框;
13. 工具提示(JToolTip):任何JComponent都可以setTooltipText设置工具提示;对于JTabbedPane可以对每个标签设置setTooltipTextAt或在addTab时提供对应参数;对于JTable和JTree可用cell renderer实现,渲染器是JComponent,对其调用函数setTooltipText即可,或者覆盖getTooltipText(MouseEvent),定位到行列位置,返回生成的提示即可;对于自定义组件可继承JComponent并实现getTooltipText即可;JTooltip组件由JComponent.createTooltip使用和创建;
(三): 通用容器组件:用于布局常规组件
14. 通用面板(JPanel):默认不透明setOpaque,可设边框setBorder;手动布局组件时配置合适的布局管理器,对于FlowLayout、BoxLayout、GridLayout和SpringLayout直接添加add即可,对于BorderLayout需提供方位参数,对于GridBagLayout需提供单元限制参数GridBagConstraints;对于CardLayout需提供key用于切换显示;
15. 滚动面板(JScrollPane):构建时提供目标对象,或使用getViewport().(set|get)View诶子客户对象;滚动栏JScrollBar通过get(Horizontal|Vertical)ScrollBar获取,有滚动策略(按需、总有、总无),滚动距离set(Unit|Block)Increment,值域(范围和当前值),使用AdjustmentListener;滚动面板包括中心、四边、四角九个区域,角需要两临边可见时才可见,可用set(Column|Row)HeaderView设置行列边头,用setCorner设置角组件;目标对象改变时调用revalidate即可;
16. 分割面板(JSplitPane):使用分割策略setOrientation和两个子面板set(Left|Right) Component构建,可以嵌套或包含滚动面板,可以设置分割栏位置大小和靠边特性setDivider(Location|Size)(如果仅添加add了一个组件则分割栏会粘至边上),缩放比例setResizeWeight为0.0时表示左上组件的大小是固定的;组件大小改变后需要使用resetToPreferedSizes更新分割面板,调整时即时显示用setContinuousLayout,用PropertyChangeListener监听属性DIVIDER_LOCATION_PROPERTY;
17. 标签面板(JTabbedPane):构建时可指定标签位置setTabPlacement(四方)和摆放策略setTabLayoutPolicy(多行回绕还是滚动延长);使用addTab或insertTab添加标签,需提供title、icon、component、tip、index,可通过索引index配置标签的相关信息,indexOfTab等可通过相关信息获取标签索引,tabComponent是标签标题的渲染器;setSelected(Index|Component)设置当前标签,使用ChangeListener监听;
18. 工具栏(JToolBar):容器为BorderLayout且仅有一个子组件时,再添加的工具栏可以随意拖动到四方(更改用setFloatable),用setRollover(true)设置当鼠标经过时才显示边框;添加分割栏用addSeparator,也可以添加按钮之外的组件,方向设置用setOrientation,组件方向用setAlignment(X|Y),如TOP_ALIGNMENT;
(四): 顶层窗口组件:可以独立显示的组件(其他组件必须有顶层窗口为根,且只能被包含在一个容器中),有菜单栏和内容窗格,不是线程安全的。
19. 小程序(JApplet):它的init、start、stop、destroy被普通线程调用,所以为线程安全可用invokeAndWait调用实际初始化函数;可用Timer和SwingWorker来分配定时和耗时任务;嵌入页面用applet元素,可包含菜单等。
20. 对话框(JDialog):对话框在显示和销毁上依赖于Frame,有模式modal的概念;简单标准对话框可使用JOptionPane,消息类型分错误、警告、信息、提问、普通,选项类型分默认、是否、是否取消、确定取消(仅用于showConfirmDialog,结果分是、否、确定、取消、关闭),输入框可提供数组供选择,选项框可自定义文字;
21. 主窗口(JFrame):标题修饰可由系统或外观提供setDefaultLookAndFeelDecorated,也可以没有setUndecorated;有title、icon、size、location属性,关闭时可以隐藏、销毁、退出或自定义的WindowAdapter。
(五): 高级交互组件
22. 颜色选择(JColorChooser):可以添加至容器或调出颜色选择窗口showDialog,使用ColorSelectionModel管理颜色并通知ChangeListener,再通过getColor获得所选颜色(取消为null);通过setPreviewPanel和setChooserPanels更改预览和选择面板;
23. 文件选择(JFileChooser):添加至容器或调出文件选择窗口show(Open|Save)Dialog,返回APPROVE_OPTION后用getSelectedFile获取所选文件,可以多选或选择目录setFileSelectionMode,隐藏文件setFileHiddenEnabled,过滤文件setFileFilter,多个过滤器addChoosableFileFilter,所有文件setAcceptAllFileFilterUsed,自定义文件视图setFileView提供图标和描述等信息,附加缩略图setAccessory组件通过成为PropertyChangeListener监听文件选择的改变。
24. 多行文本(JTextArea):构建时提供行列数set(Rows|Columns),自动换行和截取单词setLineWrap、setWrapStyleWord,滚动至末尾setCaretPosition,添加文本append,插入文本insert,替换文本replace,全选文本selectAll,某行索引getLineStartOffset。
25. 格式文本(JTextPane):简单显示网页可用JEditorPane.setPage,自定义格式编辑器StyledEditorKit可用JTextPane.registerEditorKitForContentType,通过StyleConstants设置格式,使用StyledDocument更改已有文字格式,使用StyledEditorKit配置后面的输入格式。
26. 表格(JTable):表格可用Object[][]data+Object[]column或Vector data+Vector column构造,或扩展AbstractTableModel提供行数、列数及列名、单元可编辑性和单元数据即可;添加到JScrollPane后通过setPreferredScrollableViewportSize指定可视范围,对于其他容器要手动添加table.getTableHeader至NORTH;用setSelectionModel指定选择模式,用ListSelectionListener监听用户选择,当evt.getValueIsAdjusting()为否时用getMinSelectionIndex获得所选,任意多选时可用getMaxSelectionIndex和isSlectedIndex综合判断找出所有选择行;用getColumnClass返回单元具体类型以便JTable查找默认的渲染器和编辑器,用TabColumn.setCell(Renderer|Editor)指定列渲染器和编辑器(DefaultCellEditor可包装JCheckBox、JComboBox和JTextField),编辑器如用JFormattedTextField可有校验输入功能,若列数据类型可用字符串构造则默认的编辑器就够用了,用JTable.setDefault(Editor|Renderer)(class,editor)可为某数据类型指定默认编辑器或渲染器;用renderer.setTooltipText可设提示,自定义渲染器在getTableCellRendererComponent里可根据单元内容设提示,扩展JTable覆盖getTooltip(MouseEvent)定位单元后返回提示也可以;用TablerHeader.setTooltipText可为表头设提示,还可覆盖JTable.createDefaultTableHeader里的JTableHeader的getTooltipText(MouseEvent)定位列索引后返回提示;用TableMap+TableSorter或者TableRowSorter+JTable.setRowSorter可以排序表格,选择方式可以是行、列、单元。
27. 树(JTree):以DefaultMutableTreeNode为根节点层次构建,或DefaultTreeModel模型才能通知TreeModelListener、JTree等监听器更新显示;TreeSelectionModel的setSelectionModel和addTreeSelectionListener可设选择方式和监听器,用tree. getLastSelectedPathComponent获得节点并getUserObject,根据节点类型isLeaf就知道用户数据是什么类型了;用setRootVisible隐藏根节点,用setShowRootHandles显示根节点的手柄,用tree.putClientProperty(“JTree.lineStyle”,”Angled”)设置线型,用setCellRenderer设置渲染器DefaultTreeCellRenderer(在set(Leaf|Open|Closed)Icon里设置节点图标,在getTreeCellRendererComponent里用setTooltipText设提示,同时需要注册ToolTipManager.sharedInstance().registerComponent(tree));添加节点到getSelectionPath().getLastPathComponent()用treeModel.inserNodeInto(new node(data), parent,parent.getChildCount()),用scrollPathToVisible(childNode.getPath())显示节点;用TreeSelectionListner和Tree[WillExpand|Expansion]Listener监听树的选择和展开,用setEditable使树可编辑,用setDragEnabled和setTransferHandler设置拖动特性,用(expand|collapse)Path(TreePath)展开或收缩分支。
(六): 特殊用途容器
28. 内部窗口(JInternalFrame):通常添加至JDesktopPane中,它不是顶层窗口(不能是组件层次的根,产生InternalFrameEvent),却是平台无关的(可编程最小化、主图标、标题栏修饰);需要用set(Size|Bounds)或pack设大小否则不可见,可用setLocation设相对位置,组件可添加至其内容窗格中,内部对话框用JOptionPane.showInternal等函数,desktop.setDragMode(OUTLINE_DRAG_MODE)启用边框拖动模式可提高效率。
29. 层次窗格(JLayeredPane):为容器增加了第三维度Z-Order,被用在JRootPane中;用add(Componet,Integer)添加指定层次的组件(层次高的在前面),用setLayer更改组件的层次,用setPosition或moveTo(Front|Bach)调整层次内的上下位置;组件可用setBounds设定大小和位置,现有的LayoutManager只会把所有组件看作一层而布局;用(lowest|highest)Layer和getComponent(s|Count)InLayer获得所有组件。
30. 根窗格(JRootPane):用于顶层容器中,包含玻璃窗格(getGlassPane,默认透明,用于拦截输入事件)、层次窗格(getLayeredPane,放置菜单栏和内容窗格)、内容窗格(getContentPane,放置组件)、菜单栏(setJMenuBar,主菜单);使用setDefaultButton可设默认按钮。