在 PyQt4 教程的这一部分中,我们将学习一些基本功能。
简单的例子
这是一个显示小窗口的简单示例。然而我们可以利用这个窗口做很多事情。我们可以调整它的大小、最大化它或最小化它。这需要大量的编码。有人已经编写了此功能的代码。由于它在大多数应用程序中都会重复,因此无需重新编码。PyQt4 是一个高级工具包。如果我们在较低级别的工具包中进行编码,下面的代码示例可能很容易就有数百行。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
In this example, we create a simple
window in PyQt4.
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui
def main():
app = QtGui.QApplication(sys.argv)
w = QtGui.QWidget()
w.resize(250, 150)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
上面的代码在屏幕上显示了一个小窗口。
import sys
from PyQt4 import QtGui
在这里我们提供必要的进口。基本的 GUI 小部件位于QtGui模块中。
app = QtGui.QApplication(sys.argv)
每个 PyQt4 应用程序都必须创建一个应用程序对象。应用程序对象位于QtGui模块中。该sys.argv参数是来自命令行的参数列表。Python 脚本可以从 shell 运行。这是我们控制脚本启动的一种方法。
w = QtGui.QWidget()
小QtGui.QWidget部件是 PyQt4 中所有用户界面对象的基类。我们为 提供默认构造函数QtGui.QWidget。默认构造函数没有父级。没有父窗口部件的窗口部件称为窗口。
w.resize(250, 150)
该resize方法调整小部件的大小。它的宽度为 250 像素,高度为 150 像素。
w.move(300, 300)
该move方法将小部件移动到屏幕上 x=300 和 y=300 坐标处的位置。
w.setWindowTitle('Simple')
在这里我们设置窗口的标题。标题显示在标题栏中。
w.show()
该show方法在屏幕上显示小部件。小部件首先在内存中创建,然后显示在屏幕上。
sys.exit(app.exec_())
最后,我们进入应用程序的主循环。事件处理从此时开始。主循环从窗口系统接收事件并将它们分派到应用程序小部件。exit 如果我们调用该方法或者主窗口部件被销毁,主循环就会结束。该sys.exit方法确保干净退出。环境将被告知应用程序如何结束。
该exec_方法有一个下划线。这是因为exec是 Python 关键字。因此,exec_ 被使用。
应用程序图标
应用程序图标是一个小图像,通常显示在标题栏的左上角。在下面的示例中,我们将展示如何在 PyQt4 中执行此操作。我们还将介绍一些新方法。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This example shows an icon
in the titlebar of the window.
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('web.png'))
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
前面的示例是以过程风格编码的。Python 编程语言支持面向过程和面向对象的编程风格。使用 PyQt4 编程意味着使用 OOP 编程。
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
...
面向对象编程中最重要的三件事是类、数据和方法。这里我们创建一个名为 的新类Example。类Example继承自QtGui.QWidget类。这意味着我们调用两个构造函数:第一个用于类Example ,第二个用于继承类。该super 方法返回该类的父对象Example,我们调用它的构造函数。该__init__方法是Python中的构造函数方法。
self.initUI()
GUI 的创建委托给该initUI方法。
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Icon')
self.setWindowIcon(QtGui.QIcon('web.png'))
所有三个方法都是从该类继承的QtGui.QWidget。它setGeometry做了两件事。它在屏幕上定位窗口并设置其大小。前两个参数是窗口的 x 和 y 位置。第三个是窗口的宽度,第四个是窗口的高度。事实上,它将resize 和move方法结合在一种方法中。最后一个方法设置应用程序图标。为此,我们创建了一个QtGui.QIcon对象。接收QtGui.QIcon 要显示的图标的路径。
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
启动代码已放在main方法中。这是Python 的习惯用法。
显示工具提示
我们可以为任何小部件提供气球帮助。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This example shows a tooltip on
a window and a button
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
QtGui.QToolTip.setFont(QtGui.QFont('SansSerif', 10))
self.setToolTip('This is a <b>QWidget</b> widget')
btn = QtGui.QPushButton('Button', self)
btn.setToolTip('This is a <b>QPushButton</b> widget')
btn.resize(btn.sizeHint())
btn.move(50, 50)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Tooltips')
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在此示例中,我们显示了两个 PyQt4 小部件的工具提示。
QtGui.QToolTip.setFont(QtGui.QFont('SansSerif', 10))
此静态方法设置用于呈现工具提示的字体。我们使用 10pt SansSerif 字体。
self.setToolTip('This is a <b>QWidget</b> widget')
要创建工具提示,我们调用该setTooltip方法。我们还可以使用富文本格式。
btn = QtGui.QPushButton('Button', self)
btn.setToolTip('This is a <b>QPushButton</b> widget')
我们创建一个按钮小部件并为其设置工具提示。
btn.resize(btn.sizeHint())
btn.move(50, 50)
正在调整按钮的大小并在窗口上移动。该sizeHint 方法给出了按钮的推荐尺寸。
关闭窗口
关闭窗口的最明显方法是单击标题栏上的 x 标记。在下一个示例中,我们将展示如何以编程方式关闭窗口。我们将简要介绍一下信号和槽。
下面是我们将在示例中使用的QtGui.QPushButton的构造函数。
QPushButton(string text, QWidget parent = None)
该text参数是将显示在按钮上的文本。这parent是一个我们放置按钮的小部件。在我们的例子中,它将是一个QtGui.QWidget。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This program creates a quit
button. When we press the button,
the application terminates.
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui, QtCore
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
qbtn = QtGui.QPushButton('Quit', self)
qbtn.clicked.connect(QtCore.QCoreApplication.instance().quit)
qbtn.resize(qbtn.sizeHint())
qbtn.move(50, 50)
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Quit button')
self.show()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
在此示例中,我们创建一个退出按钮。单击该按钮后,应用程序将终止。
from PyQt4 import QtGui, QtCore
QtCore需要模块中的一个对象。因此,我们导入该模块。
qbtn = QtGui.QPushButton('Quit', self)
我们创建一个按钮。该按钮是该类的一个实例QtGui.QPushButton 。构造函数的第一个参数是按钮的标签。第二个参数是父窗口小部件。父窗口部件是 Example窗口部件,它是QtGui.QWidget通过继承的。
qbtn.clicked.connect(QtCore.QCoreApplication.instance().quit)
PyQt4中的事件处理系统是用信号和槽机制构建的。如果我们点击按钮,clicked就会发出信号。该槽可以是 Qt 槽或任何 Python 可调用槽。包含QtCore.QCoreApplication主事件循环。它处理并分派所有事件。该instance方法为我们提供了它的当前实例。请注意,这QtCore.QCoreApplication是使用QtGui.QApplication. 单击的信号连接到quit 终止应用程序的方法。通信在两个对象之间完成:发送者和接收者。发送者是按钮,接收者是应用程序对象。
留言箱
默认情况下,如果我们单击标题栏上的 x 按钮,则QtGui.QWidget关闭。有时我们想修改这种默认行为。例如,如果我们在编辑器中打开一个文件并对其进行了一些更改。我们显示一个消息框来确认操作。
#!/usr/bin/python
"""
ZetCode PyQt4 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
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.setGeometry(300, 300, 250, 150)
self.setWindowTitle('Message box')
self.show()
def closeEvent(self, event):
reply = QtGui.QMessageBox.question(self, 'Message',
"Are you sure to quit?", QtGui.QMessageBox.Yes |
QtGui.QMessageBox.No, QtGui.QMessageBox.No)
if reply == QtGui.QMessageBox.Yes:
event.accept()
else:
event.ignore()
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
如果我们关闭一个QtGui.QWidget,就会生成一个QtGui.QCloseEvent。要修改小部件行为,我们需要重新实现closeEvent事件处理程序。
reply = QtGui.QMessageBox.question(self, 'Message',
"Are you sure to quit?", QtGui.QMessageBox.Yes |
QtGui.QMessageBox.No, QtGui.QMessageBox.No)
我们显示一个带有两个按钮的消息框:是和否。第一个字符串出现在标题栏上。第二个字符串是对话框显示的消息文本。第三个参数指定对话框中出现的按钮组合。最后一个参数是默认按钮。它是最初具有键盘焦点的按钮。返回值存储在reply变量中。
if reply == QtGui.QMessageBox.Yes:
event.accept()
else:
event.ignore()
这里我们测试一下返回值。如果单击“是”按钮,我们将接受导致小部件关闭并终止应用程序的事件。否则我们会忽略关闭事件。
使窗口在屏幕上居中
以下脚本显示了如何使窗口在桌面屏幕上居中。
#!/usr/bin/python
"""
ZetCode PyQt4 tutorial
This program centers a window
on the screen.
author: Jan Bodnar
website: zetcode.com
"""
import sys
from PyQt4 import QtGui
class Example(QtGui.QWidget):
def __init__(self):
super(Example, self).__init__()
self.initUI()
def initUI(self):
self.resize(250, 150)
self.center()
self.setWindowTitle('Center')
self.show()
def center(self):
qr = self.frameGeometry()
cp = QtGui.QDesktopWidget().availableGeometry().center()
qr.moveCenter(cp)
self.move(qr.topLeft())
def main():
app = QtGui.QApplication(sys.argv)
ex = Example()
sys.exit(app.exec_())
if __name__ == '__main__':
main()
该类QtGui.QDesktopWidget提供有关用户桌面的信息,包括屏幕尺寸。
self.center()
将窗口居中的代码放置在自定义 center方法中。
qr = self.frameGeometry()
我们得到一个指定主窗口几何形状的矩形。这包括任何窗框。
cp = QtGui.QDesktopWidget().availableGeometry().center()
我们计算出显示器的屏幕分辨率。从这个分辨率中,我们得到了中心点。
qr.moveCenter(cp)
我们的矩形已经有了它的宽度和高度。现在我们将矩形的中心设置为屏幕的中心。矩形的大小不变。
self.move(qr.topLeft())
我们将应用程序窗口的左上角移动到 qr 矩形的左上角,从而使窗口在屏幕上居中。
在 PyQt4 教程的这一部分中,我们介绍了一些基础知识。