Swing JSpinner類 - tw511教學網

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()`	獲取`JSpinner`的`AccessibleContext`。
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示例