內(nèi)容: [J2SE5.0]Java Swing權(quán)威指南:Spinner Model Controls作者：John Zukowski譯者:glorywine版權(quán)聲明：任何獲得Matrix授權(quán)的網(wǎng)站，轉(zhuǎn)載時請務(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工作起來好像是在JList或者JComboBox中間放了一個JFormattedTextField。在JList或者JComboBox中，用戶可以提前設(shè)定好要輸入的值。JSpinner也提供這樣的一種機(jī)制。這個控件的另一個部分是JFormattedTextField。如何顯示和輸入不由那些小的控制格控制，比如JList。相反，可以通過JFormattedTextField來輸入或通過邊上的兩個小箭頭來瀏覽不同的可用的值。圖示1顯示了Spinner伴隨不同的輸入類型是什么樣子。圖示1的頂端的JSpinner是一個用來顯示法語星期，通過SpinnerListModel。中間的，是一個通過SpinnerDateModel顯示日期的JSpinner。底部的是使用SpinnerNumberModel的JSpinner。每一個都是通過各自神秘的方式，在本文的后面我們將要學(xué)習(xí)。圖示1.JSpinner實(shí)例要創(chuàng)建和操縱JSpinner，許多類都將被調(diào)用，最重要的是JSpinner自己。最重要的兩個準(zhǔn)素集包括SpinnerModel接口，包括可選擇的集合中的選項(xiàng)，還有，JSpinner.DefaultEditor的實(shí)現(xiàn)，用來捕獲所有選擇。慶幸的是，許多其它調(diào)用的類都是在后臺工作的，比如，一旦你給SpinnerNumberModel提供了數(shù)字的范圍，并且用這個類來協(xié)助Spinner，你的工作實(shí)際上是完成了。創(chuàng)建JSpinner控件JSpinner類包括兩個構(gòu)造函數(shù)來初始化控件：public JSpinner()JSpinner spinner = new JSpinner();public JSpinner(SpinnerModel model)SpinnerModel model = new SpinnerListModel(args);JSpinner spinner = new JSpinner(model);開始的時候可以沒有數(shù)據(jù)模型，后面可以使用它來跟蹤JSpinner的方法。另一個方法，在創(chuàng)建這個控件的時候使用完整的模型，實(shí)現(xiàn)SpinnerModel接口，它里面有三個具體的子類可以使用：SpinnerDateModel，SpinnerListModel和SpinnerNumberModel，伴隨著他們的抽象父類AbstractSpinnerModel。如果不指名模型，那么SpinnerNumberModel將默認(rèn)使用。而顯示和編輯的控件是JFormattedTextField，編輯的基本功能是通過一系列JSpinner的內(nèi)部類實(shí)現(xiàn)的：DateEditor，ListEditor和NumberFormat，還有父類中DefaultEditor的支持。JSpinner屬性除了創(chuàng)建JSpinner對象之外，你還可以通過表一中的九個屬性中的一個來進(jìn)行配置。Table 1. JSpinner 屬性value屬性中的值允許你更改當(dāng)前控件的設(shè)置，nextValue和perviousValue可以使你以不同的方向察看模型中的入口。使用ChangeListener來監(jiān)聽JSpinner eventsJSpinner直接支持一種事件監(jiān)聽：changeListener。在別的地方，當(dāng)commitEdit()方法被調(diào)用，這個事件將被觸發(fā)，告訴你spinner的值發(fā)生改變。為了證明，列表1聯(lián)系到一個自定義的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)行這個程序可以示范listener的用法（當(dāng)然，你也會發(fā)現(xiàn)更多關(guān)于ChangeListener的有意義的方法）。定制JSpinner的外觀同所有的Swing控件，JSpinner在不同的系統(tǒng)定義look-and-feel類型下，擁有不同的外觀，如示圖2。這個控件期初看起來像一個textfield，不同點(diǎn)是繪制了兩個箭頭。示圖 2. JSpinner under different look-and-feel types集合中的11個UIResource屬性在表格2中列舉，有限的方法繪制text field和箭頭。Table 2. JSpinner UIResource 元素SpinnerModel 接口到目前，我們已經(jīng)看到了如何同一個主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中的六個方法直接繪制了JSpinner，而JSpinner的方法間接調(diào)用模塊中的方法，在監(jiān)聽的狀況下，事件將聯(lián)系到監(jiān)聽器。AbstractSpinnerModel類AbstractSpinnerModel類基本要實(shí)現(xiàn)的是SpinnerModel接口，它提供了管理和通知的監(jiān)聽列表，子類必須實(shí)現(xiàn)接口中的四個方法，SpinnerModel中的三個具體實(shí)現(xiàn)如下：SpinnerDateModel，SpinnerListModel和SpinnerNumberModel。SpinnerDateModel類從名字可以推斷出，SpinnerDateModel提供了數(shù)據(jù)的選擇。這個類有兩個構(gòu)造函數(shù)：一個默認(rèn)選擇所有的數(shù)據(jù)，另一個要求你給出范圍。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ù)，就沒有開始和結(jié)束點(diǎn)。下面的例子展示了使用參數(shù)來表示100年的范圍。最后一個成員變量應(yīng)該是Calendar類中的一個定值：· 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類中的時間域，所以不能通過SpinnerDateModel在JSpinner中翻轉(zhuǎn)。表格3列出了SpinnerModel中的三個屬性，四個關(guān)于SpinnerDateModel。Table 3. SpinnerDateModel 屬性典型地，唯一的新屬性中你將要用來獲得最終的日期，盡管所有的結(jié)果都被包裹在getValue()中，以適當(dāng)?shù)臄?shù)據(jù)類型。如果在構(gòu)造函數(shù)中提供了數(shù)據(jù)的表示范圍，那么previous和next的值將是null，在邊界條件下。SpinnerListModelSpinnerListModel提供了從一個入口列表中選擇或者至少是字符串表述，這個類有三個構(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)沒有參數(shù)提供時，這個模型包括一個元素：字符串empty。List版保留一個對list的引用。而不是list的拷貝。如果改變了list，那么模型中的list也將改變。數(shù)組版本的創(chuàng)建了一個私有的內(nèi)部類，并且實(shí)例化一個list。對于list和數(shù)組版本，初始選擇的是第一個元素，否則將拋出一個IllegalArgumentException異常。如表格4顯示，屬性中增添的是set和get list。Table 4. SpinnerListModel 屬性SpinnerNumberModel類SpinnerNumberModel提供了從一個開區(qū)間或閉區(qū)間選擇數(shù)字的模式，數(shù)字可以使Number類的所有子類，包括Integer和Double。他有四個構(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，則為開區(qū)間。對于沒有參數(shù)的，初始值為1，步進(jìn)為1。步進(jìn)是整形的，如果你設(shè)為.333，那么將不會完成。表格5展示了SpinnerNumberModel的屬性：Table 5. SpinnerNumberModel 屬性自定義模型一般來說，可用的JSpinner模型已經(jīng)足夠了，所以沒有必要創(chuàng)建他的子類了。但是，并不是所有場合都能滿足。比如，你可能希望使用一個包裝了SpinnerListModel的模型，代替停止在第一個或最后一個元素，他包裝了另一個結(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編輯器對于JSpinner每個可用的模型，一個次要的支持類，JSpinner的一個內(nèi)部類。然而這個模塊可以控制控件是否可選，JSpinner編輯器允許你控制如何顯示和編輯每個可選的值。JSpinner.DefaultEditor類JSpinner的setEditor()方法允許你將任何Jcomponent作為JSpinner的編輯器，當(dāng)然你可以那樣做，更典型的是，你將用JSpinner.DefaultEditor的子類作運(yùn)行。以JformattedTextField作為簡單的編輯器工作，將提供所有你需要的基本功能。它包括一個基本的構(gòu)造函數(shù)：public JSpinner.DefaultEditor(JSpinner spinner)JSpinner spinner = new JSpinner();JComponent editor = JSpinner.DefaultEditor(spinner);spinner.setEditor(editor);在表格6中可以看到，有兩個屬性：Table 6. JSpinner.DefaultEditor properties 在不知道使用的是哪個模型工作的情況下，在這個級別的你可以做的是改變JformattedTextField中的文字顯示。更典型的是，你將改變模型編輯器的某些自定義方面。JSpinner.DateEditor類DateEditor允許你定制不同的日期顯示方式，使用java.text包中SimpleDateFormat類。察看Javadoc了解更多的關(guān)于SimpleDateFormat的可用格式模式。如果你不喜歡默認(rèn)的地顯示方式，可以通過給構(gòu)造函數(shù)的第二個參數(shù)傳遞一個新參數(shù)來改變顯示模式。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é)的某個時間。后面的例子將要顯示2004 December。編輯器的兩個屬性在表格7中。Table 7. JSpinner.DateEditor屬性JSpinner.ListEditor類當(dāng)使用SpinnerListModel類工作時，ListEditor不支持任何特殊格式。而是提供了前置類型支持。既然模塊的所有入口都知道了，編輯器將嘗試匹配用戶輸入的字符。這里只有一個構(gòu)造函數(shù)，但是你可能幾乎用不到。public JSpinner.ListEditor(JSpinner spinner) 在表格8中將看到ListEditor只有一個屬性：JSpinner.NumberEditor類NumberEditor和DateEditor的工作方式很相似，允許你輸入定制的顯示模式。代替SimpleDateFormat工作，NumberEditor可以協(xié)助java.text包中的DecimalFormat類。就像DateEditor一樣，他又兩個構(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òu)造函數(shù)使用默認(rèn)的字符串格式。如果數(shù)字太大，將使用逗號。如果結(jié)果是一個完整的數(shù)，將不會用十進(jìn)制顯示。表格9中，顯示editor的兩個屬性。Table 9. JSpinner.NumberEditor 屬性總結(jié)在這篇文章中，你學(xué)習(xí)到了Swing中的JSpinner控件。當(dāng)你要控制某些選擇在一定的范圍中時，JSpinner可以讓你通過翻滾來選擇需要的值。你學(xué)習(xí)到了如何提供這些要選擇的值：通過使用SpinnerDateModel和DateEditor，SpinnerListModel和ListEditor，SpinnerNumberModel和NumberEditor來設(shè)置日期。資源·javaworld.com:javaworld.com·Matrix-Java開發(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是一個自由作者，也是JZ Ventures的java投資顧問。他是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)載時請務(wù)必以超鏈接形式標(biāo)明文章原始出處和作者信息及本聲明作者:John Zukowski;glorywine原文地址:http://www.javaworld.com/javaworld/jw-08-2005/jw-0829-jspinner.html