內(nèi)容: [J2SE5.0]Java Swing權(quán)威指南:Spinner Model Controls作者：John Zukowski譯者:glorywine版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時(shí)請(qǐng)務(wù)必以超鏈接形式標(biāo)明文章原始出處和作者信息及本聲明作者:John Zukowski;glorywine原文地址:http://www.javaworld.com/javaworld/jw-08-2005/jw-0829-jspinner.html中文地址:http://www.matrix.org.cn/resource/article/44/44000_Java_Swing.html關(guān)鍵詞： Java Swing Spinner Model ControlsJSpinner工作起來(lái)好像是在JList或者JComboBox中間放了一個(gè)JFormattedTextField。在JList或者JComboBox中，用戶可以提前設(shè)定好要輸入的值。JSpinner也提供這樣的一種機(jī)制。這個(gè)控件的另一個(gè)部分是JFormattedTextField。如何顯示和輸入不由那些小的控制格控制，比如JList。相反，可以通過(guò)JFormattedTextField來(lái)輸入或通過(guò)邊上的兩個(gè)小箭頭來(lái)瀏覽不同的可用的值。圖示1顯示了Spinner伴隨不同的輸入類型是什么樣子。圖示1的頂端的JSpinner是一個(gè)用來(lái)顯示法語(yǔ)星期，通過(guò)SpinnerListModel。中間的，是一個(gè)通過(guò)SpinnerDateModel顯示日期的JSpinner。底部的是使用SpinnerNumberModel的JSpinner。每一個(gè)都是通過(guò)各自神秘的方式，在本文的后面我們將要學(xué)習(xí)。圖示1.JSpinner實(shí)例要?jiǎng)?chuàng)建和操縱JSpinner，許多類都將被調(diào)用，最重要的是JSpinner自己。最重要的兩個(gè)準(zhǔn)素集包括SpinnerModel接口，包括可選擇的集合中的選項(xiàng)，還有，JSpinner.DefaultEditor的實(shí)現(xiàn)，用來(lái)捕獲所有選擇。慶幸的是，許多其它調(diào)用的類都是在后臺(tái)工作的，比如，一旦你給SpinnerNumberModel提供了數(shù)字的范圍，并且用這個(gè)類來(lái)協(xié)助Spinner，你的工作實(shí)際上是完成了。創(chuàng)建JSpinner控件JSpinner類包括兩個(gè)構(gòu)造函數(shù)來(lái)初始化控件：public JSpinner()JSpinner spinner = new JSpinner();public JSpinner(SpinnerModel model)SpinnerModel model = new SpinnerListModel(args);JSpinner spinner = new JSpinner(model);開(kāi)始的時(shí)候可以沒(méi)有數(shù)據(jù)模型，后面可以使用它來(lái)跟蹤JSpinner的方法。另一個(gè)方法，在創(chuàng)建這個(gè)控件的時(shí)候使用完整的模型，實(shí)現(xiàn)SpinnerModel接口，它里面有三個(gè)具體的子類可以使用：SpinnerDateModel，SpinnerListModel和SpinnerNumberModel，伴隨著他們的抽象父類AbstractSpinnerModel。如果不指名模型，那么SpinnerNumberModel將默認(rèn)使用。而顯示和編輯的控件是JFormattedTextField，編輯的基本功能是通過(guò)一系列JSpinner的內(nèi)部類實(shí)現(xiàn)的：DateEditor，ListEditor和NumberFormat，還有父類中DefaultEditor的支持。JSpinner屬性除了創(chuàng)建JSpinner對(duì)象之外，你還可以通過(guò)表一中的九個(gè)屬性中的一個(gè)來(lái)進(jìn)行配置。Table 1. JSpinner 屬性value屬性中的值允許你更改當(dāng)前控件的設(shè)置，nextValue和perviousValue可以使你以不同的方向察看模型中的入口。使用ChangeListener來(lái)監(jiān)聽(tīng)JSpinner eventsJSpinner直接支持一種事件監(jiān)聽(tīng)：changeListener。在別的地方，當(dāng)commitEdit()方法被調(diào)用，這個(gè)事件將被觸發(fā)，告訴你spinner的值發(fā)生改變。為了證明，列表1聯(lián)系到一個(gè)自定義的ChangeListener，與圖示1的程序相關(guān)聯(lián)。列表 1. JSpinner with ChangeListener import java.awt.*;import javax.swing.*;import javax.swing.event.*;import java.text.*;import java.util.*;public class SpinnerSample { public static void main (String args[]) { Runnable runner = new Runnable() { public void run() { JFrame frame = new JFrame('JSpinner Sample'); frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); DateFormatSymbols symbols = new DateFormatSymbols(Locale.FRENCH); ChangeListener listener = new ChangeListener() { public void stateChanged(ChangeEvent e) { System.out.println('Source: ' + e.getSource()); } }; String days[] = symbols.getWeekdays(); SpinnerModel model1 = new SpinnerListModel(days); JSpinner spinner1 = new JSpinner(model1); spinner1.addChangeListener(listener); JLabel label1 = new JLabel('French Days/List'); JPanel panel1 = new JPanel(new BorderLayout()); panel1.add(label1, BorderLayout.WEST); panel1.add(spinner1, BorderLayout.CENTER); frame.add(panel1, BorderLayout.NORTH); SpinnerModel model2 = new SpinnerDateModel(); JSpinner spinner2 = new JSpinner(model2); spinner2.addChangeListener(listener); JLabel label2 = new JLabel('Dates/Date'); JPanel panel2 = new JPanel(new BorderLayout()); panel2.add(label2, BorderLayout.WEST); panel2.add(spinner2, BorderLayout.CENTER); frame.add(panel2, BorderLayout.CENTER); SpinnerModel model3 = new SpinnerNumberModel(); JSpinner spinner3 = new JSpinner(model3); spinner3.addChangeListener(listener); JLabel label3 = new JLabel('Numbers'); JPanel panel3 = new JPanel(new BorderLayout()); panel3.add(label3, BorderLayout.WEST); panel3.add(spinner3, BorderLayout.CENTER); frame.add(panel3, BorderLayout.SOUTH); frame.setSize(200, 90); frame.setVisible (true); } }; EventQueue.invokeLater(runner); }運(yùn)行這個(gè)程序可以示范listener的用法（當(dāng)然，你也會(huì)發(fā)現(xiàn)更多關(guān)于ChangeListener的有意義的方法）。定制JSpinner的外觀同所有的Swing控件，JSpinner在不同的系統(tǒng)定義look-and-feel類型下，擁有不同的外觀，如示圖2。這個(gè)控件期初看起來(lái)像一個(gè)textfield，不同點(diǎn)是繪制了兩個(gè)箭頭。示圖 2. JSpinner under different look-and-feel types集合中的11個(gè)UIResource屬性在表格2中列舉，有限的方法繪制text field和箭頭。Table 2. JSpinner UIResource 元素SpinnerModel 接口到目前，我們已經(jīng)看到了如何同一個(gè)主JSpinner類連接，SpinnerModel接口是控件的數(shù)據(jù)模型，SpinnerModel的定義如下：public interface SpinnerModel { // Properties public Object getValue(); public void setValue(Object); public Object getNextValue(); public Object getPreviousValue(); // Listeners public void addChangeListener(ChangeListener); public void removeChangeListener(ChangeListener);}SpinnerModel中的六個(gè)方法直接繪制了JSpinner，而JSpinner的方法間接調(diào)用模塊中的方法，在監(jiān)聽(tīng)的狀況下，事件將聯(lián)系到監(jiān)聽(tīng)器。AbstractSpinnerModel類AbstractSpinnerModel類基本要實(shí)現(xiàn)的是SpinnerModel接口，它提供了管理和通知的監(jiān)聽(tīng)列表，子類必須實(shí)現(xiàn)接口中的四個(gè)方法，SpinnerModel中的三個(gè)具體實(shí)現(xiàn)如下：SpinnerDateModel，SpinnerListModel和SpinnerNumberModel。SpinnerDateModel類從名字可以推斷出，SpinnerDateModel提供了數(shù)據(jù)的選擇。這個(gè)類有兩個(gè)構(gòu)造函數(shù)：一個(gè)默認(rèn)選擇所有的數(shù)據(jù)，另一個(gè)要求你給出范圍。public SpinnerDateModel()SpinnerModel model = new SpinnerDateModel();JSpinner spinner = new JSpinner(model);public SpinnerDateModel(Date value, Comparable start, Comparable end, int calendarField)Calendar cal = Calendar.getInstance();Date now = cal.getTime();cal.add(Calendar.YEAR, -50);Date startDate = cal.getTime();cal.add(Calendar.YEAR, 100);Date endDate = cal.getTime();SpinnerModel model = new SpinnerDateModel(now, startDate, endDate, Calendar.YEAR);JSpinner spinner = new JSpinner(model);如果不指名任何參數(shù)，就沒(méi)有開(kāi)始和結(jié)束點(diǎn)。下面的例子展示了使用參數(shù)來(lái)表示100年的范圍。最后一個(gè)成員變量應(yīng)該是Calendar類中的一個(gè)定值：· Calendar.AM_PM · Calendar.DAY_OF_MONTH · Calendar.DAY_OF_WEEK · Calendar.DAY_OF_WEEK_IN_MONTH · Calendar.DAY_OF_YEAR · Calendar.ERA · Calendar.HOUR · Calendar.HOUR_OF_DAY · Calendar.MILLISECOND · Calendar.MINUTE · Calendar.MONTH · Calendar.SECOND · Calendar.WEEK_OF_MONTH · Calendar.WEEK_OF_YEAR · Calendar.YEAR注意：SpinnerDateModel不包含任何Calendar類中的時(shí)間域，所以不能通過(guò)SpinnerDateModel在JSpinner中翻轉(zhuǎn)。表格3列出了SpinnerModel中的三個(gè)屬性，四個(gè)關(guān)于SpinnerDateModel。Table 3. SpinnerDateModel 屬性典型地，唯一的新屬性中你將要用來(lái)獲得最終的日期，盡管所有的結(jié)果都被包裹在getValue()中，以適當(dāng)?shù)臄?shù)據(jù)類型。如果在構(gòu)造函數(shù)中提供了數(shù)據(jù)的表示范圍，那么previous和next的值將是null，在邊界條件下。SpinnerListModelSpinnerListModel提供了從一個(gè)入口列表中選擇或者至少是字符串表述，這個(gè)類有三個(gè)構(gòu)造函數(shù)：public SpinnerListModel()SpinnerModel model = new SpinnerListModel();JSpinner spinner = new JSpinner(model);public SpinnerListModel(List<?> values)List list = args;SpinnerModel model = new SpinnerListModel(list);JSpinner spinner = new JSpinner(model);public SpinnerListModel(Object[] values)SpinnerModel model = new SpinnerListModel(args);JSpinner spinner = new JSpinner(model);當(dāng)沒(méi)有參數(shù)提供時(shí)，這個(gè)模型包括一個(gè)元素：字符串empty。List版保留一個(gè)對(duì)list的引用。而不是list的拷貝。如果改變了list，那么模型中的list也將改變。數(shù)組版本的創(chuàng)建了一個(gè)私有的內(nèi)部類，并且實(shí)例化一個(gè)list。對(duì)于list和數(shù)組版本，初始選擇的是第一個(gè)元素，否則將拋出一個(gè)IllegalArgumentException異常。如表格4顯示，屬性中增添的是set和get list。Table 4. SpinnerListModel 屬性SpinnerNumberModel類SpinnerNumberModel提供了從一個(gè)開(kāi)區(qū)間或閉區(qū)間選擇數(shù)字的模式，數(shù)字可以使Number類的所有子類，包括Integer和Double。他有四個(gè)構(gòu)造函數(shù)。public SpinnerNumberModel()SpinnerModel model = new SpinnerNumberModel();JSpinner spinner = new JSpinner(model);public SpinnerNumberModel(double value, double minimum, double maximum, double stepSize)SpinnerModel model = new SpinnerNumberModel(50, 0, 100, .25);JSpinner spinner = new JSpinner(model);public SpinnerNumberModel(int value, int minimum, int maximum, int stepSize)SpinnerModel model = new SpinnerNumberModel(50, 0, 100, 1);JSpinner spinner = new JSpinner(model);public SpinnerNumberModel(Number value, Comparable minimum, Comparable maximum, Number stepSize)Number value = new Integer(50);Number min = new Integer(0);Number max = new Integer(100);Number step = new Integer(1);SpinnerModel model = new SpinnerNumberModel(value, min, max, step);JSpinner spinner = new JSpinner(model);如果最大或最小值為null，則為開(kāi)區(qū)間。對(duì)于沒(méi)有參數(shù)的，初始值為1，步進(jìn)為1。步進(jìn)是整形的，如果你設(shè)為.333，那么將不會(huì)完成。表格5展示了SpinnerNumberModel的屬性：Table 5. SpinnerNumberModel 屬性自定義模型一般來(lái)說(shuō)，可用的JSpinner模型已經(jīng)足夠了，所以沒(méi)有必要?jiǎng)?chuàng)建他的子類了。但是，并不是所有場(chǎng)合都能滿足。比如，你可能希望使用一個(gè)包裝了SpinnerListModel的模型，代替停止在第一個(gè)或最后一個(gè)元素，他包裝了另一個(gè)結(jié)束。在列表2中給出了具體實(shí)現(xiàn)：Listing 2. RolloverSpinnerListModel 類import javax.swing.*;import java.util.*;public class RolloverSpinnerListModel extends SpinnerListModel { public RolloverSpinnerListModel(List values) { super(values); } public RolloverSpinnerListModel(Object[] values) { super(values); } public Object getNextValue() { Object returnValue = super.getNextValue(); if (returnValue == null) { returnValue = getList().get(0); } return returnValue; } public Object getPreviousValue() { Object returnValue = super.getPreviousValue(); if (returnValue == null) { List list = getList(); returnValue = list.get(list.size() - 1); } return returnValue; }}JSpinner編輯器對(duì)于JSpinner每個(gè)可用的模型，一個(gè)次要的支持類，JSpinner的一個(gè)內(nèi)部類。然而這個(gè)模塊可以控制控件是否可選，JSpinner編輯器允許你控制如何顯示和編輯每個(gè)可選的值。JSpinner.DefaultEditor類JSpinner的setEditor()方法允許你將任何Jcomponent作為JSpinner的編輯器，當(dāng)然你可以那樣做，更典型的是，你將用JSpinner.DefaultEditor的子類作運(yùn)行。以JformattedTextField作為簡(jiǎn)單的編輯器工作，將提供所有你需要的基本功能。它包括一個(gè)基本的構(gòu)造函數(shù)：public JSpinner.DefaultEditor(JSpinner spinner)JSpinner spinner = new JSpinner();JComponent editor = JSpinner.DefaultEditor(spinner);spinner.setEditor(editor);在表格6中可以看到，有兩個(gè)屬性：Table 6. JSpinner.DefaultEditor properties 在不知道使用的是哪個(gè)模型工作的情況下，在這個(gè)級(jí)別的你可以做的是改變JformattedTextField中的文字顯示。更典型的是，你將改變模型編輯器的某些自定義方面。JSpinner.DateEditor類DateEditor允許你定制不同的日期顯示方式，使用java.text包中SimpleDateFormat類。察看Javadoc了解更多的關(guān)于SimpleDateFormat的可用格式模式。如果你不喜歡默認(rèn)的地顯示方式，可以通過(guò)給構(gòu)造函數(shù)的第二個(gè)參數(shù)傳遞一個(gè)新參數(shù)來(lái)改變顯示模式。public JSpinner.DateEditor(JSpinner spinner)SpinnerModel model = new SpinnerDateModel();JSpinner spinner = new JSpinner(model);JComponent editor = JSpinner.DateEditor(spinner);spinner.setEditor(editor);public JSpinner.DateEditor(JSpinner spinner, String dateFormatPattern)SpinnerModel model = new SpinnerDateModel();JSpinner spinner = new JSpinner(model);JComponent editor = JSpinner.DateEditor(spinner, 'MMMM yyyy');spinner.setEditor(editor);默認(rèn)情況，格式是M/d/yy h:mm a或者12/25/04 12:34 PM 代表2004年的圣誕節(jié)的某個(gè)時(shí)間。后面的例子將要顯示2004 December。編輯器的兩個(gè)屬性在表格7中。Table 7. JSpinner.DateEditor屬性JSpinner.ListEditor類當(dāng)使用SpinnerListModel類工作時(shí)，ListEditor不支持任何特殊格式。而是提供了前置類型支持。既然模塊的所有入口都知道了，編輯器將嘗試匹配用戶輸入的字符。這里只有一個(gè)構(gòu)造函數(shù)，但是你可能幾乎用不到。public JSpinner.ListEditor(JSpinner spinner) 在表格8中將看到ListEditor只有一個(gè)屬性：JSpinner.NumberEditor類NumberEditor和DateEditor的工作方式很相似，允許你輸入定制的顯示模式。代替SimpleDateFormat工作，NumberEditor可以協(xié)助java.text包中的DecimalFormat類。就像DateEditor一樣，他又兩個(gè)構(gòu)造函數(shù)：public JSpinner.NumberEditor(JSpinner spinner)SpinnerModel model = new SpinnerNumberModel(50, 0, 100, .25);JSpinner spinner = new JSpinner(model);JComponent editor = JSpinner.NumberEditor(spinner);spinner.setEditor(editor);public JSpinner.NumberEditor(JSpinner spinner, String decimalFormatPattern)SpinnerModel model = new SpinnerNumberModel(50, 0, 100, .25);JSpinner spinner = new JSpinner(model);JComponent editor = JSpinner.NumberEditor(spinner, '#,##0.###');spinner.setEditor(editor);第二個(gè)構(gòu)造函數(shù)使用默認(rèn)的字符串格式。如果數(shù)字太大，將使用逗號(hào)。如果結(jié)果是一個(gè)完整的數(shù)，將不會(huì)用十進(jìn)制顯示。表格9中，顯示editor的兩個(gè)屬性。Table 9. JSpinner.NumberEditor 屬性總結(jié)在這篇文章中，你學(xué)習(xí)到了Swing中的JSpinner控件。當(dāng)你要控制某些選擇在一定的范圍中時(shí)，JSpinner可以讓你通過(guò)翻滾來(lái)選擇需要的值。你學(xué)習(xí)到了如何提供這些要選擇的值：通過(guò)使用SpinnerDateModel和DateEditor，SpinnerListModel和ListEditor，SpinnerNumberModel和NumberEditor來(lái)設(shè)置日期。資源·javaworld.com:javaworld.com·Matrix-Java開(kāi)發(fā)者社區(qū):http://www.matrix.org.cn/·這篇文章節(jié)選自 The Definitive Guide to Java Swing, Third Edition, John Zukowski (Apress, June 2005; ISBN: 1590594479): http://www.apress.com/book/bookDisplay.html?bID=393關(guān)于作者John Zukowski是一個(gè)自由作者，也是JZ Ventures的java投資顧問(wèn)。他是Sun’s Java Develop Connection，IBM’s developeWorks和JavaWorld的專欄作家。他最近一本書是Java Collections，Definitive Guide to Swing for java2，和Master java 1.4。他也是Borland’s JBuilder的作者：No Experience Required。 Java, java, J2SE, j2se, J2EE, j2ee, J2ME, j2me, ejb, ejb3, JBOSS, jboss, spring, hibernate, jdo, struts, webwork, ajax, AJAX, mysql, MySQL, Oracle, Weblogic, Websphere, scjp, scjd [J2SE5.0]Java Swing權(quán)威指南:Spinner Model Controls作者：John Zukowski譯者:glorywine版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時(shí)請(qǐng)務(wù)必以超鏈接形式標(biāo)明文章原始出處和作者信息及本聲明作者:John Zukowski;glorywine原文地址:http://www.javaworld.com/javaworld/jw-08-2005/jw-0829-jspinner.html