PyQt5快速入門（三）PyQt5基本窗口組件

PyQt5快速入門（三）PyQt5基本窗口組件

一、QMainWindow

1、窗口類型簡介

QMainWindow、QWidget、QDialog用于創建窗口，可以直接使用，也可以派生使用。
QMainWindow窗口包含菜單欄、工具欄、狀態欄、標題欄等，是最常見的窗口形式。
QDialog是對話框窗口的基類，主要用于執行短期任務，或與用戶進行交互，可以是模態或非模態的。QDialog對話框沒有菜單欄、工具欄、狀態欄等。
QWidget是Qt圖形組件的基類，可以作為頂層窗口，也可以嵌入到其它組件中。

2、QMainWindow

QMainWindow是頂層窗口，QMainWindow有自己的布局管理器，不能使用setLayout對其進行設置，布局如下：

Menu Bar是菜單欄，Toolbars是工具欄，Dock Widgets是停靠窗口，Central Widget是中央窗口，Status Bar是狀態欄。

3、QMainWindow實例

import sys
from PyQt5.QtWidgets import QMainWindow, QApplication, QWidget, QLabel, QDesktopWidget, QToolBar

class MainWindow(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 菜單欄設置
        self.menuBar = self.menuBar()
        self.menuBar.addAction("File")
        self.menuBar.addAction("View")

        # 工具欄設置
        open = QToolBar()
        open.addAction("OPen")
        self.addToolBar(open)
        close = QToolBar()
        close.addAction("Close")
        self.addToolBar(close)

        # 中央組件設置
        self.window = QWidget()
        self.setCentralWidget(self.window)

        # 狀態欄設置
        self.statusBar = self.statusBar()
        self.statusBar.showMessage("This is an status message.", 5000)
        label = QLabel("permanent status")
        self.statusBar.addPermanentWidget(label)

        self.resize(800, 600)
        self.setWindowTitle("MainWindow Demo")
        self.center()

    def center(self):
        screen = QDesktopWidget().screenGeometry()
        size = self.geometry()
        self.move((screen.width() - size.width()) / 2, (screen.height() - size.height()) / 2)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()

    sys.exit(app.exec_())

二、QWidget

1、QWidget簡介

QWidget是所有GUI界面組件的基類，所有窗口和控件都直接或間接繼承自QWidget基類。

2、窗口坐標系統

Qt使用統一的坐標系統來定位窗口控件的位置和大小，坐標系統如下：

以屏幕的左上角為原點，即（0,0），從左向右為X軸正向，從上向下為Y軸正向，屏幕的坐標系統用于定位頂層窗口。窗口內部有自己的坐標系統，窗口坐標系統以左上角為原點，即（0,0），從左向右為X軸正向，從上向下為Y軸正向，原點、X軸、Y軸圍成的區域為客戶區，在客戶區的周圍是標題欄、邊框。
?intx() const;
?inty() const;
?int width() const;
?int height() const;
?x()、y()獲取窗口左上角的坐標，但width()和height()獲取的是客戶區的寬和高。
geometry().x()、geometry().y()獲取客戶區的左上角坐標，geometry().width()、geometry().height()獲取客戶區的寬度和高度。
frameGeometry().x()、frameGeometry().y()獲取客戶區的左上角坐標，frameGeometry().width()、frameGeometry().height()獲取包含客戶區、標題欄、邊框在內的寬度和高度。

3、QWidget實例

import sys
from PyQt5.QtWidgets import QApplication, QWidget, QLabel, QDesktopWidget, QToolBar

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)

        self.setWindowTitle("MainWidget")
        self.resize(800, 600)

        self.center()

    def center(self):
        screen = QDesktopWidget().screenGeometry()
        size = self.geometry()
        self.move((screen.width() - size.width()) / 2, (screen.height() - size.height()) / 2)

    def dispalyGeometry(self):
        x = self.x()
        y = self.y()
        print("x: {0}, y: {1}".format(x, y))
        x = self.pos().x()
        y = self.pos().y()
        print("x: {0}, y: {1}".format(x, y))
        x = self.frameGeometry().x()
        y = self.frameGeometry().y()
        print("x: {0}, y: {1}".format(x, y))
        x = self.geometry().x()
        y = self.geometry().y()
        print("x: {0}, y: {1}".format(x, y))
        print("geometry: ", self.geometry())
        print("frameGemetry: ", self.frameGeometry())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.show()
    window.dispalyGeometry()

    sys.exit(app.exec_())

