培訓(xùn)基礎(chǔ)課件常用控件介紹

1、KDTable及其它常用控件1提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器KDTable控件 功能增加（刪除）行或列行、列、單元的屬性和值填充數(shù)據(jù)動(dòng)態(tài)刷新Table數(shù)據(jù)融合選擇信息編輯分組輸入輸出事件格式化打印輔助編輯功能添加KDTable顯示后待執(zhí)行動(dòng)作說(shuō)明表格列寬自動(dòng)調(diào)整設(shè)置其他KDTable控件 用法示例增加列/ 指定插入位置tabl

2、e.addColumn(index);/ 插入到最后table.addColumn();/ 一次性添加多行addColumns(colCount);增加表頭行/ 指定插入位置table.addHeadRow(index);/ 插入到最后table.addHeadRow();/ 一次性添加多個(gè)表頭行table.addHeadRows(headRowCount);KDTable控件 用法示例/刪除所有表頭行table.removeHeadRows();/增加表體行/ 指定插入位置table.addRow(index);/ 插入到最后table.addRow();/ 一次性添加表體行table.ad

3、dRows(rowCount);/ 獲取列對(duì)象ICol col = table.getColumn(0);/ 獲取表頭行對(duì)象IRow headRow = table.getHeadRow(0);/ 獲取表體行對(duì)象IRow row = table.getRow(0);/ 獲取單元對(duì)象ICell headCell = row.getCell(0);ICell cell = row.getCell(0);如何設(shè)置單元的值/ value為任意objectcell.setValue(value);KDTable控件 用法示例快速創(chuàng)建具有空數(shù)據(jù)行的table/ 利用構(gòu)造函數(shù)創(chuàng)建有空數(shù)據(jù)行的table,下述

4、代碼展示了創(chuàng)建具有5列，一行表頭和10行空數(shù)據(jù)行的表格的兩種方法。/ 方法一：KDTable table = new KDTable(5, 1, 10);/ 方法二：KDTable table = new KDTable();this.createBlankTable(5, 1, 10);提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器編輯類(lèi)控

5、件 概覽提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器格式化輸入框(KDFormattedTextField)功能：只能輸入合法的數(shù)字提供整數(shù)或浮點(diǎn)的輸入（可以設(shè)置KDFormatTextedField的類(lèi)型）浮點(diǎn)型提供精度格式化（以及負(fù)數(shù)文本顏色的變化）格式化輸入框 構(gòu)造例子1：構(gòu)造時(shí)指定其類(lèi)型：（推薦）整數(shù)型輸入框KDFormattedT

6、extField integerField= new KDFormattedTextField(KDFormattedTextField.INTEGER);浮點(diǎn)型輸入框KDFormattedTextField floatField= new KDFormattedTextField(KDFormattedTextField.DECIMAL);floatField.setPrecision(5);/精確到小數(shù)點(diǎn)后第5位floatField.setNegativeColor(Color.red);/設(shè)置負(fù)數(shù)顏色例子2：構(gòu)造后指定其類(lèi)型：（不推薦）KDFormattedTextField ftf =

7、 new KDFormattedTextField();ftf.setDataType(KDFormattedTextField. BIGDECIMAL_TYPE);格式化輸入框 取值、賦值、監(jiān)聽(tīng)取值getNumberValue()或getValue()一般賦值setNumberValue(Number)或setValue(Number)不觸發(fā)事件的賦值大部分編輯類(lèi)控件現(xiàn)在都具有了此類(lèi)接口setValue(Object value, boolean fireListener)或者 setNumberValue(Number newValue, boolean fireListener)監(jiān)聽(tīng)值改

8、變事件addDataChangeListener(DataChangeListener l)格式化輸入框 其他功能設(shè)置是否支持null值：setSupportedEmpty(boolean)設(shè)置精度：setPrecision(boolean)設(shè)置當(dāng)焦點(diǎn)不能從該控件轉(zhuǎn)移開(kāi)時(shí)，哪些控件可以響應(yīng)鼠標(biāo)時(shí)間進(jìn)行操作：setAllowdMouseProcessComponents(JComponent)設(shè)置非編輯狀態(tài)下以百分?jǐn)?shù)的格式顯示：setPercentDisplay(true) 其他請(qǐng)參見(jiàn)控件的set*方法提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日

