摘要：控件是一個用戶界面的基本控件，它提供了基本的應(yīng)用構(gòu)造器。默認情況下，構(gòu)造器是沒有父級的，沒有父級的構(gòu)造器被稱為窗口。這就意味著，我們調(diào)用了兩個構(gòu)造器，一個是這個類本身的，一個是這個類繼承的。構(gòu)造器方法返回父級的對象。

這個簡單的小例子展示的是一個小窗口。但是我們可以在這個小窗口上面做很多事情，改變大小，最大化，最小化等，這需要很多代碼才能實現(xiàn)。這在很多應(yīng)用中很常見，沒必要每次都要重寫這部分代碼，Qt已經(jīng)提供了這些功能。PyQt5是一個高級的工具集合，相比使用低級的工具，能省略上百行代碼。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

In this example, we create a simple
window in PyQt5.

author: Jan Bodnar
website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QApplication, QWidget


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

    w = QWidget()
    w.resize(250, 150)
    w.move(300, 300)
    w.setWindowTitle("Simple")
    w.show()
    
    sys.exit(app.exec_())

運行上面的代碼，能展示出一個小窗口。

import sys
from PyQt5.QtWidgets import QApplication, QWidget

這里引入了PyQt5.QtWidgets模塊，這個模塊包含了基本的組件。

app = QApplication(sys.argv)

每個PyQt5應(yīng)用都必須創(chuàng)建一個應(yīng)用對象。sys.argv是一組命令行參數(shù)的列表。Python可以在shell里運行，這個參數(shù)提供對腳本控制的功能。

w = QWidget()

QWidge控件是一個用戶界面的基本控件，它提供了基本的應(yīng)用構(gòu)造器。默認情況下，構(gòu)造器是沒有父級的，沒有父級的構(gòu)造器被稱為窗口（window）。

w.resize(250, 150)

resize()方法能改變控件的大小，這里的意思是窗口寬250px，高150px。

w.move(300, 300)

move()是修改控件位置的的方法。它把控件放置到屏幕坐標的(300, 300)的位置。注：屏幕坐標系的原點是屏幕的左上角。

w.setWindowTitle("Simple")

我們給這個窗口添加了一個標題，標題在標題欄展示（雖然這看起來是一句廢話，但是后面還有各種欄，還是要注意一下，多了就蒙了）。

w.show()

show()能讓控件在桌面上顯示出來。控件在內(nèi)存里創(chuàng)建，之后才能在顯示器上顯示出來。

sys.exit(app.exec_())

最后，我們進入了應(yīng)用的主循環(huán)中，事件處理器這個時候開始工作。主循環(huán)從窗口上接收事件，并把事件傳入到派發(fā)到應(yīng)用控件里。當調(diào)用exit()方法或直接銷毀主控件時，主循環(huán)就會結(jié)束。sys.exit()方法能確保主循環(huán)安全退出。外部環(huán)境能通知主控件怎么結(jié)束。

exec_()之所以有個下劃線，是因為exec是一個Python的關(guān)鍵字。

程序預(yù)覽：

窗口圖標通常是顯示在窗口的左上角，標題欄的最左邊。下面的例子就是怎么用PyQt5創(chuàng)建一個這樣的窗口。

在某些環(huán)境下，圖標顯示不出來。如果你遇到了這個問題，看我在Stackoverfolw的回答

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This example shows an icon
in the titlebar of the window.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import QApplication, QWidget
from PyQt5.QtGui import QIcon


class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):
        
        self.setGeometry(300, 300, 300, 220)
        self.setWindowTitle("Icon")
        self.setWindowIcon(QIcon("web.png"))        
    
        self.show()
        
        
if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

前一個例子是使用的過程式編程。Python還支持面向?qū)ο蟮木幊蹋?/p>

class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        ...