三、QLabel

1、QLabel簡介

QLabel作為一個占位符可以顯示不可編輯的文本、圖片、GIF動畫，QLabel是界面的標簽類，繼承自QFrame。

2、QLabel實例

import sys
from PyQt5.QtWidgets import QApplication, QLabel
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QPalette

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = QLabel()
    window.setWindowTitle("QLabel Demo")
    window.setText("www.baidu.com")
    window.setOpenExternalLinks(True)
    pallette = QPalette()
    pallette.setColor(QPalette.Window, Qt.blue)
    window.setPalette(pallette)
    window.setAlignment(Qt.AlignCenter)
    window.setAutoFillBackground(True)
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

四、文本框控件

1、QLineEdit

QLineEdit是單行文本框控件，可以編輯單行字符串，用于接收用戶輸入。

import sys
from PyQt5.QtWidgets import QApplication, QLineEdit, QWidget, QLabel
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QIntValidator

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        label = QLabel("input: ", self)
        label.move(0, 0)
        lineEdit = QLineEdit(self)
        # 設置驗證器
        intValidator = QIntValidator()
        lineEdit.setValidator(intValidator)
        lineEdit.setMaxLength(10)
        lineEdit.move(50, 0)
        lineEdit.textChanged.connect(self.displayText)

    def displayText(self, text):
        print(text)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

2、QTextEdit

QTextEdit是一個多行文本框編輯控件，可以顯示、編輯多行文本編輯內容，當文本內容超出控件顯示范圍時，可以顯示水平和垂直滾動條，QTextEdit不僅可以顯示文本，還可以顯示HTML文檔。

import sys
from PyQt5.QtWidgets import QApplication, QTextEdit, QWidget, QLabel
from PyQt5.QtCore import Qt
from PyQt5.QtGui import QIntValidator

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        label = QLabel("input: ", self)
        label.move(0, 0)
        self.textEdit = QTextEdit(self)
        self.textEdit.move(50, 0)

        self.textEdit.setPlainText("Hello, PyQt5")
        self.textEdit.textChanged.connect(self.displayText)

    def displayText(self):
        print(self.textEdit.toPlainText())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

五、按鈕控件

1、QPushButton

QPushButton繼承自QAbstractButton，形狀為長方形，文本、圖標顯示在長方形區域。

import sys
from PyQt5.QtWidgets import QApplication, QPushButton, QWidget

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button1 = QPushButton("OK", self)

        button1.clicked.connect(lambda: self.onClicked(button1))

    def onClicked(self, button):
        print("Button {0} is clicked.".format(button.text()))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

2、QRadioButton

QRadioButton繼承自QAbstractButton，提供了一組可選的按鈕和標簽，用戶可以選擇其中一個選項，標簽用于顯示對應的文本信息。QRadioButton是一種開關按鈕，可以切換為on或off，即checked或unchecked。在單選按鈕組里，一次只能選擇一個單選按鈕，如果需要多個獨占的按鈕組合，需要將其放到QGroupBox或QButtonGroup中。

import sys
from PyQt5.QtWidgets import QApplication, QRadioButton, QWidget

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button1 = QRadioButton("OK", self)

        button1.toggled.connect(lambda: self.onClicked(button1))

    def onClicked(self, button):
        print("Button {0} is clicked.status is {1}".format(button.text(), button.isChecked()))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

3、QCheckBox

QCheckBox繼承自QAbstractButton，提供一組帶文本標簽的復選框，用戶可以選擇多個選項，復選框可以顯示文本和圖標。
除了選中、未選中，QCheckBox有第三種狀態：半選中，表示沒有變化。

