QPaintEngineState Class
La classe `QPaintEngineState` fournit des informations sur l'état actuel du moteur de dessin actif. En savoir plus...
| En-tête : | #include <QPaintEngineState> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
Remarque : 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 changé depuis la dernière mise à jour du moteur de dessin, 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 de type QPaintEngine::DirtyFlag. L'énumération QPaintEngine::DirtyFlag indique si une propriété a changé depuis la dernière mise à jour ou non.
Si une propriété est marquée d’un indicateur « 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 vers le « painter » qui met actuellement à jour le moteur de dessin.
Une instance de cette classe, représentant l’état actuel du moteur de dessin actif, est transmise en 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 dessin.
Voir également QPaintEngine.
Documentation des fonctions membres
QBrush QPaintEngineState::backgroundBrush() const
Renvoie le pinceau d'arrière-plan dans l'état actuel du moteur de peinture.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyBackground.
Voir également state() et QPaintEngine::updateState().
Qt::BGMode QPaintEngineState::backgroundMode() const
Renvoie le mode d'arrière-plan dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyBackgroundMode.
Voir également state() et QPaintEngine::updateState().
QBrush QPaintEngineState::brush() const
Renvoie le pinceau dans l'état actuel du moteur de peinture.
Cette variable ne doit être utilisée que lorsque la fonction ` state()` renvoie une combinaison incluant l'indicateur ` QPaintEngine::DirtyBrush `.
Voir également state() et QPaintEngine::updateState().
bool QPaintEngineState::brushNeedsResolving() const
Indique 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 déterminées (par rapport à la primitive actuellement rendue).
QPointF QPaintEngineState::brushOrigin() const
Renvoie l'origine du pinceau dans l'état actuel du moteur de dessin.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyBrushOrigin.
Voir également state() et QPaintEngine::updateState().
Qt::ClipOperation QPaintEngineState::clipOperation() const
Renvoie l'opération de découpage dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant soit le drapeau QPaintEngine::DirtyClipPath, soit le drapeau QPaintEngine::DirtyClipRegion.
Voir également state() et QPaintEngine::updateState().
QPainterPath QPaintEngineState::clipPath() const
Renvoie le chemin de découpe dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyClipPath.
Voir également state() et QPaintEngine::updateState().
QRegion QPaintEngineState::clipRegion() const
Renvoie la région de découpe dans l'état actuel du moteur de dessin.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyClipRegion.
Voir également state() et QPaintEngine::updateState().
QPainter::CompositionMode QPaintEngineState::compositionMode() const
Renvoie le mode de composition dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyCompositionMode.
Voir également state() et QPaintEngine::updateState().
QFont QPaintEngineState::font() const
Renvoie la police utilisée dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyFont.
Voir également state() et QPaintEngine::updateState().
bool QPaintEngineState::isClipEnabled() const
Indique si le clipping est activé ou non dans l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction ` state()` renvoie une combinaison incluant l'indicateur ` QPaintEngine::DirtyClipEnabled `.
Voir également state() et QPaintEngine::updateState().
qreal QPaintEngineState::opacity() const
Renvoie l'opacité dans l'état actuel du moteur de rendu.
QPainter *QPaintEngineState::painter() const
Renvoie un pointeur vers le « painter » qui met actuellement à jour le moteur de rendu.
QPen QPaintEngineState::pen() const
Renvoie le stylo dans l'état actuel du moteur de dessin.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyPen.
Voir également state() et QPaintEngine::updateState().
bool QPaintEngineState::penNeedsResolving() const
Indique si les coordonnées du trait ont été définies comme étant délimitées par l'opération de rendu en cours et doivent être résolues (par rapport à la primitive actuellement rendue).
QPainter::RenderHints QPaintEngineState::renderHints() const
Renvoie les indications de rendu correspondant à l'état actuel du moteur de dessin.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant l'indicateur QPaintEngine::DirtyHints.
Voir également state() et QPaintEngine::updateState().
QPaintEngine::DirtyFlags QPaintEngineState::state() const
Renvoie un ensemble d'indicateurs identifiant les propriétés à mettre à jour lors de la mise à jour de l'état du moteur de rendu (c'est-à-dire lors d'un appel à la fonction QPaintEngine::updateState()).
Voir également QPaintEngine::updateState().
QTransform QPaintEngineState::transform() const
Renvoie la matrice correspondant à l'état actuel du moteur de rendu.
Cette variable ne doit être utilisée que lorsque la fonction state() renvoie une combinaison incluant le drapeau QPaintEngine::DirtyTransform.
Voir également 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.
