Swing JSpinner類

2019-10-16 22:10:50

JSpinner類是一個元件,它允許使用者使用輸入欄位從有序序列中選擇數位或物件值。

類宣告

以下是javax.swing.JSpinner類的宣告 -

public class JSpinner
   extends JComponent
      implements Accessible

類建構函式

編號 建構函式 描述
1 JSpinner() 構造一個帶有整數SpinnerNumberModel的微調器,初始值為0,沒有最小或最大限制。
2 JSpinner(SpinnerModel model) 使用一對下一個/上一個按鈕和一個SpinnerModel編輯器構造一個完整的微調器。

類方法

編號 類方法 描述
1 void addChangeListener(ChangeListener listener) 向列表新增一個監聽器,每次發生模型更改時都會通知該監聽器。
2 void commitEdit() 將當前編輯的值提交給SpinnerModel
3 protected JComponent createEditor(SpinnerModel model) 建構函式呼叫此方法來建立顯示序列當前值的JComponent
4 protected void fireStateChanged() ChangeEvent(其源是此JSpinner)傳送到每個ChangeListener
5 AccessibleContext getAccessibleContext() 獲取JSpinnerAccessibleContext
6 ChangeListener[] getChangeListeners() 返回使用addChangeListener()新增到此JSpinner的所有ChangeListener的陣列。
7 JComponent getEditor() 返回顯示並可能更改模型值的元件。
8 SpinnerModel getModel() 返回定義此微調器值序列的SpinnerModel
9 Object getNextValue() 返回由getValue()返回的物件之後的序列中的物件。
10 Object getPreviousValue() 返回由getValue()返回的物件之前的序列中的物件。
11 SpinnerUI getUI() 返回呈現此元件的外觀(L&F)物件。
12 String getUIClassID() 返回用於構造用於呈現此元件的外觀(L&F)類名稱的字尾。
13 Object getValue() 返回模型的當前值,通常此值用於編輯器顯示。
14 void removeChangeListener(ChangeListener listener) 從此微調器中刪除ChangeListener
15 void setEditor(JComponent editor) 更改顯示SpinnerModel當前值的JComponent
16 void setModel(SpinnerModel model) 更改表示此微調器值的模型。
17 void setUI(SpinnerUI ui) 設定呈現此元件的外觀(L&F)物件。
18 void setValue(Object value) 更改模型的當前值,通常此值由編輯器顯示。
19 void updateUI() 使用當前外觀中的值重置UI屬性。

方法繼承

該類繼承以下類中的方法 -

  • javax.swing.JComponent
  • java.awt.Container
  • java.awt.Component
  • java.lang.Object

JSpinner範例

使用編輯器建立以下Java程式:


import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.swing.event.*;

public class JSpinnerExample {
    private JFrame mainFrame;
    private JLabel headerLabel;
    private JLabel statusLabel;
    private JPanel controlPanel;

    public JSpinnerExample() {
        prepareGUI();
    }

    public static void main(String[] args) {
        JSpinnerExample swingControlDemo = new JSpinnerExample();
        swingControlDemo.showSpinnerDemo();
    }

    private void prepareGUI() {
        mainFrame = new JFrame("Java Swing JSpinner範例(tw511.com)");
        mainFrame.setSize(400, 400);
        mainFrame.setLayout(new GridLayout(3, 1));

        mainFrame.addWindowListener(new WindowAdapter() {
            public void windowClosing(WindowEvent windowEvent) {
                System.exit(0);
            }
        });
        headerLabel = new JLabel("", JLabel.CENTER);
        statusLabel = new JLabel("", JLabel.CENTER);
        statusLabel.setSize(350, 100);

        controlPanel = new JPanel();
        controlPanel.setLayout(new FlowLayout());

        mainFrame.add(headerLabel);
        mainFrame.add(controlPanel);
        mainFrame.add(statusLabel);
        mainFrame.setVisible(true);
    }

    private void showSpinnerDemo() {
        headerLabel.setText("Control in action: JSpinner");
        SpinnerModel spinnerModel = new SpinnerNumberModel(10, // initial value
                0, // min
                100, // max
                1);// step
        JSpinner spinner = new JSpinner(spinnerModel);
        spinner.addChangeListener(new ChangeListener() {
            public void stateChanged(ChangeEvent e) {
                statusLabel.setText("當前設定值 : " + ((JSpinner) e.getSource()).getValue());
            }
        });
        controlPanel.add(spinner);
        mainFrame.setVisible(true);
    }
}

執行上面範例程式碼,得到以下結果:

JSpinner示例