Référence sur les styles de widgets

Cette référence décrit comment les widgets Qt utilisent le style. Utilisez-la lorsque vous implémentez un style, pour savoir quels éléments vous devez dessiner et quelles informations les widgets vous transmettent, ou lorsque vous écrivez un widget prenant en charge les styles ou un délégué, afin de dessiner les mêmes éléments que ceux dessinés par les widgets Qt.

Ce guide de référence est divisé en trois pages :

• Personnalisation des boutons et des widgets de saisie: boutons poussoirs, cases à cocher et boutons radio, boutons d’outils, listes déroulantes, zones de sélection, curseurs, barres de défilement et barres de progression.
• Stylisation des conteneurs et des fenêtres: widgets d’onglets, zones de groupe, séparateurs, boîtes à outils, barres d’outils, widgets d’ancrage, barres de titre, poignées de redimensionnement et élastiques.
• Mise en forme des menus et des vues d’éléments: menus, barres de menus, en-têtes de vue d’éléments, indicateurs de branches d’arborescence et éléments de vue d’éléments.

Ce que la documentation de référence répertorie pour chaque widget

• L'arborescence des éléments. Les éléments de style que le widget dessine, dans l'ordre de dessin. Un élément imbriqué est dessiné par l’élément situé au-dessus de lui dans l’ QCommonStyle. À côté de chaque élément, la référence indique les rectangles des sous-éléments, les sous-contrôles et les mesures en pixels utilisés par QCommonStyle lors du dessin de cet élément. Votre propre style peut structurer son dessin différemment ; seuls les éléments appelés par le widget sont fixes.
• Une capture d’écran. Le widget dans le style « Fusion », avec les rectangles de délimitation des éléments mis en évidence. Les couleurs servent uniquement à distinguer les rectangles les uns des autres. Les rectangles qui se chevauchent sont dessinés à un pixel à l’intérieur les uns des autres.
• Les indicateurs d’état. Les valeurs d’ QStyle::StateFlag s que le widget définit dans son option de style, en plus des indicateurs communs définis par la fonction QStyleOption::initFrom().
• Les membres de l’option « style ». Les membres de la sous-classe « QStyleOption » du widget et ce que le widget y stocke.

Les indicateurs d'état et les membres communs sont décrits dans la section « Comment un style dessine un widget ».

Ce que la documentation omet

Les widgets utilisent également le style pour des calculs qui ne relèvent pas du dessin. Ils demandent leurs indications de taille via ` sizeFromContents()`, la largeur de leur cadre et leurs marges via ` pixelMetric()`, ainsi que la position de leurs sous-éléments via ` subElementRect()`. La documentation nomme les types de contenu et les mesures en pixels que chaque widget interroge, mais ne décrit pas comment les styles intégrés les calculent. La manière dont un style effectue ces calculs dépend du style lui-même. Qt n’impose aucune structure. En cas de doute, consultez l’implémentation de ` QCommonStyle `.