import sys
from PyQt5.QtWidgets import QApplication, QCheckBox, QWidget

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button1 = QCheckBox("OK", self)

        button1.stateChanged.connect(lambda: self.onStateChanged(button1))

    def onStateChanged(self, button):
        print("Button {0} is clicked.status is {1}".format(button.text(), button.isChecked()))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

六、QComboBox

QComboBox是下拉列表框。

import sys
from PyQt5.QtWidgets import QApplication, QComboBox, QWidget

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.combo = QComboBox(self)
        self.combo.addItem("Apple")
        self.combo.addItem("HuaWei")
        self.combo.addItem("XiaoMi")
        self.combo.addItem("Oppo")

        self.combo.currentIndexChanged.connect(self.onCurrentIndex)

    def onCurrentIndex(self, index):
        print("current item is {0}".format(self.combo.currentText()))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

七、QSpinBox

QSpinBox是一個計數器控件，允許用戶選擇一個整數值，通過單擊向上、向下按鈕或鍵盤的上下箭頭來增加減少當前顯示的值，用戶也可以從編輯框輸入當前值。默認情況下，QSpinBox的取值范圍為0——99，每次改變的步長值為1。

import sys
from PyQt5.QtWidgets import QApplication, QSpinBox, QWidget

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        spinBox = QSpinBox(self)

        spinBox.valueChanged.connect(self.onValueChanged)

    def onValueChanged(self, value):
        print("current value is {0}".format(value))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

八、QSlider

QSlider控件提供了一個垂直或水平的滑動條，是一個用于控制有界值的控件，允許用戶沿著水平或垂直方向在某一范圍內移動滑塊，并將滑塊所在的位置轉換成一個合法范圍內的整數值。

import sys
from PyQt5.QtWidgets import QApplication, QSlider, QWidget
from PyQt5.QtCore import Qt

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        slider = QSlider(Qt.Horizontal, self)
        slider.setMaximum(20)
        slider.setMinimum(10)

        slider.valueChanged.connect(self.onValueChanged)

    def onValueChanged(self, value):
        print("current value is {0}".format(value))

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

九、對話框控件

1、QDialog

QDialog是對話框類，提供了三種窗口模態，非模態，模態和應用程序模態，使用setWindowModality方法設置窗口模態。
（1）非模態
非模態可以和應用程序的其它窗×××互，使用Qt.NonModal進行設置。
（2）窗口模態
窗口模態在未處理完成當前對話框時，將阻止和對話框的父窗口進行交互，使用Qt.Modal進行設置。
（3）應用程序模態
應用程序模態阻止任何和其它窗口進行交互，使用Qt.ApplicationModal。
QDialog及其派生類對話框在ESC按鍵按下時，對話框窗口將會默認調用QDialog.reject方法，關閉對話框。
setWindowModality()方法可以設置窗口是否是模態窗口，Qt::WindowModality默認值為Qt::NonModal，如果沒有設置Qt::WindowModality屬性值，每次用show()方法顯示出的窗口都是非模態窗口。
使用exec()方法顯示的對話框為模態對話框，同時會阻塞窗口的響應直到用戶關閉對話框，并且返回DialogCode（包括Accepted和Rejected兩個值）結果。
如果沒有設置Qt::WindowModality屬性值，使用exec()方法顯示出的對話框默認為應用程序級模態對話框。所有使用exec()方法顯示的對話框在窗口關閉前會阻塞整個程序所有窗口的響應。調用exec()方法后，對話框會阻塞，直到對話框關閉才會繼續執行。在關閉對話框后exec()方法會返回Accepted或者Rejected,一般程序根據返回不同的結果進行相應的操作。
模式對話框有自己的事件循環，exec()?方法內部先設置modal屬性為Qt::ApplicationModal，然后調用 show()?顯示對話框，最后啟用事件循環來阻止exec() 方法的結束。直到窗口關閉，得到返回結果（DialogCode），退出事件循環，最后exec()方法調用結束，exec()方法后的代碼將繼續執行。

import sys
from PyQt5.QtWidgets import QApplication, QDialog, QWidget, QPushButton
from PyQt5.QtCore import Qt

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button = QPushButton("OK", self)

        self.resize(800, 600)
        button.clicked.connect(self.onOKClicked)

    def onOKClicked(self):
        dialog = QDialog()
        dialog.setWindowTitle("Dialog Demo")
        dialog.resize(300, 200)
        dialog.exec_()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