面向?qū)ο缶幊套钪匾娜齻€部分是類(class)、數(shù)據(jù)和方法。我們創(chuàng)建了一個類的調(diào)用，這個類繼承自QWidget。這就意味著，我們調(diào)用了兩個構(gòu)造器，一個是這個類本身的，一個是這個類繼承的。super()構(gòu)造器方法返回父級的對象。__init__()方法是構(gòu)造器的一個方法。

self.initUI() 

使用initUI()方法創(chuàng)建一個GUI。

# 自己準備一個web.png
self.setGeometry(300, 300, 300, 220)
self.setWindowTitle("Icon")
self.setWindowIcon(QIcon("web.png"))  

上面的三個方法都繼承自QWidget類。setGeometry()有兩個作用：把窗口放到屏幕上并且設(shè)置窗口大小。參數(shù)分別代表屏幕坐標的x、y和窗口大小的寬、高。也就是說這個方法是resize()和move()的合體。最后一個方法是添加了圖標。先創(chuàng)建一個QIcon對象，然后接受一個路徑作為參數(shù)顯示圖標。

if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

應(yīng)用和示例的對象創(chuàng)立，主循環(huán)開始。

程序預(yù)覽：

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This example shows a tooltip on 
a window and a button.

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

import sys
from PyQt5.QtWidgets import (QWidget, QToolTip, 
    QPushButton, QApplication)
from PyQt5.QtGui import QFont    


class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):
        
        QToolTip.setFont(QFont("SansSerif", 10))
        
        self.setToolTip("This is a QWidget widget")
        
        btn = QPushButton("Button", self)
        btn.setToolTip("This is a QPushButton widget")
        btn.resize(btn.sizeHint())
        btn.move(50, 50)       
        
        self.setGeometry(300, 300, 300, 200)
        self.setWindowTitle("Tooltips")    
        self.show()
        
        
if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

在這個例子中，我們?yōu)閼?yīng)用創(chuàng)建了一個提示框。

QToolTip.setFont(QFont("SansSerif", 10))

這個靜態(tài)方法設(shè)置了提示框的字體，我們使用了10px的SansSerif字體。

self.setToolTip("This is a QWidget widget")

調(diào)用setTooltip()創(chuàng)建提示框可以使用富文本格式的內(nèi)容。

btn = QPushButton("Button", self)
btn.setToolTip("This is a QPushButton widget")

創(chuàng)建一個按鈕，并且為按鈕添加了一個提示框。

btn.resize(btn.sizeHint())
btn.move(50, 50)

調(diào)整按鈕大小，并讓按鈕在屏幕上顯示出來，sizeHint()方法提供了一個默認的按鈕大小。

程序預(yù)覽：

關(guān)閉一個窗口最直觀的方式就是點擊標題欄的那個叉，這個例子里，我們展示的是如何用程序關(guān)閉一個窗口。這里我們將接觸到一點single和slots的知識。

本例使用的是QPushButton組件類。

QPushButton(string text, QWidget parent = None)

text參數(shù)是想要顯示的按鈕名稱，parent參數(shù)是放在按鈕上的組件，在我們的 例子里，這個參數(shù)是QWidget。應(yīng)用中的組件都是一層一層（繼承而來的？）的，在這個層里，大部分的組件都有自己的父級，沒有父級的組件，是頂級的窗口。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program creates a quit
button. When we press the button,
the application terminates. 

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

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


class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        qbtn = QPushButton("Quit", self)
        qbtn.clicked.connect(QCoreApplication.instance().quit)
        qbtn.resize(qbtn.sizeHint())
        qbtn.move(50, 50)       
        
        self.setGeometry(300, 300, 250, 150)
        self.setWindowTitle("Quit button")    
        self.show()
        
        
if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

這里創(chuàng)建了一個點擊之后就退出窗口的按鈕。

from PyQt5.QtCore import QCoreApplication

程序需要QtCore對象。

qbtn = QPushButton("Quit", self)

創(chuàng)建一個繼承自QPushButton的按鈕。第一個參數(shù)是按鈕的文本，第二個參數(shù)是按鈕的父級組件，這個例子中，父級組件就是我們創(chuàng)建的繼承自Qwidget的Example類。

