QPaintEvent Class

Die Klasse QPaintEvent enthält Ereignisparameter für Malereignisse. Mehr...

Kopfzeile: #include <QPaintEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Vererbungen: QEvent

Öffentliche Funktionen

QPaintEvent(const QRect &paintRect)
QPaintEvent(const QRegion &paintRegion)
const QRect &rect() const
const QRegion &region() const

Detaillierte Beschreibung

Paint-Ereignisse werden an Widgets gesendet, die sich selbst aktualisieren müssen, zum Beispiel wenn ein Teil eines Widgets freigelegt wird, weil ein überlagerndes Widget verschoben wurde.

Das Ereignis enthält eine region(), die aktualisiert werden muss, und eine rect(), die das Begrenzungsrechteck dieses Bereichs darstellt. Beide werden zur Verfügung gestellt, da viele Widgets nicht viel Gebrauch von region() machen können und rect() viel schneller sein kann als region().boundingRect().

Automatisches Beschneiden

Das Malen wird während der Verarbeitung eines Malereignisses auf region() beschnitten. Dieses Clipping wird vom Qt-Paint-System durchgeführt und ist unabhängig von jeglichem Clipping, das auf QPainter angewendet werden kann, um auf dem Paint-Gerät zu zeichnen.

Infolgedessen spiegelt der von QPainter::clipRegion() zurückgegebene Wert auf einem neu konstruierten QPainter nicht die Clip-Region wider, die vom Malsystem verwendet wird.

Siehe auch QPainter, QWidget::update(), QWidget::repaint(), und QWidget::paintEvent().

Dokumentation der Mitgliedsfunktionen

[explicit] QPaintEvent::QPaintEvent(const QRect &paintRect)

Konstruiert ein Malereignisobjekt mit dem Rechteck, das aktualisiert werden muss. Der Bereich wird durch paintRect festgelegt.

[explicit] QPaintEvent::QPaintEvent(const QRegion &paintRegion)

Konstruiert ein Paint-Event-Objekt mit der Region, die aktualisiert werden muss. Der Bereich wird durch paintRegion angegeben.

const QRect &QPaintEvent::rect() const

Gibt das Rechteck zurück, das aktualisiert werden muss.

Siehe auch region() und QPainter::setClipRect().

const QRegion &QPaintEvent::region() const

Gibt die Region zurück, die aktualisiert werden muss.

Siehe auch rect() und QPainter::setClipRegion().

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.