Referenz zu Widget-Stilen
Diese Referenz beschreibt, wie die Qt Widgets den Stil verwenden. Verwenden Sie sie, wenn Sie einen Stil implementieren, um zu sehen, welche Elemente Sie zeichnen müssen und welche Informationen die Widgets an Sie weitergeben, oder wenn Sie ein stilbewusstes Widget oder einen Delegaten schreiben, um dieselben Elemente zu zeichnen, die auch die Qt Widgets zeichnen.
Die Referenz ist in drei Seiten unterteilt:
- Gestaltung von Schaltflächen und Eingabe-Widgets: Drucktasten, Kontrollkästchen und Optionsfelder, Werkzeugschaltflächen, Kombinationsfelder, Drehfelder, Schieberegler, Bildlaufleisten und Fortschrittsbalken.
- Gestaltung von Containern und Fenstern: Registerkarten-Widgets, Gruppenfelder, Trennleisten, Werkzeugkästen, Symbolleisten, Andock-Widgets, Titelleisten, Größengriffe und Gummibänder.
- Gestaltung von Menüs und Elementansichten: Menüs, Menüleisten, Kopfzeilen von Elementansichten, Anzeigen für Baumzweige und Elemente in Elementansichten.
Was die Referenz für jedes Widget auflistet
- Der Elementbaum. Die Stilelemente, die das Widget zeichnet, in der Reihenfolge ihrer Darstellung. Ein verschachteltes Element wird vom darüber liegenden Element in „ QCommonStyle “ gezeichnet. Neben jedem Element nennt die Referenz die Rechtecke der Unterelemente, die Untersteuerelemente und die Pixelmaße, die „ QCommonStyle “ beim Zeichnen dieses Elements verwendet. Ihr eigener Stil kann die Darstellung anders strukturieren; nur die vom Widget aufgerufenen Elemente sind fest vorgegeben.
- Ein Screenshot. Das Widget im Fusion-Stil, wobei die Begrenzungsrechtecke der Elemente umrandet sind. Die Farben dienen lediglich der Unterscheidung der Rechtecke. Rechtecke, die sich überlappen, werden jeweils einen Pixel ineinander gezeichnet.
- Die Statusflags. Die Werte von ` QStyle::StateFlag `, die das Widget zusätzlich zu den üblichen Flags, die von ` QStyleOption::initFrom()` gesetzt werden, in seiner Stiloption festlegt.
- Die Mitglieder der Style-Option. Die Mitglieder der Unterklasse „ QStyleOption “ des Widgets und die Werte, die das Widget darin speichert.
Die allgemeinen Statusflags und -elemente werden unter „Wie ein Stil ein Widget zeichnet“ beschrieben.
Was in der Dokumentation ausgelassen wird
Die Widgets verwenden den Stil auch für Berechnungen, die nicht zum Zeichnen gehören. Sie fragen ihre Größenhinweise mit ` sizeFromContents()`, ihre Rahmenbreiten und Ränder mit ` pixelMetric()` und die Position ihrer Unterelemente mit ` subElementRect()` ab. Die Referenz nennt die Inhaltstypen und die Pixelmaße, die jedes Widget abfragt, beschreibt jedoch nicht, wie die integrierten Stile diese berechnen. Wie ein Stil diese Berechnungen durchführt, bleibt dem Stil selbst überlassen. Qt schreibt keine bestimmte Struktur vor. Im Zweifelsfall lesen Sie die Implementierung von ` QCommonStyle `.
Siehe auch „Styles and Style Aware Widgets“, „How a Style Draws a Widget“, „ QStyle “ sowie „ QStyleOption “.
© 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.