9、期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器日期選擇控件(KDDatePicker)功能：日期選擇框能進(jìn)行日期和時(shí)間的編輯，默認(rèn)情況下只能進(jìn)行日期選擇“年月日”，可通過(guò)調(diào)用用函數(shù)setTimeEnabled(boolean)來(lái)設(shè)置是否也有時(shí)間編輯。對(duì)日期進(jìn)行編輯時(shí)，可手工直接在編輯框里進(jìn)行改動(dòng)，也可點(diǎn)擊小按鈕彈出一個(gè)日期選擇表框進(jìn)行選擇。有“是否返回空值”的可選設(shè)置。該控件接受的數(shù)據(jù)類(lèi)型必須是java.util.Date及其子類(lèi)ja

10、va.sql.Date,java.sql.Timestamp.日期選擇控件 常用用法構(gòu)造KDDatePicker datePicker = new KDDatePicker();設(shè)置時(shí)間是否顯示 datePicker.setTimeEnabled(true); /“時(shí):分:秒”可顯示datePicker.setTimeEnabled(false); /“時(shí):分:秒”不可顯示值改變事件（注意例子的用法）datePicker.addDateChangeListener(new DataChangListener();提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextF

11、ield)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器F7控件 (KDPromptBox)功能： F7控件是一個(gè)特殊的編輯控件，特點(diǎn)是按下F7鍵能夠彈出輔助選框。用戶(hù)使用的典型流程：1用戶(hù)按下F7鍵；2控件彈出輔助選框；3用戶(hù)選擇某條目，并點(diǎn)擊確定或取消按鈕，輔助選框關(guān)閉；4控件根據(jù)輔助選框isCanceled方法得到輔助選框狀態(tài)；如果是確定狀態(tài)（isCanceled返回false）則通過(guò)輔助選框的getData方法獲得用戶(hù)選擇的

12、數(shù)據(jù)。注意：數(shù)據(jù)是從輔助選框到控件單向流動(dòng)的。5控件發(fā)出數(shù)據(jù)“將改變”事件(KDPreChangeEvent)，PreChangeListener對(duì)事件參數(shù)中的數(shù)據(jù)進(jìn)行處理(包括驗(yàn)證、屬性設(shè)置等)，如果preChange方法返回true；控件將data的text屬性設(shè)置到控件的編輯框中。6控件發(fā)出數(shù)據(jù)改變事件。F7控件 (KDPromptBox) EAS6.0增加的新功能： 輸入查詢(xún)字段后，按F8彈出過(guò)濾下拉框，在下拉框內(nèi)的操作流程類(lèi)似上述36，只是確定、取消按鈕的功能改為在條目上雙擊和點(diǎn)擊下拉框外其他地方關(guān)閉 增加了輸入框聯(lián)想記憶功能，可以記憶一定數(shù)量的歷史輸入記錄，可以調(diào)用setHisto

13、ryRecordEnabled(false)來(lái)關(guān)閉F7控件 屬性Data屬性：控件的數(shù)據(jù)屬性，Object對(duì)象。正常情況下編輯框中顯示的是Data的toString()返回值，在F7業(yè)務(wù)控件中，編輯框?qū)⒏鶕?jù)客戶(hù)指定格式顯示。Selector屬性：彈出式模式窗口，實(shí)現(xiàn)KDPromptSelector接口的窗口。用戶(hù)通過(guò)該窗口選擇數(shù)據(jù)。Dialog屬性：廢棄，被Selector屬性替代。Editable屬性：可編輯屬性。如果為true，用戶(hù)可以在編輯框中輸入文本。Value屬性和Display屬性：由KDTable使用，由于和KDTable分布在不同包中，故可見(jiàn)性為public，不建議客戶(hù)程序使用

14、。F7控件 功能調(diào)用1清除功能按下ctrl鍵，當(dāng)前具有焦點(diǎn)的F7控件的按鈕功能變?yōu)椤扒宄龜?shù)據(jù)”，同時(shí)切換圖標(biāo)。在該狀態(tài)下點(diǎn)擊該控件的按鈕將清除數(shù)據(jù)，并發(fā)出ChangedEvent事件。2可編輯功能public void setEditable(boolean aFlag);public boolean isEditable();在可編輯狀態(tài)下，Enter鍵為輸入確認(rèn)。確認(rèn)后，控件將編輯框中的文本通過(guò)commitEdit方法轉(zhuǎn)換為一個(gè)對(duì)象。3焦點(diǎn)控制控件失焦點(diǎn)時(shí)如果文字已被手動(dòng)編輯則執(zhí)行提交（觸發(fā)KDPreChangeEvent事件）。失焦點(diǎn)有以下幾種情況：Tab切換或鼠標(biāo)激活的切換：如果用戶(hù)被