2、QMessageBox

QMessageBox是一種通用的彈出式對話框，用于顯示消息，允許用戶通過點擊不同的標準按鈕對消息進行反饋，QMessageBox提供了五種常用消息對話框的顯示方法。
warning(self, QWidget, p_str, p_str_1, buttons, QMessageBox_StandardButtons=None, QMessageBox_StandardButton=None, *args, **kwargs)
創建警告消息對話框
critical(self, QWidget, p_str, p_str_1, buttons, QMessageBox_StandardButtons=None, QMessageBox_StandardButton=None, *args, **kwargs)
創建關鍵錯誤消息對話框
information(self, QWidget, p_str, p_str_1, buttons, QMessageBox_StandardButtons=None, QMessageBox_StandardButton=None, *args, **kwargs)
創建信息消息對話框
question(self, QWidget, p_str, p_str_1, buttons, QMessageBox_StandardButtons=None, QMessageBox_StandardButton=None, *args, **kwargs)
創建詢問消息對話框
about(self, QWidget, p_str, p_str_1)
創建關于信息對話框

import sys
from PyQt5.QtWidgets import QApplication, QMessageBox, QWidget, QPushButton

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button = QPushButton("OK", self)

        self.resize(800, 600)
        button.clicked.connect(self.onOKClicked)

    def onOKClicked(self):
        button = QMessageBox.question(self, "MessageBox Title", "是否確定關閉？", QMessageBox.Ok | QMessageBox.Cancel, QMessageBox.Ok)
        if button == QMessageBox.Ok:
            print("select Ok Button")

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

3、QInputDialog

QInputDialog是一個標準對話框控件，由一個文本框和兩個按鈕（OK和Cancel）組成，用戶單擊OK按鈕或按下Enter鍵后，在父窗口可以接收通過QInputDialog輸入的信息。
QInputDialog.getInt從控件中獲取標準整型輸入
QInputDialog.getItem從控件中獲取列表的選項輸入
QInputDialog.getText從控件中獲取標準字符串輸入
QInputDialog.getDouble從控件中獲取標準浮點數輸入

import sys
from PyQt5.QtWidgets import QApplication, QInputDialog, QWidget, QPushButton

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button = QPushButton("OK", self)

        self.resize(800, 600)
        button.clicked.connect(self.onOKClicked)

    def onOKClicked(self):
        items = ["C++", "Python", "Java", "Go"]
        item, ok = QInputDialog.getItem(self, "Select an Item", "Programing Language", items, 0, False)
        if ok and item:
            print("selected item: ", item)

        text, ok = QInputDialog.getText(self, "Input an text", "text:")
        if ok:
            print("input text: ", text)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

4、QFontDialog

QFontDialog是字體選擇對話框，可以讓用戶選擇所顯示的文本的字號大小、樣式和格式。QFontDialog.getFont可以從字體選擇對話框中獲取文本的顯示字號、樣式和格式。

import sys
from PyQt5.QtWidgets import QApplication, QFontDialog, QWidget, QPushButton
from PyQt5.QtGui import QFont

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button = QPushButton("OK", self)

        self.resize(800, 600)
        button.clicked.connect(self.onOKClicked)

    def onOKClicked(self):
        font, ok = QFontDialog.getFont()
        if ok:
            print(font.family(), font.pointSize())

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())

5、QFileDialog

QFileDialog是用于打開和保存文件的標準對話框，QFileDialog在打開文件時使用文件過濾器，用于顯示指定擴展名的文件。

import sys
from PyQt5.QtWidgets import QApplication, QFileDialog, QWidget, QPushButton

class MainWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        button = QPushButton("OK", self)

        self.resize(800, 600)
        button.clicked.connect(self.onOKClicked)

    def onOKClicked(self):
        fname, _ = QFileDialog.getOpenFileName(self, "Open file", '/', "Images(*.jpg *.gif)")
        print(fname)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MainWidget()
    window.resize(400, 200)
    window.show()

    sys.exit(app.exec_())