Sur cette page

QPaintEngineState Class

La classe QPaintEngineState fournit des informations sur l'état actuel du moteur de peinture actif. Plus d'informations...

En-tête : #include <QPaintEngineState>
CMake : find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake : QT += gui

Note : Toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

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

Description détaillée

QPaintEngineState enregistre les propriétés qui ont été modifiées depuis la dernière mise à jour du moteur de peinture, ainsi que leur valeur actuelle.

Les propriétés qui ont changé peuvent être récupérées à tout moment à l'aide de la fonction state(). Cette fonction renvoie une instance du type QPaintEngine::DirtyFlags qui stocke une combinaison OR de valeurs QPaintEngine::DirtyFlag. L'énumération QPaintEngine::DirtyFlag définit si une propriété a changé depuis la dernière mise à jour ou non.

Si une propriété est marquée d'un drapeau "dirty", sa valeur actuelle peut être récupérée à l'aide de la fonction "get" correspondante :

La classe QPaintEngineState fournit également la fonction painter() qui renvoie un pointeur sur le peintre qui met actuellement à jour le moteur de peinture.

Une instance de cette classe, représentant l'état actuel du moteur de peinture actif, est transmise en tant qu'argument à la fonction QPaintEngine::updateState(). La seule situation dans laquelle vous devrez utiliser cette classe directement est lorsque vous implémentez votre propre moteur de peinture.

Voir également QPaintEngine.

Documentation des fonctions membres

QBrush QPaintEngineState::backgroundBrush() const

Renvoie la brosse d'arrière-plan dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyBackground.

Voir aussi state() et QPaintEngine::updateState().

Qt::BGMode QPaintEngineState::backgroundMode() const

Renvoie le mode d'arrière-plan dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyBackgroundMode.

Voir aussi state() et QPaintEngine::updateState().

QBrush QPaintEngineState::brush() const

Renvoie la brosse dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyBrush.

Voir aussi state() et QPaintEngine::updateState().

bool QPaintEngineState::brushNeedsResolving() const

Renvoie si les coordonnées du remplissage ont été spécifiées comme étant délimitées par l'opération de rendu en cours et doivent être résolues (à propos de la primitive actuellement rendue).

QPointF QPaintEngineState::brushOrigin() const

Renvoie l'origine de la brosse dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyBrushOrigin.

Voir aussi state() et QPaintEngine::updateState().

Qt::ClipOperation QPaintEngineState::clipOperation() const

Renvoie l'opération de clip dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant soit l'indicateur QPaintEngine::DirtyClipPath, soit l'indicateur QPaintEngine::DirtyClipRegion.

Voir aussi state() et QPaintEngine::updateState().

QPainterPath QPaintEngineState::clipPath() const

Renvoie le chemin du clip dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyClipPath.

Voir aussi state() et QPaintEngine::updateState().

QRegion QPaintEngineState::clipRegion() const

Renvoie la région du clip dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyClipRegion.

Voir aussi state() et QPaintEngine::updateState().

QPainter::CompositionMode QPaintEngineState::compositionMode() const

Renvoie le mode de composition dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyCompositionMode.

Voir aussi state() et QPaintEngine::updateState().

QFont QPaintEngineState::font() const

Renvoie la police dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyFont.

Voir aussi state() et QPaintEngine::updateState().

bool QPaintEngineState::isClipEnabled() const

Retourne si le détourage est activé ou non dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyClipEnabled.

Voir aussi state() et QPaintEngine::updateState().

qreal QPaintEngineState::opacity() const

Renvoie l'opacité dans l'état actuel du moteur de peinture.

QPainter *QPaintEngineState::painter() const

Renvoie un pointeur sur le peintre qui met actuellement à jour le moteur de peinture.

QPen QPaintEngineState::pen() const

Renvoie le stylo dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyPen.

Voir aussi state() et QPaintEngine::updateState().

bool QPaintEngineState::penNeedsResolving() const

Renvoie si les coordonnées du trait ont été spécifiées comme étant délimitées par l'opération de rendu en cours et doivent être résolues (autour de la primitive actuellement rendue).

QPainter::RenderHints QPaintEngineState::renderHints() const

Renvoie les indices de rendu dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison comprenant le drapeau QPaintEngine::DirtyHints.

Voir aussi state() et QPaintEngine::updateState().

QPaintEngine::DirtyFlags QPaintEngineState::state() const

Renvoie une combinaison de drapeaux identifiant l'ensemble des propriétés qui doivent être mises à jour lors de la mise à jour de l'état du moteur de peinture (c'est-à-dire lors d'un appel à la fonction QPaintEngine::updateState()).

Voir aussi QPaintEngine::updateState().

QTransform QPaintEngineState::transform() const

Renvoie la matrice dans l'état actuel du moteur de peinture.

Cette variable ne doit être utilisée que lorsque state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyTransform.

Voir aussi state() et 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.