15、手動(dòng)編輯過(guò)則提交數(shù)據(jù)。Enter切換：如果數(shù)據(jù)已經(jīng)被提交，則不提交。彈出PromptSelector：這種情況當(dāng)作焦點(diǎn)在本控件處理，不提交數(shù)據(jù)F7控件 功能調(diào)用4. 數(shù)據(jù)改變事件，發(fā)生在數(shù)據(jù)改變后：public void addChangeListener(ChangeListener listener);public void removeChangeListener(ChangeListener listener);5選擇框“將彈出”事件，發(fā)生在選擇框彈出之前：public void addSelectorListener(SelectorListener listener);在彈出選擇框

16、之前，監(jiān)聽(tīng)器可以修改控件的某些屬性，特別是和選擇框有關(guān)的屬性。參見(jiàn)F7業(yè)務(wù)控件說(shuō)明部分。6. Commit事件，發(fā)生在用戶(hù)在編輯框中按Enter鍵后：public void addCommitListener(CommitListener listener);在解析編輯框中的字符串之前發(fā)出該事件，事件中帶有編輯框中的文本，使用CommitEvent.getText()方法獲得。其他參見(jiàn)F7業(yè)務(wù)控件說(shuō)明部分。F7控件 常見(jiàn)用法設(shè)置f7的查詢(xún)過(guò)濾 promptBox.setQueryInfo(com.kingdee.eas.basedata.person.app.PersonQuery);設(shè)置可見(jiàn)

17、屬性 promptBox.setVisible(true);設(shè)置邊界屬性 promptBox.setEditable(true);設(shè)置顯示內(nèi)容 promptBox.setDisplayFormat($name$);設(shè)置編輯狀態(tài)內(nèi)容 promptBox.setEditFormat($number$);設(shè)置提交內(nèi)容 promptBox.setCommitFormat($number$);提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, K

18、DMultiLangArea)KDList控件KDTree控件KDLayout布局管理器多語(yǔ)言輸入框(KDMultiLangBox,KDMultiLangArea)功能：提供了存儲(chǔ)多對(duì)“特定語(yǔ)言-該語(yǔ)言相關(guān)數(shù)據(jù)”映射的功能，適用于需要多語(yǔ)言支持的產(chǎn)品。和JComboBox的Item相對(duì)應(yīng)，多語(yǔ)言輸入框使用MultiLangItem，它包含語(yǔ)言對(duì)象(LanguageInfo)和對(duì)應(yīng)數(shù)據(jù)(Object)。為了方便使用，多語(yǔ)言控件被包裝為KDBizMultiLangBox和KDBizMultiLangArea兩個(gè)實(shí)用控件，前者是單行，后者是多行。也可以使用KDBizMultiLangBox(KDMu

19、ltiLangBox.MULTILINE)來(lái)構(gòu)造一個(gè)多行多語(yǔ)言控件，等同于KDBizMultiLangArea。語(yǔ)言對(duì)象 LanguageInfo用來(lái)標(biāo)識(shí)不同的語(yǔ)言,包含語(yǔ)言區(qū)域和顯示圖標(biāo)。區(qū)域是唯一標(biāo)識(shí)一種語(yǔ)言的關(guān)鍵字；圖標(biāo)可以自定義，使用setIcon方法定制圖標(biāo)。默認(rèn)使用Locale.getDisplayName(getDefaultLocale()的前兩個(gè)字母作圖標(biāo)。多語(yǔ)言輸入框 使用使用時(shí)，應(yīng)用框架首先初始化語(yǔ)言列表，使用createLanguageList方法。該方法有兩種形式，帶圖標(biāo)參數(shù)的形式允許客戶(hù)程序指定每個(gè)區(qū)域?qū)?yīng)的語(yǔ)言圖標(biāo)，如下：public static List cr

