QPaintEngineState Class
Die Klasse „QPaintEngineState“ liefert Informationen zum aktuellen Zustand der aktiven Zeichen-Engine. Mehr...
| Header: | #include <QPaintEngineState> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| QBrush | backgroundBrush() const |
| Qt::BGMode | backgroundMode() const |
| QBrush | brush() const |
| bool | brushNeedsResolving() const |
| QPointF | brushOrigin() const |
| Qt::ClipOperation | clipOperation() const |
| QPainterPath | clipPath() const |
| QRegion | clipRegion() const |
| QPainter::CompositionMode | compositionMode() const |
| QFont | font() const |
| bool | isClipEnabled() const |
| qreal | opacity() const |
| QPainter * | painter() const |
| QPen | pen() const |
| bool | penNeedsResolving() const |
| QPainter::RenderHints | renderHints() const |
| QPaintEngine::DirtyFlags | state() const |
| QTransform | transform() const |
Ausführliche Beschreibung
QPaintEngineState protokolliert, welche Eigenschaften sich seit der letzten Aktualisierung der Paint-Engine geändert haben, sowie deren aktuellen Wert.
Welche Eigenschaften sich geändert haben, lässt sich jederzeit mit der Funktion „ state()“ abfragen. Diese Funktion gibt eine Instanz des Typs „ QPaintEngine::DirtyFlags “ zurück, die eine OR-Verknüpfung von Werten des Typs „ QPaintEngine::DirtyFlag “ enthält. Die Enumeration „ QPaintEngine::DirtyFlag “ legt fest, ob sich eine Eigenschaft seit der letzten Aktualisierung geändert hat oder nicht.
Wenn eine Eigenschaft mit einem „dirty“-Flag markiert ist, kann ihr aktueller Wert mithilfe der entsprechenden get-Funktion abgerufen werden:
Die Klasse `QPaintEngineState` stellt außerdem die Funktion ` painter()` zur Verfügung, die einen Zeiger auf den Painter zurückgibt, der derzeit die Paint-Engine aktualisiert.
Eine Instanz dieser Klasse, die den aktuellen Zustand der aktiven Paint-Engine darstellt, wird als Argument an die Funktion ` QPaintEngine::updateState()` übergeben. Die einzige Situation, in der Sie diese Klasse direkt verwenden müssen, ist die Implementierung einer eigenen Paint-Engine.
Siehe auch ` QPaintEngine`.
Dokumentation zu den Mitgliedsfunktionen
QBrush QPaintEngineState::backgroundBrush() const
Gibt den Hintergrundpinsel im aktuellen Zustand der Mal-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyBackground “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
Qt::BGMode QPaintEngineState::backgroundMode() const
Gibt den Hintergrundmodus im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyBackgroundMode “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QBrush QPaintEngineState::brush() const
Gibt den Pinsel im aktuellen Zustand der Mal-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion ` state()` eine Kombination zurückgibt, die das Flag ` QPaintEngine::DirtyBrush ` enthält.
Siehe auch state() und QPaintEngine::updateState().
bool QPaintEngineState::brushNeedsResolving() const
Gibt zurück, ob die Koordinaten der Füllung so angegeben wurden, dass sie durch den aktuellen Darstellungsvorgang begrenzt sind und (bezüglich der aktuell dargestellten Primitive) aufgelöst werden müssen.
QPointF QPaintEngineState::brushOrigin() const
Gibt den Pinselursprung im aktuellen Zustand der Mal-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyBrushOrigin “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
Qt::ClipOperation QPaintEngineState::clipOperation() const
Gibt die Clip-Operation im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die entweder das Flag „ QPaintEngine::DirtyClipPath “ oder das Flag „ QPaintEngine::DirtyClipRegion “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QPainterPath QPaintEngineState::clipPath() const
Gibt den Clip-Pfad im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyClipPath “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QRegion QPaintEngineState::clipRegion() const
Gibt den Clip-Bereich im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyClipRegion “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QPainter::CompositionMode QPaintEngineState::compositionMode() const
Gibt den Kompositionsmodus im aktuellen Zustand der Zeichen-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyCompositionMode “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QFont QPaintEngineState::font() const
Gibt die Schriftart im aktuellen Zustand der Zeichen-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyFont “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
bool QPaintEngineState::isClipEnabled() const
Gibt zurück, ob im aktuellen Zustand der Paint-Engine das Clipping aktiviert ist oder nicht.
Diese Variable sollte nur verwendet werden, wenn die Funktion ` state()` eine Kombination zurückgibt, die das Flag ` QPaintEngine::DirtyClipEnabled ` enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
qreal QPaintEngineState::opacity() const
Gibt die Deckkraft im aktuellen Zustand der Mal-Engine zurück.
QPainter *QPaintEngineState::painter() const
Gibt einen Zeiger auf den Painter zurück, der derzeit die Paint-Engine aktualisiert.
QPen QPaintEngineState::pen() const
Gibt den Stift im aktuellen Zustand der Mal-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyPen “ enthält.
Siehe auch state() und QPaintEngine::updateState().
bool QPaintEngineState::penNeedsResolving() const
Gibt zurück, ob die Koordinaten des Strichs als durch den aktuellen Rendering-Vorgang begrenzt angegeben wurden und (bezüglich der aktuell gerenderten Primitive) aufgelöst werden müssen.
QPainter::RenderHints QPaintEngineState::renderHints() const
Gibt die Render-Hinweise im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyHints “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
QPaintEngine::DirtyFlags QPaintEngineState::state() const
Gibt eine Kombination von Flags zurück, die die Menge der Eigenschaften identifizieren, die bei der Aktualisierung des Zustands der Render-Engine (d. h. während eines Aufrufs der Funktion ` QPaintEngine::updateState()`) aktualisiert werden müssen.
Siehe auch ` QPaintEngine::updateState()`.
QTransform QPaintEngineState::transform() const
Gibt die Matrix im aktuellen Zustand der Paint-Engine zurück.
Diese Variable sollte nur verwendet werden, wenn die Funktion „ state()“ eine Kombination zurückgibt, die das Flag „ QPaintEngine::DirtyTransform “ enthält.
Siehe auch „ state()“ und „ QPaintEngine::updateState()“.
© 2026 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.
