QStylePainter Class
La classe `QStylePainter` est une classe utilitaire permettant de dessiner des éléments d'QStyle s à l'intérieur d'un widget. En savoir plus...
| En-tête : | #include <QStylePainter> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QPainter |
- Liste de tous les membres, y compris les membres hérités
- QStylePainter fait partie des classes de peinture.
Fonctions publiques
| QStylePainter() | |
| QStylePainter(QWidget *widget) | |
| QStylePainter(QPaintDevice *pd, QWidget *widget) | |
| bool | begin(QWidget *widget) |
| bool | begin(QPaintDevice *pd, QWidget *widget) |
| void | drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option) |
| void | drawControl(QStyle::ControlElement ce, const QStyleOption &option) |
| void | drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap) |
| void | drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole) |
| void | drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option) |
| QStyle * | style() const |
Description détaillée
QStylePainter étend QPainter avec un ensemble de fonctions d’ draw...() s de haut niveau implémentées par-dessus l’API de QStyle. L’avantage d’utiliser QStylePainter est que les listes de paramètres sont considérablement raccourcies. Alors qu’un objet ` QStyle ` doit pouvoir dessiner sur n’importe quel widget en utilisant n’importe quel peintre (car l’application dispose généralement d’un seul objet ` QStyle ` partagé par tous les widgets), un `QStylePainter` est initialisé avec un widget, ce qui évite d’avoir à spécifier ` QWidget`, ` QPainter` et ` QStyle ` à chaque appel de fonction.
Exemple d'utilisation directe d'QStyle:
void MyWidget::paintEvent(QPaintEvent * /* event */)
{
QPainter painter(this);
QStyleOptionFocusRect option;
option.initFrom(this);
option.backgroundColor = palette().color(QPalette::Window);
style()->drawPrimitive(QStyle::PE_FrameFocusRect, &option, &painter, this);
}Exemple d'utilisation de QStylePainter :
void MyWidget::paintEvent(QPaintEvent * /* event */)
{
QStylePainter painter(this);
QStyleOptionFocusRect option;
option.initFrom(this);
option.backgroundColor = palette().color(QPalette::Window);
painter.drawPrimitive(QStyle::PE_FrameFocusRect, option);
}Voir également QStyle et QStyleOption.
Documentation des fonctions membres
QStylePainter::QStylePainter()
Crée un objet QStylePainter.
[explicit] QStylePainter::QStylePainter(QWidget *widget)
Créez un objet `QStylePainter` en utilisant l'widget du widget comme périphérique de dessin.
QStylePainter::QStylePainter(QPaintDevice *pd, QWidget *widget)
Créez un objet `QStylePainter` en utilisant pd comme périphérique de dessin, ainsi que les attributs disponibles sur widget.
bool QStylePainter::begin(QWidget *widget)
Lance les opérations de peinture sur l'widget spécifié. Renvoie true si le « peintre » est prêt à l'emploi ; sinon, renvoie false.
Cette méthode est automatiquement appelée par le constructeur qui prend un QWidget.
bool QStylePainter::begin(QPaintDevice *pd, QWidget *widget)
Lancez les opérations de dessin sur le périphérique de dessin pd comme s'il s'agissait de widget.
Cette fonction est automatiquement appelée par le constructeur qui prend en paramètre un QPaintDevice et un QWidget.
Il s'agit d'une fonction surchargée.
void QStylePainter::drawComplexControl(QStyle::ComplexControl cc, const QStyleOptionComplex &option)
Utilisez le style du widget pour dessiner un contrôle complexe cc, tel que spécifié par le document « QStyleOptionComplex » option.
Voir également QStyle::drawComplexControl().
void QStylePainter::drawControl(QStyle::ControlElement ce, const QStyleOption &option)
Utilisez le style du widget pour dessiner un élément de contrôle ce spécifié par QStyleOption option .
Voir également QStyle::drawControl().
void QStylePainter::drawItemPixmap(const QRect &rect, int flags, const QPixmap &pixmap)
Affiche l'image « pixmap » dans le rectangle « rect ». L'image est alignée selon les paramètres définis dans « flags ».
Voir également QStyle::drawItemPixmap() et Qt::Alignment.
void QStylePainter::drawItemText(const QRect &rect, int flags, const QPalette &pal, bool enabled, const QString &text, QPalette::ColorRole textRole = QPalette::NoRole)
Dessine le texte « text » dans le rectangle « rect » et avec la palette de couleurs « pal ». Le texte est aligné et mis en ligne conformément à « flags ».
La couleur du stylo est spécifiée par textRole. La valeur booléenne enabled indique si l'élément est activé ou non ; lors de la réimplémentation, cette valeur booléenne doit influencer la manière dont l'élément est dessiné.
Voir également QStyle::drawItemText() et Qt::Alignment.
void QStylePainter::drawPrimitive(QStyle::PrimitiveElement pe, const QStyleOption &option)
Utilisez le style du widget pour dessiner un élément primitif pe spécifié par QStyleOption option .
Voir également QStyle::drawPrimitive().
QStyle *QStylePainter::style() const
Renvoie le style actuellement utilisé par l'QStylePainter.
© 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.