20、eateLanguageList(Locale loc, Icon icon);需要注意的是：1. 初始化后語(yǔ)言列表不可更改。2. 初始化前如果未對(duì)語(yǔ)言列表進(jìn)行創(chuàng)建，那么new出來(lái)的控件就沒(méi)有任何語(yǔ)言。3. 如果應(yīng)用框架初始化的語(yǔ)言列表不夠用，控件可以通過(guò)addLanguage方法添加語(yǔ)言。4. 如果應(yīng)用框架有約定整個(gè)應(yīng)用使用統(tǒng)一的語(yǔ)言列表，那么請(qǐng)注意慎用下面的方法，這些方法將可能改變單個(gè)控件實(shí)例的語(yǔ)言列表：addLanguage(LanguageInfo); addItem(.);setItemData(LanguageInfo, Object); removeItem(.);removeL

21、anguage(LanguageInfo);多語(yǔ)言輸入框 使用多語(yǔ)言輸入框有以下功能來(lái)支持客戶(hù)程序：添加一種語(yǔ)言 addLanguage，在列表中查找，如果沒(méi)有則添加，有則不變。添加語(yǔ)言和相關(guān)數(shù)據(jù) addItem，在列表中查找，如果沒(méi)有則添加，并放入數(shù)據(jù)，有則只放入數(shù)據(jù)。刪除一種語(yǔ)言及其關(guān)聯(lián)數(shù)據(jù) removeLanguage,removeItem，列表中找不到被刪除項(xiàng)，則忽略；否則刪除。設(shè)置當(dāng)前語(yǔ)言 setSelectedLanguage，指定在編輯框中顯示的語(yǔ)言。設(shè)置當(dāng)前內(nèi)容 setSelectedItemData，修改在編輯框中顯示的語(yǔ)言的數(shù)據(jù)。提綱KDTable控件各種編輯類(lèi)控件格式化輸

22、入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器KDList控件 功能關(guān)于KDList及其模KDList繼承于JList。使用KingdeeListModel（它繼承于DefaultListModel，增加了圖標(biāo)等數(shù)據(jù)）。實(shí)現(xiàn)DefaultKingdeeListCellRenderer繪制帶圖標(biāo)的選項(xiàng)。使用KDList,沒(méi)有必要設(shè)置模,只須new創(chuàng)建然后增刪選項(xiàng)。例1： String s

23、 = Item1, Item2, Item3;KDList list = new KDList(s);例2：KDList list = new KDList();KDList控件 增刪選項(xiàng)每個(gè)選項(xiàng)是一個(gè)Object在列表末端增加一個(gè)選項(xiàng)public void addElement(Object elem)在列表中指定位置插入一個(gè)選項(xiàng)public void insertElement(Object elem, int index)在列表中指定位置重置選項(xiàng)，返回原選項(xiàng)public Object setElement(Object elem, int index)在列表中移除選項(xiàng)public boo

24、lean removeElement(Object elem)在列表中移除指定位置的選項(xiàng)public void removeElementAt(int index)移除列表中所有選項(xiàng)public void removeAllElements()取得列表中指定位置的選項(xiàng)public Object getElement(int index)KDList控件 增刪選項(xiàng)取得選項(xiàng)在列表中的位置public int getIndexOfElement(Object elem)判斷選項(xiàng)是否在列表中public boolean isContainsElement(Object elem)獲取選項(xiàng)個(gè)數(shù)publi

25、c int getElementCount()例： list.addElement(“Item4”); /列表末尾追加選項(xiàng)list.insertElement(“Item0”, 0); /插入選項(xiàng)KDList控件 其他功能給選項(xiàng)加圖標(biāo)選項(xiàng)多列布局設(shè)置單選/多選KDList控件 其他功能取得選中項(xiàng) （參考JDK文檔）public Object getSelectedValue()public Object getSelectedValues()public int getSelectedIndex()public int getSelectedIndices()事件（參考JDK文檔） 監(jiān)聽(tīng)選中項(xiàng)

