{"id":4912,"date":"2022-09-19T08:47:26","date_gmt":"2022-09-19T08:47:26","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=4912"},"modified":"2022-10-29T07:40:00","modified_gmt":"2022-10-29T07:40:00","slug":"pyqt-qlabel","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/pyqt\/pyqt-qlabel\/","title":{"rendered":"PyQt QLabel"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn how to use the PyQt QLabel<\/code> widget to display text or an image.<\/p>\n\n\n\n

Introduction to the PyQt QLabel Widget #<\/a><\/h2>\n\n\n\n

The QLabel<\/code> class allows you to create a label widget that displays text, an image, or an animated image (GIF).<\/p>\n\n\n\n

To create a label widget, you follow these steps:<\/p>\n\n\n\n

First, import the QLabel<\/code> widget from PyQt6.QtWidgets<\/code> module:<\/p>\n\n\n

from<\/span> PyQt6.QtWidgets import<\/span> QLabel<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Second, create a new instance of the QLabel<\/code> class:<\/p>\n\n\n
label = QLabel('This is QLabel widget'<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
In this syntax, you pass a string that you want to display to the QLabel<\/code>. <\/p>\n\n\n\n
Also, you can use the setText()<\/code> method to set a text to the QLabel<\/code> widget after creating the QLabel<\/code> widget:<\/p>\n\n\n
label = QLabel()\nlabel.setText('This is QLabel widget'<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
To get the text of the QLabel<\/code>()<\/code> widget, you call the text()<\/code> method:<\/p>\n\n\n
label.text()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
To clear the text of a QLabel<\/code> widget, you use the clear()<\/code> method:<\/p>\n\n\n
label.clear()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
PyQt QLabel widget example #<\/a><\/h2>\n\n\n\n
The following program shows a window that displays a QLabel<\/code> widget:<\/p>\n\n\n
import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget, QLabel, QVBoxLayout\nfrom<\/span> PyQt6.QtGui import<\/span> QFont\n\n\nclass<\/span> MainWindow<\/span>(QWidget)<\/span>:<\/span>\n    def<\/span> __init__<\/span>(self, *args, **kwargs)<\/span>:<\/span>\n        super().__init__(*args, **kwargs)\n\n        self.setWindowTitle('PyQt Label Widget'<\/span>)\n        self.setGeometry(100<\/span>, 100<\/span>, 320<\/span>, 210<\/span>)\n\n        # create a QLabel widget<\/span>\n        label = QLabel('This is a QLabel widget'<\/span>)\n\n        # place the widget on the window<\/span>\n        layout = QVBoxLayout()\n        layout.addWidget(label)\n        self.setLayout(layout)\n\n        # show the window<\/span>\n        self.show()\n\n\nif<\/span> __name__ == '__main__'<\/span>:\n    app = QApplication(sys.argv)\n\n    # create the main window<\/span>\n    window = MainWindow()\n\n    # start the event loop<\/span>\n    sys.exit(app.exec())<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"PyQt<\/figure>\n\n\n\n
Using the PyQt QLabel widget to display an image #<\/a><\/h2>\n\n\n\n
To display an image using the QLabel<\/code> widget, you do the following steps:<\/p>\n\n\n\n
First, import QPixmap<\/code> from PyQt6.QtGui<\/code> module:<\/p>\n\n\n
from<\/span> PyQt6.QtGui import<\/span> QPixmap<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Second, create a new QPixmap<\/code> widget with a path to an image file:<\/p>\n\n\n
pixmap = QPixmap('python-logo.svg'<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Note that the python-logo.svg<\/code> file must be in the same directory as the python program<\/p>\n\n\n\n
Third, create a QLabel<\/code> widget and call the setPixmap()<\/code> method to display the image:<\/p>\n\n\n
label = QLabel()\nlabel.setPixmap(pixmap)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
The following program shows how to display an image using a QLabel<\/code> widget:<\/p>\n\n\n
import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget, QLabel, QVBoxLayout\nfrom<\/span> PyQt6.QtGui import<\/span> QPixmap\n\n\nclass<\/span> MainWindow<\/span>(QWidget)<\/span>:<\/span>\n    def<\/span> __init__<\/span>(self, *args, **kwargs)<\/span>:<\/span>\n        super().__init__(*args, **kwargs)\n\n        self.setWindowTitle('PyQt Label Widget'<\/span>)\n        self.setGeometry(100<\/span>, 100<\/span>, 320<\/span>, 210<\/span>)\n\n        label = QLabel()\n        pixmap = QPixmap('python-logo.png'<\/span>)\n        label.setPixmap(pixmap)\n\n        # place the widget on the window<\/span>\n        layout = QVBoxLayout()\n        layout.addWidget(label)\n        self.setLayout(layout)\n\n        # show the window<\/span>\n        self.show()\n\n\nif<\/span> __name__ == '__main__'<\/span>:\n    app = QApplication(sys.argv)\n\n    # create the main window<\/span>\n    window = MainWindow()\n\n    # start the event loop<\/span>\n    sys.exit(app.exec())<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
The QPixmap<\/code> widget supports the following popular image formats including bmp, gif, jpg, jpeg, png, etc.<\/p>\n\n\n\n
Using the PyQt QLabel widget to display an animated image #<\/a><\/h2>\n\n\n\n
To create a movie, you can follow these steps:<\/p>\n\n\n\n
First, import QMovie<\/code> from PyQt6.QtGui<\/code> module:<\/p>\n\n\n
from<\/span> PyQt6.QtGui import<\/span> QMovie<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Second, create a QMovie<\/code> object with a path to the GIF file:<\/p>\n\n\n
movie = QMovie('python.gif'<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Third, create a new QLabel<\/code> widget:<\/p>\n\n\n
label = QLabel(self)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Fourth, set the movie to the QLabel<\/code> widget by calling the setMovie()<\/code> method:<\/p>\n\n\n
label.setMovie(movie)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Finally, call the start()<\/code> method of the QMovie<\/code> object to show the movie:<\/p>\n\n\n
movie.start()<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
The following program shows how to display a movie using the QLabel<\/code> & QMovie<\/code> widgets:<\/p>\n\n\n
import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget, QLabel, QVBoxLayout\nfrom<\/span> PyQt6.QtGui import<\/span> QMovie\n\n\nclass<\/span> MainWindow<\/span>(QWidget)<\/span>:<\/span>\n    def<\/span> __init__<\/span>(self, *args, **kwargs)<\/span>:<\/span>\n        super().__init__(*args, **kwargs)\n\n        self.setWindowTitle('PyQt QLabel Widget'<\/span>)\n        self.setGeometry(100<\/span>, 100<\/span>, 320<\/span>, 210<\/span>)        \n\n        label = QLabel()\n        movie = QMovie('python.gif'<\/span>)\n        label.setMovie(movie)\n        movie.start()\n\n        # place the widget on the window<\/span>\n        layout = QVBoxLayout()\n        layout.addWidget(label)\n        self.setLayout(layout)\n\n        # show the window<\/span>\n        self.show()\n\n\nif<\/span> __name__ == '__main__'<\/span>:\n    app = QApplication(sys.argv)\n\n    # create the main window<\/span>\n    window = MainWindow()\n\n    # start the event loop<\/span>\n    sys.exit(app.exec())<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Summary #<\/a><\/h2>\n\n\n\n
  • Use a PyQt QLabel<\/code> widget to display a text or an image including an animated image.<\/li><\/ul>\n
    \n\t
    \n\t\t
    Was this tutorial helpful ?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t