qbtn.clicked.connect(QCoreApplication.instance().quit)

事件傳遞系統(tǒng)在PyQt5內(nèi)建的single和slot機制里面。點擊按鈕之后，信號會被捕捉并給出既定的反應(yīng)。QCoreApplication包含了事件的主循環(huán)，它能添加和刪除所有的事件，instance()創(chuàng)建了一個它的實例。QCoreApplication是在QApplication里創(chuàng)建的。 點擊事件和能終止進程并退出應(yīng)用的quit函數(shù)綁定在了一起。在發(fā)送者和接受者之間建立了通訊，發(fā)送者就是按鈕，接受者就是應(yīng)用對象。

程序預(yù)覽：

默認情況下，我們點擊標題欄的×按鈕，QWidget就會關(guān)閉。但是有時候，我們修改默認行為。比如，如果我們打開的是一個文本編輯器，并且做了一些修改，我們就會想在關(guān)閉按鈕的時候讓用戶進一步確認操作。

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program shows a confirmation 
message box when we click on the close
button of the application window. 

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

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


class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        self.setGeometry(300, 300, 250, 150)        
        self.setWindowTitle("Message box")    
        self.show()
        
        
    def closeEvent(self, event):
        
        reply = QMessageBox.question(self, "Message",
            "Are you sure to quit?", QMessageBox.Yes | 
            QMessageBox.No, QMessageBox.No)

        if reply == QMessageBox.Yes:
            event.accept()
        else:
            event.ignore()        
        
        
if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

如果關(guān)閉QWidget，就會產(chǎn)生一個QCloseEvent。改變控件的默認行為，就是替換掉默認的事件處理。

reply = QMessageBox.question(self, "Message",
    "Are you sure to quit?", QMessageBox.Yes | 
    QMessageBox.No, QMessageBox.No)

我們創(chuàng)建了一個消息框，上面有倆按鈕：Yes和No.第一個字符串顯示在消息框的標題欄，第二個字符串顯示在對話框，第三個參數(shù)是消息框的倆按鈕，最后一個參數(shù)是默認按鈕，這個按鈕是默認選中的。返回值在變量reply里。

if reply == QtGui.QMessageBox.Yes:
    event.accept()
else:
    event.ignore()

這里判斷返回值，如果點擊的是Yes按鈕，我們就關(guān)閉組件和應(yīng)用，否者就忽略關(guān)閉事件。

程序預(yù)覽：

#!/usr/bin/python3
# -*- coding: utf-8 -*-

"""
ZetCode PyQt5 tutorial 

This program centers a window 
on the screen. 

Author: Jan Bodnar
Website: zetcode.com 
Last edited: August 2017
"""

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


class Example(QWidget):
    
    def __init__(self):
        super().__init__()
        
        self.initUI()
        
        
    def initUI(self):               
        
        self.resize(250, 150)
        self.center()
        
        self.setWindowTitle("Center")    
        self.show()
        
        
    def center(self):
        
        qr = self.frameGeometry()
        cp = QDesktopWidget().availableGeometry().center()
        qr.moveCenter(cp)
        self.move(qr.topLeft())
        
        
if __name__ == "__main__":
    
    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())

QtGui.QDesktopWidget提供了用戶的桌面信息，包括屏幕的大小。

self.center()

這個方法是調(diào)用我們下面寫的，實現(xiàn)對話框居中的方法。

qr = self.frameGeometry()

得到了主窗口的大小。

cp = QDesktopWidget().availableGeometry().center()

獲取顯示器的分辨率，然后得到中間點的位置。

qr.moveCenter(cp)

然后把自己窗口的中心點放置到qr的中心點。

self.move(qr.topLeft())

然后把窗口的坐上角的坐標設(shè)置為qr的矩形左上角的坐標，這樣就把窗口居中了。

程序預(yù)覽：