Python GUI：使用SpinBox設置數值輸入

一、SpinBox是什麼

SpinBox是一種常用於Python GUI編程中的小部件，它允許用戶通過向上或向下端點按鈕或手動輸入來選擇數字。具體而言，最常見的SpinBox是QSpinBox，它是Qt圖形用戶界面庫的一部分，是PyQt和PySide等Python GUI框架的重要組件。

使用SpinBox可以方便地實現各種和數字有關的功能，比如調節音量、設置密碼長度、指定圖像縮放比例等。

二、SpinBox的基本使用

1. 導入模塊：在使用SpinBox之前，需要導入相應的模塊，以PyQt為例：

from PyQt5.QtWidgets import QApplication, QWidget, QSpinBox, QLabel, QVBoxLayout

app = QApplication([])
window = QWidget()

2. 創建SpinBox： 接下來我們根據需要的數值範圍和步長來創建SpinBox，比如我們要設置成1-10的整數：

spinbox = QSpinBox()
spinbox.setMinimum(1)
spinbox.setMaximum(10)
spinbox.setSingleStep(1)

3. 添加標籤：為了讓用戶知道SpinBox的作用，我們需要為它添加一個相關的標籤，比如「設置數字：」：

label = QLabel("設置數字：")

4. 布局管理：接下來我們需要把SpinBox和標籤添加到一個垂直布局管理器中，並為應用程序窗口設置這個布局：

layout = QVBoxLayout()
layout.addWidget(label)
layout.addWidget(spinbox)
window.setLayout(layout)

5. 顯示窗口：接下來只要在屏幕上展示我們的窗口就可以了：

window.show()
app.exec_()

三、SpinBox的高階使用

1. 信號和槽

SpinBox與其他GUI組件一樣，每當值發生變化時就會發射信號。這正是SpinBox得以高度定製的關鍵：當用戶點擊端點按鈕或手動輸入時，甚至在SpinBox的值發生變化時，我們可以設置信號處理程序，從而實現更廣泛的應用

在Qt中，信號和槽是核心模塊，允許不同對象之間的通信。

在簡單的gui界面上使用槽函數，我們需要將其與組件的信號連接，以響應動作的事件

def on_value_changed(value):
    print("當前數字:", value)

spinbox.valueChanged.connect(on_value_changed)

以上示例中，我們定義了一個為on_value_changed的槽函數來獲取當前SpinBox的值。每當SpinBox的值發生變化時，將輸出當前數字的值。

2. 定製SpinBox的樣式

SpinBox使用了Qt樣式表語言，這使得我們有很大的自由度來定製SpinBox樣式。

可以通過 setStyleSheet() 方法設置SpinBox的樣式，比如以下設置SpinBox的數字字體為紅色，並將其背景顏色變成黑色：

spinbox.setStyleSheet("QSpinBox { color: red; background-color: black;}") 

3. 通過代碼設置SpinBox的值

有時我們可能希望在代碼中設置SpinBox的值，這可以通過setValue()方法實現：

spinbox.setValue(3)

四、完整源碼

from PyQt5.QtWidgets import QApplication, QWidget, QSpinBox, QLabel, QVBoxLayout

app = QApplication([])
window = QWidget()

spinbox = QSpinBox()
spinbox.setMinimum(1)
spinbox.setMaximum(10)
spinbox.setSingleStep(1)

def on_value_changed(value):
    print("當前數字:", value)

spinbox.valueChanged.connect(on_value_changed)

label = QLabel("設置數字：")
layout = QVBoxLayout()
layout.addWidget(label)
layout.addWidget(spinbox)
window.setLayout(layout)

spinbox.setStyleSheet("QSpinBox { color: red; background-color: black;}") 

spinbox.setValue(3)

window.show()
app.exec_()