26、改變list.addListSelectionListener(ListSelectionListener)監(jiān)聽(tīng)鼠標(biāo)事件（通過(guò)鼠標(biāo)位置得到選項(xiàng)索引）list.addMouseListener(new MouseAdapter()public void mousePressed(MouseEvent e) Point p = new Point(e.getX(), e.getY(); System.out.println(list.locationToIndex(p););提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePic

27、ker)F7控件(KDPromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器KDTree控件KDTree的模與節(jié)點(diǎn)KDTree從JTree繼承，它的模式及結(jié)構(gòu)也是與JTree保持一致，而JTree使用的模DefaultTreeModel和節(jié)點(diǎn)DefaultMultableTreeNode不能滿(mǎn)足KDTree的需求，于是擴(kuò)展了KingdeeTreeModel和DefaultKingTreeNode。增刪節(jié)點(diǎn)的易用性接口： 在父節(jié)點(diǎn)下的最后插入子節(jié)點(diǎn): addNodeInto(MutableTre

28、eNode newChild, MutableTreeNode parent)在父節(jié)點(diǎn)下的指定位置插入子節(jié)點(diǎn): insertNodeInto(MutableTreeNode newChild, MutableTreeNode parent, int index)刪除節(jié)點(diǎn): removeNodeFromParent(MutableTreeNode node) 刪除節(jié)點(diǎn)的所有子節(jié)點(diǎn): removeAllChildrenFromParent(MutableTreeNode parent) 設(shè)置節(jié)點(diǎn)是否顯示CheckBox(默認(rèn)為false): setShowCheckBox(boolean show

29、CheckBox) 眾多方法詳見(jiàn)開(kāi)發(fā)文檔。KDTreeView 樹(shù)視圖KDTreeView實(shí)現(xiàn)了對(duì)KDTree的包裝，將KDTree置于KDScrollPane中，并加上標(biāo)題欄和操作按扭：KDTreeView treeView = new KDTreeView(tree);KDTreeView treeView = new KDTreeView(); treeView.setTree(tree);取得KDTree：treeView.getTree()設(shè)置頂端的標(biāo)題欄是否可見(jiàn)public void setShowControlPanel(boolean isShow)設(shè)置TreeView標(biāo)題pu

30、blic void setTitle(String title)設(shè)置五個(gè)常用按鈕是否顯示，五個(gè)按鈕狀態(tài)一致 public void setShowButton(boolean showButton)新增按鈕KDWorkButton wb = new KDWorkButton(按鈕); treeView.getControlPane().add(wb);快捷操作 (since EAS v6.0)按Ctrl + 1,2,3分別將整棵樹(shù)展開(kāi)到第1，2，3級(jí)提綱KDTable控件各種編輯類(lèi)控件格式化輸入框(KDFormattedTextField)日期選擇控件(KDDatePicker)F7控件(KD

31、PromptBox)多語(yǔ)言輸入框(KDMultiLangBox, KDMultiLangArea)KDList控件KDTree控件KDLayout布局管理器KDLayout布局管理器功能：通過(guò)為每一個(gè)控件添加一個(gè)?？考s束（Anchor），把設(shè)計(jì)時(shí)的絕對(duì)定位布局轉(zhuǎn)化為可縮放的相對(duì)布局。使用范圍KDLayout是專(zhuān)門(mén)為UIDesigner設(shè)計(jì)布局管理器，通過(guò)對(duì)設(shè)計(jì)面板上的每一控件添加一個(gè)anchor屬性，KDLayout就能將UIDesigner上絕對(duì)定位的布局變成可縮放的布局。如果在UIDesigner外單獨(dú)使用KDLayout,需要填寫(xiě)更多的屬性。KDLayout 布局屬性KDLayout的內(nèi)

32、部類(lèi)Constraints定義了在使用KDLayout時(shí)容器上每個(gè)控件必須填寫(xiě)的布局屬性。Anchor錨定。指控件上的一邊與父容器的同方向的一邊或是中心點(diǎn)之間的固定關(guān)系。當(dāng)控件的錨定后，控件位置相對(duì)父容器固定。當(dāng)父容器大小改變后，控件與父容器之間的固定關(guān)系不變，控件的位置大小由父容器所決定。在KDLayout中定義了五個(gè)錨定點(diǎn)、兩種錨定方式，共九個(gè)錨定方式可選擇；不同錨定的方式用不同的常量表示，而且可以通過(guò)邏輯運(yùn)算符“或”進(jìn)行搭配使用。例如 “ANCHOR_BOTTOM_SCALE | ANCHOR_RIGHT”。OriginalBound用于記錄控件在UIDesigner上的原始大小當(dāng)父控件的布局管