На этом шаге мы рассмотрим вывод в окно форматированного текста.
Класс QGraphicsTextItem описывает форматированный текст. Иерархия наследования:
(QObject, QGraphicsItem) - QGraphicsObject - QGraphicsTextItem
Форматы конструктора класса:
<Объект> = QGraphicsTextItem([parent=None]) <Объект> = QGraphicsTextItem(<Текст>[, parent=None])
В параметре parent можно указать ссылку на родительский объект.
Класс QGraphicsTextItem наследует все методы из базовых классов и поддерживает следующие методы (здесь приведены только основные - полный их список доступен на странице https://doc.qt.io/qt-5/qgraphicstextitem.html):
- setPlainText (<Простой текст>) - задает простой текст;
- toPlainText () - возвращает простой текст;
- setHtml (<HTML-код>) - задает форматированный текст в виде HTML-кода;
- toHtml () - возвращает форматированный текст в виде HTML-кода;
- setFont (<QFont>) - устанавливает шрифт;
- font () - возвращает описывающий установленный шрифт экземпляр класса QFont;
- setDefaultTextColor (<QColor>) - задает цвет текста по умолчанию;
- defaultTextColor () - возвращает цвет текста по умолчанию;
- setTextWidth (<Ширина>) - задает предпочитаемую ширину строки. Если текст не помещается в установленную ширину, то он будет перенесен на новую строку;
- textwidth () - возвращает предпочитаемую ширину текста;
- setDocument (<QTextDocument>) - задает объект документа в виде экземпляра класса QTextDocument (см. 112 шаг);
- document () - возвращает ссылку на объект документа (экземпляр класса QTextDocument; см. (см. 112 шаг);
- setTextCursor (<QTextCursor>) - устанавливает объект курсора в виде экземпляра класса QTextCursor (см. 114 шаг);
- textCursor () - возвращает объект курсора (экземпляр класса QtextCursor - см. 114 шаг);
- setTextInteractionFlags (<Режим>) - задает режим взаимодействия пользователя с текстом. По умолчанию используется режим NoTextInteraction, при котором пользователь
не может взаимодействовать с текстом. Допустимые режимы перечислены на 99 шаге (см. описание метода setTextInteractionFlags());
- setTabChangesFocus (<Флаг>) - если в качестве параметра указано значение False, то нажатием клавиши Tab можно будет вставить в текст символ табуляции.
Если указано значение True, клавиша Tab станет использоваться для передачи фокуса;
- setOpenExternalLinks (<Флаг>) - если в качестве параметра указано значение True, щелчок на гиперссылке приведет к открытию браузера, используемого в системе по умолчанию, и загрузке страницы с указанным в гиперссылке URL-адресом. Метод работает только при использовании режима TextBrowserInteraction.
Класс QGraphicsTextItem поддерживает следующие сигналы:
- linkActivated (<URL>) - генерируется при переходе по гиперссылке. Через параметр внутри обработчика доступен URL-адрес гиперссылки в виде строки;
- linkHovered (<URL>) - генерируется при наведении указателя мыши на гиперссылку. Через параметр внутри обработчика доступен URL-адрес гиперссылки в виде строки.
Изменим программу, приведенную на предыдущем шаге: вместо обычного текста используем форматированный. Ниже приведен текст приложения (начало и конец изменений отмечены комментариями):
from PyQt5 import QtGui from PyQt5.QtWidgets import QApplication, QMainWindow, QGraphicsScene, QGraphicsView, QGraphicsItem, QGraphicsPixmapItem, QGraphicsTextItem from PyQt5.QtGui import QPixmap, QPainter, QFont from PyQt5.Qt import Qt import sys class Window(QMainWindow): def __init__(self): super().__init__() self.title = "Изображение в PyQt5" self.top = 200 self.left = 500 self.width = 400 self.height = 400 self.setWindowTitle(self.title) # Задание местоположения и размера окна self.setGeometry(self.left, self.top, self.width, self.height) # Создание графической сцены self.scene = QGraphicsScene() # Создание инструмента для отрисовки графической сцены self.graphicView = QGraphicsView(self.scene, self) # Задание местоположения и размера графической сцены self.graphicView.setGeometry(0, 0, self.width, self.height) def plot(self): # Создание объекта QPixmap picture = QPixmap('IMG2.jpg') # Создание "пустого" объекта QGraphicsPixmapItem image = QGraphicsPixmapItem() # Задание изображения в объект QGraphicsPixmapItem image.setPixmap(picture) # Позиция объекта QGraphicsPixmapItem image.setOffset(0, 0) # Добавление объекта QGraphicsPixmapItem на сцену self.scene.addItem(image) # ======= Начало изменений =========== # Создание объекта QGraphicsTextItem text = QGraphicsTextItem('Пример текста') # Задание шрифта и его параметров font = QFont('Courier New', pointSize=20, weight=900) # Добавление шрифта в объект текста text.setFont(font) # ======= Конец изменений ============= # Задание позиции текста text.setX(0) text.setY(200) # Добавление текста на сцену self.scene.addItem(text) App = QApplication(sys.argv) window = Window() window.show() # Демонстрация окна window.plot() # Построение и перерисовка окна sys.exit(App.exec())
Результат работы приложения изображен на рисунке 1.
Рис.1. Результат работы приложения
На следующем шаге мы рассмотрим группировку объектов.
