2-G-控件使用指南

Swing控件规范说明本控件规范主要概述在EAS开发中可以使用那些控件，不能使用那些控件；以及每个控件的简要说明和用法范围；以及与控件紧密相关的布局管理器，事件监听器；以及控件的外观和整体约束。至于每个控件的使用指南，请见控件部编写的控件使用指南。EAS开发中使用的控件目前在java技术中，存在Awt控件、Swing控件、Swt控件和我们控件部推出的KD控件。其实KD控件是对Swing控件的继承和扩充，本质上也是Swing控件。那么在EAS开发中我们到底使用那种控件呢？在此明确的说明：在EAS的业务开发中，只容许使用控件部推出的KD控件。绝对不可以使用Awt控件（比如java.awt.Button）,不可以使用标准的Swing控件（比如javax.swing.JButton），不可以使用Swt控件。在EAS业务开发中当发现KD控件完全不能满足有某种业务应用，并且该业务可抽象为通用应用，则可把此需求交给控件部，由控件部对需求进行分析，决定是否开发新的控件。控件集合如下分类控件中文名称KD控件的全名（包名都是com.kingdee.bos.ctrl.swing）对应的标准Swing控件（包名都是javax.swing.）功能简介一般控件功能按钮KDButtonJButton工作区按钮KDWorkButtonJButton文本标签KDLabelJLabel文本标签容器KDLabelContainer*复选框KDCheckBoxJCheckBox复选框菜单项KDCheckBoxMenuItemJCheckBoxMenuItem单选框KDRadioButtonJRadioButton单选框菜单项KDRadioButtonMenuItemJRadioButtonMenuItem单行多语言控件KDMultiLangBox*多行多语言控件KDMultiLangArea*单行文本框KDTextFieldJTextField多行文本框KDTextAreaJTextArea日期选择控件KDDatePicker*时间选择控件KDTimePicker*分组线KDSeparatorJSeparator上下选择框控件KDSpinnerJSpinner状态栏KDStatusBar*下拉选择框KDComboxBoxJComboBox列表框KDListJList滚动条KDScrollBarJScrollBar树KDTreeJTree

树视图KDTreeView*菜单KDMenuJMenu菜单项KDMenuItemJMenuItem弹出式菜单KDPopupMenuJPopupMenu工具栏KDToolBarJToolBar菜单栏KDMenuBarJMenuBar进度条KDProgressBarJProgressBar数字（整数/浮点数）控件KDNumberTextFieldJFormattedTextField货币控件KDCurrencyTextFieldJFormattedTextField掩码控件KDMaskTextFieldJFormattedTextFieldF7控件（提示输入框）KDPromptBox*容器控件可展开的容器KDContainer*基本容器KDPanelJPanel页签容器KDTabbedPaneJTabbedPane滚动面板容器KDScrollPaneJScrollPane窗口控件窗体KDFrameJFrame内部窗体KDInternalFrameJInternalFrame窗口*JWindow对话框KDDialogJDialog选择对话框KDOptionPaneJOptionPane业务控件重型控件表格控件KDTable*控件的外观约束KD体系控件米用的是KingdeeLookAndFeel的外观标准。KingdeeLookAndFeel的外观需求由人机部制订设计、提供规范，可参见人机部网站中的EAS控件风格（http://uiserver）。每一个控件的外观都已经按照人机部设计的风格默认实现了，开发者不能自行更改KD控件的风格。若是在EAS业务场景中，有必须更改KD控件的默认风格，请必须提交给人机部进行规划和设计。控件的风格指的是：◊控件的尺寸◊控件的边框效果◊控件的背景色、前景色◊控件的渐变色控件的图标、文字、字体控件的功能体控件的激活状态、钝化状态，编辑控件还有可编辑状态和不可编辑状态。在任何使用KD控件的应用系统中，请务必在应用系统的主程序（Main程序）的入口处，设置使用KingdeeLookAndFeel风格类。Try{UIManager.setLookAndFeel(“com.kingdee.bos.ctrl.swing.plaf.KingdeeLookAndFeel”);}catch(Exceptione){}控件使用的布局管理器在java中标准的布局管理器有java.awt.FlowLayoutjava.awt.BorderLayoutjava.awt.GridLayoutjava.awt.GridBagLayoutjava.awt.CardLayoutjava.awt.BoxLayoutjavax.swing.SpringLayout绝对定位，其实就是一个容器不设置布局管理器。另有术语叫XYLayout。新开发的布局管理器com.kingdee.bos.ctrl.swing.KDLayout以上布局管理器，KD体系控件均已支持。在EAS应用系统中都可以使用以上布局管理器，但是需要遵循一个的原则：1在UIDesigner中仅仅支持三种布局管理器com.kingdee.bos.ctrl.swing.KDLayout，java.awt.BorderLayout和绝对定位布局管理器（UIDesigner中看到的名称是XYLayout）。2在非UIDesigner的设计界面开发中，前提条件是使用KDLayout,BorderLayout,XYLayout,一旦发现复杂界面需要使用其它布局管理器时，应该把此界面的设计提交给人机部进行界面规划和分析。控件的事件监听器在标准的Swing控件中不同的控件有不同的事件监听器，初学者可能有点难掌握那些事件监听器。对于EAS业务开发者来说，也没有必要掌握所有的控件事件监听器，因为有一部分控件事件监听器是为扩展、开发控件而暴露的，而对业务开发来说基本用不到。通常情况下，KD控件常用的事件监听器不是很多，具体的每个控件常用的事件监听器也只有一个或两个。若