Style

Les widgets intégrés de Qt utilisent la classe QStyle pour effectuer presque tous leurs dessins. QStyle est une classe de base abstraite qui encapsule l'aspect et la convivialité d'une interface graphique, et peut être utilisée pour que les widgets ressemblent exactement aux widgets natifs équivalents ou pour leur donner un aspect personnalisé.

Qt fournit un ensemble de sous-classes QStyle qui émulent l'aspect natif des différentes plates-formes prises en charge par Qt (QWindowsStyle, QMacStyle, etc.). Ces styles sont intégrés dans le module Qt GUI, d'autres styles peuvent être mis à disposition en utilisant le mécanisme de plugin de Qt.

La plupart des fonctions permettant de dessiner des éléments de style prennent quatre arguments :

  • une valeur d'énumération spécifiant l'élément graphique à dessiner
  • un objet QStyleOption spécifiant comment et où rendre cet élément
  • un objet QPainter qui doit être utilisé pour dessiner l'élément
  • un objet QWidget sur lequel le dessin est effectué (facultatif).

Le style obtient toutes les informations nécessaires au rendu de l'élément graphique à partir de la classe QStyleOption. Le widget est passé en dernier argument au cas où le style en aurait besoin pour réaliser des effets spéciaux (comme les boutons animés par défaut sur macOS), mais il n'est pas obligatoire. En fait, QStyle peut être utilisé pour dessiner sur n'importe quel périphérique de peinture (pas seulement les widgets), auquel cas l'argument widget est un pointeur nul.

Diagramme montrant que QStylePainter hérite de QPainter

Le système de peinture fournit également la classe QStylePainter qui hérite de QPainter. QStylePainter est une classe de commodité pour dessiner les éléments QStyle à l'intérieur d'un widget, et étend QPainter avec un ensemble de fonctions de dessin de haut niveau implémentées au-dessus de l'API de QStyle. L'avantage de l'utilisation de QStylePainter est que les listes de paramètres sont considérablement plus courtes.

Icône utilisée dans QtQIcon

La classe QIcon fournit des icônes évolutives dans différents modes et états.

QIcon QIcon peut générer des pixmaps reflétant l'état, le mode et la taille d'une icône. Ces pixmaps sont générés à partir de l'ensemble des pixmaps mis à la disposition de l'icône et sont utilisés par les Qt Widgets pour afficher une icône représentant une action particulière.

Le rendu d'un objet QIcon est géré par la classe QIconEngine. Chaque icône possède un moteur d'icônes correspondant qui est chargé de dessiner l'icône avec la taille, le mode et l'état demandés.

Pour plus d'informations sur le style et l'apparence des widgets, voir les pages Styles et Widgets sensibles au style.

© 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.