QInputDialog 是 PyQt5 裡的輸入視窗元件，使用時會開啟一個對話視窗，由使用者在視窗中選擇項目、輸入文字或數字後進行互動，這篇教學會介紹如何在 PyQt5 視窗裡加入 QInputDialog 輸入視窗並進行基本互動應用。

原文參考：QInputDialog 輸入視窗

因為 Google Colab 不支援 PyQt5，所以請使用本機環境 ( 參考：使用 Python 虛擬環境 ) 或使用 Anaconda Jupyter 進行實作 ( 參考：使用 Anaconda )。

加入 QInputDialog 輸入視窗

建立 PyQt5 視窗物件後，先透過 QtWidgets.QPushButton(widget) 方法加入按鈕，使用 clicked.connect() 綁定點擊按鈕時的函式，點擊按鈕時使用 QtWidgets.QInputDialog() 方法，就能建立輸入視窗，下方的程式碼會建立最基本文字輸入的視窗，。

from PyQt5 import QtWidgets
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def show():
    text, ok = QtWidgets.QInputDialog().getText(Form, '', '請輸入一段文字')
    print(text, ok)

btn = QtWidgets.QPushButton(Form)
btn.setGeometry(10,10,100,30)
btn.setText('輸入')
btn.clicked.connect(show)

Form.show()
sys.exit(app.exec_())

文字輸入視窗

當 QInputDialog 輸入視窗使用 getText() 方法，表示類型為「文字輸入視窗」，程式碼用法如下：

text, ok = QtWidgets.QInputDialog().getText(Form, '視窗標題', '說明文字')
# text 輸入的文字
# ok 狀態是否完成

下方的程式碼執行後，點擊按鈕會彈出文字輸入視窗，輸入文字後，會透過 QLabel 顯示輸入的文字。

from PyQt5 import QtWidgets
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def show():
    text, ok = QtWidgets.QInputDialog().getText(Form, '', '請輸入一段文字')
    label.setText(text)

label = QtWidgets.QLabel(Form)
label.setGeometry(10,50,200,50)
label.setStyleSheet('font-size:30px;')

btn = QtWidgets.QPushButton(Form)
btn.setGeometry(10,10,100,30)
btn.setText('輸入')
btn.clicked.connect(show)

Form.show()
sys.exit(app.exec_())

數字輸入視窗

當 QInputDialog 輸入視窗使用 getInt() 方法，表示類型為「整數輸入視窗」，使用 getDouble() 方法，表示類型為「浮點數輸入視窗」，程式碼用法如下：

num, ok = QtWidgets.QInputDialog().getInt(Form, '視窗標題', '說明文字')
# num 輸入的整數
# ok 狀態是否完成

num, ok = QtWidgets.QInputDialog().getDouble(Form, '視窗標題', '說明文字')
# num 輸入的浮點數
# ok 狀態是否完成

下方的程式碼執行後，點擊按鈕會彈出輸入視窗，輸入數字後，會透過 QLabel 顯示輸入的數字。

from PyQt5 import QtWidgets
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def showInt():
    num, ok = QtWidgets.QInputDialog().getInt(Form, '', '請輸入一個整數')
    label.setText(str(num))

def showDouble():
    num, ok = QtWidgets.QInputDialog().getDouble(Form, '', '請輸入一個浮點數')
    label.setText(str(num))

label = QtWidgets.QLabel(Form)
label.setGeometry(10,50,200,50)
label.setStyleSheet('font-size:30px;')

btn1 = QtWidgets.QPushButton(Form)
btn1.setGeometry(10,10,100,30)
btn1.setText('整數')
btn1.clicked.connect(showInt)

btn2 = QtWidgets.QPushButton(Form)
btn2.setGeometry(110,10,100,30)
btn2.setText('浮點數')
btn2.clicked.connect(showDouble)

Form.show()
sys.exit(app.exec_())

選項選擇視窗

當 QInputDialog 輸入視窗使用 getItem() 方法，表示類型為「選項輸入視窗」，程式碼用法如下：

item, ok = QtWidgets.QInputDialog().getInt(Form, '視窗標題', '說明文字', items, index)
# item 選擇的選項
# ok 狀態是否完成
# items 表示選項，使用串列格式
# index 表示預設第幾個選項，第一個為 0

下方的程式碼執行後，點擊按鈕會彈出輸入視窗，選擇選項後，會透過 QLabel 顯示選擇的選項

from PyQt5 import QtWidgets
import sys
app = QtWidgets.QApplication(sys.argv)

Form = QtWidgets.QWidget()
Form.setWindowTitle('oxxo.studio')
Form.resize(300, 200)

def show():
    items = ['a','b','c','d','e']
    item, ok = QtWidgets.QInputDialog().getItem(Form, '', '請選擇一個選項', items, 0)
    label.setText(item)

label = QtWidgets.QLabel(Form)
label.setGeometry(10,50,200,50)
label.setStyleSheet('font-size:30px;')

btn = QtWidgets.QPushButton(Form)
btn.setGeometry(10,10,100,30)
btn.setText('開啟選項')
btn.clicked.connect(show)

Form.show()
sys.exit(app.exec_())

更多 Python 教學

大家好，我是 OXXO，是個即將邁入中年的斜槓青年，我已經寫了超過 400 篇 Python 的教學，有興趣可以參考下方連結呦～ ^_^

• Python 教學 ( 學習導讀 )
• Python 網路爬蟲教學
• LINE BOT 教學
• OpenCV 教學
• AI 影像辨識教學