PyQt QLabel

last modified July 9, 2020

PyQt QLabel tutorial shows how to work with QLabel widget.

Sources are available at PyQt-Examples repository. Visit Advanced PyQt5 e-book, read PyQt5 tutorial, or list all PyQt tutorials.

QLabel

QLabel is a widget which displays text or image. No user interaction functionality is provided. By default, labels display left-aligned, vertically-centered text and images.

QLabel text labels

The following example shows text labels on the window.

#!/usr/bin/python

import sys
from PyQt5.QtWidgets import QWidget, QLabel, QApplication, QHBoxLayout

class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        hbox = QHBoxLayout()

        hbox.addWidget(QLabel("falcon"))
        hbox.addWidget(QLabel("owl"))
        hbox.addWidget(QLabel("eagle"))
        hbox.addWidget(QLabel("skylark"))

        self.setLayout(hbox)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('QLabel')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

In the example, we place four labels in a horizontal box.

QLabel images

The following example uses QLabel to display images. To display an image on a label, we also use the QPixmap.

#!/usr/bin/python


import sys
from PyQt5.QtWidgets import QWidget, QLabel, QApplication, QHBoxLayout
from PyQt5.QtGui import QPixmap


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        hbox = QHBoxLayout()

        lbl1 = QLabel()
        lbl1.setPixmap(QPixmap("cpu.png"))

        lbl2 = QLabel()
        lbl2.setPixmap(QPixmap("drive.png"))

        lbl3 = QLabel()
        lbl3.setPixmap(QPixmap("laptop.png"))

        lbl4 = QLabel()
        lbl4.setPixmap(QPixmap("player.png"))

        hbox.addWidget(lbl1)
        hbox.addWidget(lbl2)
        hbox.addWidget(lbl3)
        hbox.addWidget(lbl4)

        self.setLayout(hbox)

        self.move(300, 300)
        self.setWindowTitle('Images')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

Four PNG images are shown on the window. An image is set on a label with the setPixmap function.

QLabel colours

In the following example, we use labels to display various colours.

#!/usr/bin/python


import sys
from PyQt5.QtWidgets import QWidget, QLabel, QApplication, QGridLayout
from PyQt5.QtGui import QPixmap


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):

        grid = QGridLayout()

        lbl1 = QLabel()
        lbl1.setStyleSheet("background-color:firebrick; border-radius:5px")

        lbl2 = QLabel()
        lbl2.setStyleSheet("background-color:gold; border-radius:5px")
        
        lbl3 = QLabel()
        lbl3.setStyleSheet("background-color:seagreen; border-radius:5px")

        lbl4 = QLabel()
        lbl4.setStyleSheet("background-color:royalblue; border-radius:5px")

        lbl5 = QLabel()
        lbl5.setStyleSheet("background-color:crimson; border-radius:5px")

        lbl6 = QLabel()
        lbl6.setStyleSheet("background-color:salmon; border-radius:5px")

        lbl7 = QLabel()
        lbl7.setStyleSheet("background-color:deeppink; border-radius:5px")

        lbl8 = QLabel()
        lbl8.setStyleSheet("background-color:tomato; border-radius:5px")

        lbl9 = QLabel()
        lbl9.setStyleSheet("background-color:darkkhaki; border-radius:5px")

        lbl10 = QLabel()
        lbl10.setStyleSheet("background-color:cornflowerblue; border-radius:5px")

        lbl11 = QLabel()
        lbl11.setStyleSheet("background-color:rosybrown; border-radius:5px")

        lbl12 = QLabel()
        lbl12.setStyleSheet("background-color:chocolate; border-radius:5px")

        lbl13 = QLabel()
        lbl13.setStyleSheet("background-color:slategray; border-radius:5px")

        grid.addWidget(lbl1, 0, 0)
        grid.addWidget(lbl2, 0, 1)
        grid.addWidget(lbl3, 0, 2)
        grid.addWidget(lbl4, 0, 3)
        grid.addWidget(lbl5, 1, 0)
        grid.addWidget(lbl6, 1, 1)
        grid.addWidget(lbl8, 1, 2)
        grid.addWidget(lbl9, 1, 3)
        grid.addWidget(lbl10, 2, 0)
        grid.addWidget(lbl11, 2, 1)
        grid.addWidget(lbl12, 2, 2)
        grid.addWidget(lbl13, 2, 3)

        self.setLayout(grid)

        self.setGeometry(300, 300, 420, 200)
        self.setWindowTitle('Colours')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

In the example, we display twelve coloured rounded rectangles.

lbl1 = QLabel()
lbl1.setStyleSheet("background-color:firebrick; border-radius:5px")

A colour is set with the setStyleSheet function. We also change the border radius.

QLabel hyperlink

QLabel can be used to create a hyperlink.

#!/usr/bin/python

import sys
from PyQt5.QtWidgets import QWidget, QLabel, QApplication, QHBoxLayout
from PyQt5.QtCore import Qt


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        
        hbox = QHBoxLayout()

        link = QLabel('<a href="http://zetcode.com">zetcode.com</a>')
        link.setOpenExternalLinks(True)

        hbox.addWidget(link)

        self.setLayout(hbox)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('HTML link')
        self.show()


def main():

    app = QApplication(sys.argv)
    ex = Example()
    sys.exit(app.exec_())


if __name__ == '__main__':
    main()

In the example, we pass an HTML anchor to the label. The setOpenExternalLinks function automatically opens the provided link upon being clicked.

In this tutorial, we have presented the PyQt QLabel widget.

List all PyQt tutorials.