Qt Style Sheets Referenz
Qt Style Sheets unterstützen verschiedene Eigenschaften, Pseudo-States und Subcontrols, die es ermöglichen, das Aussehen von Widgets anzupassen.
Liste der stilisierbaren Widgets
Die folgende Tabelle listet die Qt Widgets auf, die mit Style Sheets angepasst werden können:
| Widget | Wie zu stylen |
|---|---|
| QAbstractScrollArea | Unterstützt das Box-Modell. All derivatives of QAbstractScrollArea, including QTextEdit, and QAbstractItemView (all item view classes), support scrollable backgrounds using background-attachment. Setting the background-attachment to fixed provides a background-image that does not scroll with the viewport. Setting the background-attachment to scroll, scrolls the background-image when the scroll bars move. Siehe QAbstractScrollArea anpassen für ein Beispiel. |
| QCheckBox | Unterstützt das Box-Modell. Der Check-Indikator kann mit dem Subcontrol ::indicator gestaltet werden. Standardmäßig befindet sich der Indikator in der linken oberen Ecke des Inhaltsrechtecks des Widgets. Die Eigenschaft spacing legt den Abstand zwischen dem Prüfzeichen und dem Text fest. Siehe QCheckBox anpassen für ein Beispiel. |
| QColumnView | Der Griff kann mit der Eigenschaft image gestylt werden. Die Pfeilindikatoren können mit Hilfe des ::left-arrow-Untersteuerelements und des ::right-arrow-Untersteuerelements gestaltet werden. |
| QComboBox | Der Rahmen um die Combobox kann mit Hilfe des Box-Modells gestaltet werden. Die Dropdown-Schaltfläche kann mit dem Untersteuerelement ::drop-down gestaltet werden. Standardmäßig befindet sich die Dropdown-Schaltfläche in der oberen rechten Ecke des Padding-Rechtecks des Widgets. Die Pfeilmarkierung innerhalb der Dropdown-Schaltfläche kann mit dem Untersteuerelement ::down-arrow gestaltet werden. Standardmäßig wird der Pfeil in der Mitte des Inhaltsrechtecks des Dropdown-Subcontrols platziert. Die Farbe des Platzhaltertextes kann mit der Eigenschaft placeholder-text-color eingestellt werden. Siehe QComboBox anpassen für ein Beispiel. |
| QDateEdit | Siehe QSpinBox. |
| QDateTimeEdit | Siehe QSpinBox. |
| QDialog | Unterstützt nur die Eigenschaften background, background-clip und background-origin. Warnung: Stellen Sie sicher, dass Sie das Makro Q_OBJECT für Ihr benutzerdefiniertes Widget definieren. |
| QDialogButtonBox | Das Layout der Schaltflächen kann mit der Eigenschaft button-layout geändert werden. |
| QDockWidget | Unterstützt das Styling der Titelleiste und der Schaltflächen der Titelleiste, wenn sie angedockt sind. Die Umrandung des Andock-Widgets kann mit der Eigenschaft border gestaltet werden. Das ::title-Untersteuerelement kann verwendet werden, um die Titelleiste anzupassen. Die Schaltflächen close und float werden mit Hilfe der ::close-button bzw. ::float-button in Bezug auf das ::title-Untersteuerelement positioniert. Wenn die Titelleiste vertikal ist, wird die Pseudoklasse :vertical gesetzt. Darüber hinaus werden je nach QDockWidget::DockWidgetFeature die Pseudozustände :closable, :floatable und :movable gesetzt. Hinweis: Verwenden Sie QMainWindow::separator, um den Größenänderungsgriff zu gestalten. Warnung: Die Stilvorlage hat keine Wirkung, wenn QDockWidget abgedockt ist, da Qt beim Abdocken native Fenster der obersten Ebene verwendet. Siehe QDockWidget anpassen für ein Beispiel. |
| QDoubleSpinBox | Siehe QSpinBox. |
| QFrame | Unterstützt das Box-Modell. Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel. Siehe QFrame anpassen für ein Beispiel. |
| QGroupBox | Unterstützt das Box-Modell. Der Titel kann mit Hilfe des ::title Untersteuerelements gestylt werden. Standardmäßig wird der Titel in Abhängigkeit von QGroupBox::textAlignment platziert. In the case of a checkable QGroupBox, the title includes the check indicator. The indicator is styled using the ::indicator subcontrol. The spacing property can be used to control the spacing between the text and indicator. Siehe QGroupBox anpassen für ein Beispiel. |
| QHeaderView | Unterstützt das Box-Modell. Die Abschnitte der Kopfansicht werden mit dem ::section Sub-Control gestylt. Das section Untersteuerelement unterstützt die Pseudozustände :middle, :first, :last, :only-one, :next-selected, :previous-selected, :selected und :checked. Der Sortierindikator kann mit dem ::up-arrow und dem ::down-arrow Sub-Control gestylt werden. Siehe QHeaderView anpassen für ein Beispiel. |
| QLabel | Unterstützt das Box-Modell. Unterstützt nicht den :hover Pseudo-Zustand. Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel. Siehe QFrame anpassen für ein Beispiel (ein QLabel leitet sich von QFrame ab). |
| QLineEdit | Unterstützt das Box-Modell. Die Farbe und der Hintergrund des ausgewählten Elements werden mit selection-color bzw. selection-background-color gestaltet. Die Farbe des Platzhaltertextes kann mit der Eigenschaft placeholder-text-color eingestellt werden. Das Kennwortzeichen kann mit der Eigenschaft lineedit-password-character gestaltet werden. Die Verzögerung der Passwortmaske kann mit der Eigenschaft lineedit-password-mask-delay geändert werden. Ein Beispiel finden Sie unter QLineEdit anpassen. |
| QListView | Unterstützt das Box-Modell. When alternating row colors is enabled, the alternating colors can be styled using the alternate-background-color property. Die Farbe und der Hintergrund des ausgewählten Elements werden mit selection-color bzw. selection-background-color gestaltet. Das Verhalten der Auswahl wird durch die Eigenschaft show-decoration-selected gesteuert. Verwenden Sie die ::item Subcontrol für eine feinere Kontrolle über die Elemente in der QListView. Siehe QAbsractScrollArea, um scrollbare Hintergründe zu gestalten. Siehe Anpassen von QListView für ein Beispiel. |
| QListWidget | Siehe QListView. |
| QMainWindow | Unterstützt das Styling des Separators. The separator in a QMainWindow when using QDockWidget is styled using the ::separator subcontrol. Siehe QMainWindow anpassen für ein Beispiel. |
| QMenu | Unterstützt das Box-Modell. Einzelne Elemente werden mit dem Subcontrol ::item gestylt. Zusätzlich zu den üblicherweise unterstützten Pseudo-Zuständen unterstützt das Untersteuerelement item die Pseudo-Zustände :selected, :default, :exclusive und non-exclusive. Der Indikator von ankreuzbaren Menüpunkten wird mit dem Subcontrol ::indicator gestaltet. Das Trennzeichen wird mit dem Untersteuerelement ::separator formatiert. Bei Einträgen mit einem Untermenü werden die Pfeilmarkierungen mit dem Rechts- und dem Linkspfeil gestylt. Der Scroller wird mit dem ::scroller gestaltet. Der Abriss wird mit ::tearoff gestaltet. Ein Beispiel finden Sie unter Anpassen von QMenu. |
| QMenuBar | Unterstützt das Box-Modell. Die Eigenschaft spacing gibt den Abstand zwischen den Menüpunkten an. Einzelne Elemente werden mit dem Untersteuerelement ::item formatiert. Warnung: Wenn die Menüleiste auf Qt/Mac läuft, ist sie normalerweise in die systemweite Menüleiste eingebettet. In diesem Fall hat die Stilvorlage keine Wirkung. Siehe QMenuBar anpassen für ein Beispiel. |
| QMessageBox | Die Eigenschaft messagebox-text-interaction-flags kann verwendet werden, um die Interaktion mit dem Text in der Messagebox zu ändern. |
| QProgressBar | Unterstützt das Box-Modell. Die Chunks des Fortschrittsbalkens können mit dem Subcontrol ::chunk gestylt werden. Die Chunks werden auf dem Inhaltsrechteck des Widgets angezeigt. Wenn der Fortschrittsbalken Text anzeigt, verwenden Sie die Eigenschaft text-align, um den Text zu positionieren. Unbestimmte Fortschrittsbalken haben den Pseudo-Zustand :indeterminate gesetzt. Siehe QProgressBar anpassen für ein Beispiel. |
| QPushButton | Unterstützt das Box-Modell. Unterstützt die Pseudo-Zustände :default, :flat, :checked. Seit Version 5.15 kann die Eigenschaft icon gesetzt werden, um das Schaltflächensymbol zu überschreiben. For QPushButton with a menu, the menu indicator is styled using the ::menu-indicator subcontrol. Appearance of checkable push buttons can be customized using the :open and :closed pseudo-states. Achtung! Wenn Sie auf QPushButton nur eine Hintergrundfarbe festlegen, wird der Hintergrund möglicherweise nicht angezeigt, es sei denn, Sie setzen die Eigenschaft border auf einen bestimmten Wert. Der Grund dafür ist, dass QPushButton standardmäßig einen eigenen Rahmen zeichnet, der die Hintergrundfarbe vollständig überdeckt. Zum Beispiel, QPushButton { background-color: red; border: none; } Siehe QPushButton anpassen für ein Beispiel. |
| QRadioButton | Unterstützt das Box-Modell. Der Check-Indikator kann mit dem Subcontrol ::indicator gestaltet werden. Standardmäßig wird der Indikator in der oberen linken Ecke des Inhaltsrechtecks des Widgets platziert. Die Eigenschaft spacing legt den Abstand zwischen dem Prüfzeichen und dem Text fest. Siehe QRadioButton anpassen für ein Beispiel. |
| QScrollBar | Unterstützt das Box-Modell. The Contents rectangle of the widget is considered to be the groove over which the slider moves. The extent of the QScrollBar (i.e the width or the height depending on the orientation) is set using the width or height property respectively. To determine the orientation, use the :horizontal and the :vertical pseudo states. Der Schieberegler kann mit dem Untersteuerelement ::handle gestylt werden. Die Einstellung der Mindestbreite oder Mindesthöhe bietet Größenbeschränkungen für den Schieberegler in Abhängigkeit von der Ausrichtung. Mit dem Untersteuerelement ::add-line kann die Schaltfläche zum Hinzufügen einer Linie gestaltet werden. Standardmäßig wird das Untersteuerelement add-line in der oberen rechten Ecke des Rahmenrechtecks des Widgets platziert. Je nach Ausrichtung der ::right-arrow oder ::down-arrow. Standardmäßig werden die Pfeile in der Mitte des Inhaltsrechtecks des Untersteuerelements add-line platziert. Das ::sub-line Subcontrol kann verwendet werden, um die Schaltfläche so zu gestalten, dass sie eine Zeile subtrahiert. Standardmäßig befindet sich das Untersteuerelement sub-line in der unteren rechten Ecke des Rechtecks Border des Widgets. Je nach Ausrichtung der ::left-arrow oder ::up-arrow. Standardmäßig werden die Pfeile in der Mitte des Rechtecks "Inhalt" des Untersteuerelements "Unterzeile" platziert. Das Subcontrol ::sub-page kann verwendet werden, um den Bereich des Schiebereglers zu gestalten, der eine Seite abzieht. Das Subcontrol ::add-page kann verwendet werden, um den Bereich des Schiebereglers zu gestalten, der eine Seite hinzufügt. Siehe QScrollBar anpassen für ein Beispiel. |
| QSizeGrip | Unterstützt die Eigenschaften width, height und image. Siehe QSizeGrip anpassen für ein Beispiel. |
| QSlider | Unterstützt das Box-Modell. Für horizontale Schieberegler müssen die Eigenschaften min-width und height angegeben werden. Für vertikale Schieberegler müssen die Eigenschaften min-height und width angegeben werden. Die Nut des Schiebereglers wird mit ::groove gestylt. Die Rille wird standardmäßig im Rechteck Contents des Widgets positioniert. Der Daumen des Schiebereglers wird mit dem Untersteuerelement ::handle gestylt. Das Untersteuerelement bewegt sich im Rechteck Contents des Untersteuerelements groove. Siehe QSlider anpassen für ein Beispiel. |
| QSpinBox | Der Rahmen der Spinbox kann mithilfe des Box-Modells gestaltet werden. Die Aufwärts-Schaltfläche und der Pfeil können mit den Untersteuerelementen ::up-button und ::up-arrow gestaltet werden. Standardmäßig wird der Aufwärts-Button in der oberen rechten Ecke im Padding-Rechteck des Widgets platziert. Ohne explizite Größenangabe nimmt er die halbe Höhe seines Bezugsrechtecks ein. Der Aufwärtspfeil wird in der Mitte des Inhaltsrechtecks der Aufwärts-Schaltfläche platziert. Die Abwärts-Schaltfläche und der Pfeil können mit den Subcontrols ::down-button und ::down-arrow gestaltet werden. Standardmäßig wird die Abwärts-Schaltfläche in der unteren rechten Ecke im Padding-Rechteck des Widgets platziert. Ohne explizite Größenangabe nimmt er die halbe Höhe seines Bezugsrechtecks ein. Der untere Pfeil wird in der Mitte des Inhaltsrechtecks des unteren Buttons platziert. Siehe QSpinBox anpassen für ein Beispiel. |
| QSplitter | Unterstützt das Box-Modell. Der Griff des Splitters wird mit dem Subcontrol ::handle gestaltet. Siehe QSplitter anpassen für ein Beispiel. |
| QStatusBar | Unterstützt nur die Eigenschaft background. Der Rahmen für einzelne Elemente kann mit dem Untersteuerelement ::item gestaltet werden. Siehe QStatusBar anpassen für ein Beispiel. |
| QTabBar | Einzelne Tabs können mit dem Subcontrol ::tab gestylt werden. Schließen Sie Schaltflächen mit dem ::close-button. Die Tabs unterstützen die Pseudozustände :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected. Die Pseudo-Zustände :top, :left, :right, :bottom hängen von der Ausrichtung der Tabs ab. Overlapping tabs for the selected state are created by using negative margins or using the absolute position scheme. The tear indicator of the QTabBar is styled using the ::tear subcontrol. QTabBar used two QToolButtons for its scrollers that can be styled using the QTabBar QToolButton selector. To specify the width of the scroll button use the ::scroller subcontrol. The alignment of the tabs within the QTabBar is styled using the alignment property. Achtung! Um die Position von QTabBar innerhalb von QTabWidget zu ändern, verwenden Sie die Untersteuerung "Tabulatorleiste" (und setzen Sie die Position der Untersteuerung). Siehe QTabBar anpassen für ein Beispiel. |
| QTabWidget | Der Rahmen des Tab-Widgets wird mit dem ::pane Untersteuerelement gestaltet. Die linken und rechten Ecken werden mit ::left-corner bzw. ::right-corner gestaltet. Die Position der Registerkartenleiste wird mit dem Untersteuerelement ::tab-bar gesteuert. By default, the subcontrols have positions of a QTabWidget in the QWindowsStyle. To place the QTabBar in the center, set the subcontrol-position of the tab-bar subcontrol. Die Pseudozustände :top, :left, :right, :bottom hängen von der Ausrichtung der Tabs ab. Siehe QTabWidget anpassen für ein Beispiel. |
| QTableView | Unterstützt das Box-Modell. Wenn alternating row colors aktiviert ist, können die wechselnden Farben mit der Eigenschaft alternate-background-color gestylt werden. Die Farbe und der Hintergrund des ausgewählten Elements werden mit selection-color bzw. selection-background-color gestaltet. The corner widget in a QTableView is implemented as a QAbstractButton and can be styled using the "QTableView QTableCornerButton::section" selector. Achtung! Wenn Sie nur eine Hintergrundfarbe für einen QTableCornerButton festlegen, wird der Hintergrund möglicherweise nicht angezeigt, es sei denn, Sie setzen die Eigenschaft border auf einen bestimmten Wert. Dies liegt daran, dass der QTableCornerButton standardmäßig einen eigenen Rahmen zeichnet, der die Hintergrundfarbe vollständig überdeckt.
|
| QTableWidget | Siehe QTableView. |
| QTextEdit | Unterstützt das Box-Modell. Die Farbe und der Hintergrund des ausgewählten Textes wird mit selection-color bzw. selection-background-color gestaltet. Die Farbe des Platzhaltertextes kann mit der Eigenschaft placeholder-text-color eingestellt werden. Siehe QAbsractScrollArea um scrollbare Hintergründe zu gestalten. |
| QTimeEdit | Siehe QSpinBox. |
| QToolBar | Unterstützt das Box-Modell. Die Pseudozustände :top, :left, :right, :bottom hängen von dem Bereich ab, in dem die Symbolleiste gruppiert ist. Die Pseudozustände :first, :last, :middle, :only-one geben die Position der Symbolleiste innerhalb einer Zeilengruppe an (siehe QStyleOptionToolBar::positionWithinLine). The separator of a QToolBar is styled using the ::separator subcontrol. Der Griff (zum Bewegen der Symbolleiste) wird mit dem Untersteuerelement ::handle gestylt. Siehe QToolBar anpassen für ein Beispiel. |
| QToolButton | Unterstützt das Box-Modell. If the QToolButton has a menu, is ::menu-indicator subcontrol can be used to style the indicator. By default, the menu-indicator is positioned at the bottom right of the Padding rectangle of the widget. If the QToolButton is in QToolButton::MenuButtonPopup mode, the ::menu-button subcontrol is used to draw the menu button. ::menu-arrow subcontrol is used to draw the menu arrow inside the menu-button. By default, it is positioned in the center of the Contents rectangle of the menu-button subcontrol. When the QToolButton displays arrows, the ::up-arrow, ::down-arrow, ::left-arrow and ::right-arrow subcontrols are used. Achtung! Wenn Sie auf QToolButton nur eine Hintergrundfarbe festlegen, wird der Hintergrund nicht angezeigt, es sei denn, Sie setzen die Eigenschaft border auf einen bestimmten Wert. Der Grund dafür ist, dass QToolButton standardmäßig einen eigenen Rahmen zeichnet, der die Hintergrundfarbe vollständig überdeckt. Zum Beispiel, QToolButton { background-color: red; border: none; } Siehe QToolButton anpassen für ein Beispiel. |
| QToolBox | Unterstützt das Box-Modell. Die einzelnen Tabs können mit dem Subcontrol ::tab gestylt werden. Die Tabs unterstützen die Pseudozustände :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected. |
| QToolTip | Unterstützt das Box-Modell. Die Eigenschaft opacity steuert die Deckkraft des Tooltips. Siehe QFrame anpassen für ein Beispiel ( QToolTip ist eine QFrame). |
| QTreeView | Unterstützt das Box-Modell. Wenn alternating row colors aktiviert ist, können die alternierenden Farben mit der Eigenschaft alternate-background-color gestaltet werden. Die Farbe und der Hintergrund des ausgewählten Elements werden mit selection-color bzw. selection-background-color gestaltet. Das Verhalten der Auswahl wird durch die Eigenschaft show-decoration-selected gesteuert. Die Zweige der Baumansicht können mit dem Untersteuerelement ::branch gestylt werden. Das ::branch Sub-Control unterstützt die Pseudo-Zustände :open, :closed, :has-sibling und :has-children. Verwenden Sie das Untersteuerelement ::item, um eine feinere Kontrolle über die Elemente in QTreeView zu erhalten. Siehe QAbsractScrollArea, um scrollbare Hintergründe zu gestalten. Siehe QTreeView anpassen für ein Beispiel zur Gestaltung der Zweige. |
| QTreeWidget | Siehe QTreeView. |
| QWidget | Unterstützt nur die Eigenschaften background, background-clip und background-origin. If you subclass from QWidget, you need to provide a paintEvent for your custom QWidget as below: void CustomWidget::paintEvent(QPaintEvent *) { QStyleOption opt; opt.initFrom(this); QPainter p(this); style()->drawPrimitive(QStyle::PE_Widget, &opt,&p, this); } Der obige Code ist eine Nulloperation, wenn kein Stylesheet gesetzt ist. Warnung: Stellen Sie sicher, dass Sie das Makro Q_OBJECT für Ihr benutzerdefiniertes Widget definieren. |
Liste der Eigenschaften
Dieser Abschnitt listet alle Eigenschaften auf, die von Qt Style Sheets unterstützt werden. Welche Werte einer Eigenschaft gegeben werden können, hängt vom Typ der Eigenschaft ab. Wenn nicht anders angegeben, gelten die folgenden Eigenschaften für alle Widgets. Eigenschaften, die mit einem Sternchen * gekennzeichnet sind, sind spezifisch für Qt und haben keine Entsprechung in CSS2 oder CSS3. Die Qt-spezifischen Eigenschaften sind die folgenden:
- gridline-color*
- Bild*
- lineedit-password-character*
- lineedit-password-mask-delay*
- messagebox-text-interaction-flags*
- Deckkraft*
- platzhalter-text-farbe*
- auswahl-hintergrund-farbe*
- auswahl-farbe*
- display-decoration-ausgewählt*
- abstand*
- subcontrol-origin*
- Untersteuerelement-Position*
- widget-animation-dauer*
Akzent-Farbe
| Typ | Pinsel |
Die Eigenschaft legt die Farbe Accent fest, die zur Hervorhebung interaktiver Elemente der Benutzeroberfläche verwendet wird. Wenn diese Eigenschaft nicht festgelegt ist, wird standardmäßig die Farbe highlight verwendet.
alternate-background-color
| Typ | Pinsel |
Die in QAbstractItemView Unterklassen verwendete alternate background color.
Wenn diese Eigenschaft nicht festgelegt ist, ist der Standardwert derjenige, der für die AlternateBase Rolle der Palette festgelegt ist.
Beispiel:
QTreeView { alternate-background-color: blue; background: yellow; }
Siehe auch background und selection-background-color.
Hintergrund
| Typ | Hintergrund |
Kurzschreibweise für die Einstellung des Hintergrunds. Entspricht der Angabe von background-color, background-image, background-repeat, und/oder background-position.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, und einfachen QWidgets unterstützt.
Beispiel:
QTextEdit { background: yellow }
Häufig ist es erforderlich, ein Füllmuster ähnlich den Stilen in Qt::BrushStyle festzulegen. Sie können die Eigenschaft background-color für Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern und Qt::ConicalGradientPattern verwenden. Die anderen Muster lassen sich leicht erreichen, indem Sie ein Hintergrundbild erstellen, das das Muster enthält.
Beispiel:
QLabel { background-image: url(dense6pattern.png); background-repeat: repeat-xy; }
Siehe auch background-origin, selection-background-color, background-clip, background-attachment und alternate-background-color.
background-color
| Typ | Pinsel |
Die für das Widget verwendete Hintergrundfarbe.
Beispiele:
background-image
| Typ | Url |
Das für das Widget verwendete Hintergrundbild. Halbtransparente Teile des Bildes lassen die background-color durchscheinen.
Beispiel:
QFrame { background-image: url(:/images/hydro.png) }
background-repeat
| Typ | Wiederholung |
Ob und wie das Hintergrundbild wiederholt wird, um das Rechteck background-origin zu füllen.
Wenn diese Eigenschaft nicht angegeben wird, wird das Hintergrundbild in beide Richtungen wiederholt (repeat).
Beispiel:
QFrame { background: white url(:/images/ring.png); background-repeat: repeat-y; background-position: left; }
background-position
| Typ | Ausrichtung |
Die Ausrichtung des Hintergrundbildes innerhalb des Rechtecks background-origin.
Wenn diese Eigenschaft nicht angegeben wird, ist die Ausrichtung top left .
Beispiel:
QFrame { background: url(:/images/footer.png); background-position: bottom left; }
background-attachment
| Typ | Anlage |
Legt fest, ob das Hintergrundbild in einem QAbstractScrollArea in Bezug auf das Ansichtsfenster gescrollt oder fixiert wird. Standardmäßig wird das Hintergrundbild mit dem Ansichtsfenster verschoben.
Beispiel:
QTextEdit { background-image: url("leaves.png"); background-attachment: fixed; }
Siehe auch background
Hintergrund-Clip
| Typ | Herkunft |
Das Rechteck des Widgets, in dem das background gezeichnet wird.
Diese Eigenschaft gibt das Rechteck an, auf das background-color und background-image beschnitten werden.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip und einfachen QWidgets unterstützt.
Wird diese Eigenschaft nicht angegeben, ist der Standardwert border.
Beispiel:
QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; background-clip: padding; }
Siehe auch background, background-origin und Das Box-Modell.
background-origin
| Typ | Herkunft |
Das Hintergrundrechteck des Widgets, zu verwenden in Verbindung mit background-position und background-image.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, und einfachen QWidgets unterstützt.
Wird diese Eigenschaft nicht angegeben, ist der Standardwert padding.
Beispiel:
QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; }
Siehe auch Hintergrund und Das Boxmodell.
Rahmen
| Typ | Umrandung |
Kurzschreibweise für die Einstellung des Rahmens des Widgets. Entspricht der Angabe von border-color, border-style, und/oder border-width.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, und einfachen QWidgets unterstützt.
Beispiel:
QLineEdit { border: 1px solid white }
border-top
| Typ | Umrandung |
Kurzschreibweise für die Einstellung des oberen Randes des Widgets. Entspricht der Angabe von border-top-color, border-top-style, und/oder border-top-width.
Rand-rechts
| Typ | Umrandung |
Kurzschreibweise für die Einstellung des rechten Randes des Widgets. Entspricht der Angabe von border-right-color, border-right-style, und/oder border-right-width.
border-bottom
| Typ | Umrandung |
Kurzschreibweise für die Einstellung des unteren Randes des Widgets. Entspricht der Angabe von border-bottom-color, border-bottom-style, und/oder border-bottom-width.
border-left
| Typ | Umrandung |
Kurzschreibweise für die Einstellung des linken Randes des Widgets. Entspricht der Angabe von border-left-color, border-left-style, und/oder border-left-width.
Umrandung-Farbe
| Typ | Box-Farben |
Die Farbe aller Ränder des Rahmens. Äquivalent zur Angabe von border-top-color, border-right-color, border-bottom-color und border-left-color.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip und einfachen QWidgets unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig die Farbe (d. h. die Vordergrundfarbe des Widgets).
Beispiel:
QLineEdit { border-width: 1px; border-style: solid; border-color: white; }
Siehe auch border-style, border-width, border-image, und Das Box-Modell.
border-top-color
| Typ | Pinsel |
Die Farbe des oberen Randes des Rahmens.
border-right-color
| Typ | Pinsel |
Die Farbe des rechten Randes des Rahmens.
border-bottom-color
| Typ | Pinsel |
Die Farbe des unteren Randes des Rahmens.
border-left-color
| Typ | Pinsel |
Die Farbe des linken Randes des Rahmens.
border-image
Das Bild, das zum Füllen des Rahmens verwendet wird. Das Bild wird in neun Teile zerlegt und bei Bedarf entsprechend gestreckt. Siehe Randbild für weitere Informationen.
Diese Eigenschaft wird unterstützt von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit und QToolTip.
Siehe auch border-color, border-style, border-width und The Box Model.
border-radius
| Typ | Radius |
Der Radius der Ecken des Rahmens. Äquivalent zur Angabe von border-top-left-radius, border-top-right-radius, border-bottom-right-radius und border-bottom-left-radius.
Der border-radius begrenzt den Hintergrund des Elements.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit und QToolTip unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig 0.
Beispiel:
QLineEdit { border-width: 1px; border-style: solid; border-radius: 4px; }
Siehe auch border-width und The Box Model.
border-top-left-radius
| Typ | Radius |
Der Radius der oberen linken Ecke des Rahmens.
border-top-right-radius
| Typ | Radius |
Der Radius der oberen rechten Ecke des Rahmens.
border-bottom-right-radius
| Typ | Radius |
Der Radius der unteren rechten Ecke des Rahmens. Wenn Sie diese Eigenschaft auf einen positiven Wert setzen, wird die Ecke abgerundet.
border-bottom-left-radius
| Typ | Radius |
Der Radius der linken unteren Ecke des Rahmens. Wenn Sie diese Eigenschaft auf einen positiven Wert setzen, wird die Ecke abgerundet.
border-style
Der Stil für alle Kanten des Rahmens.
Diese Eigenschaft wird unterstützt von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, und QToolTip.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig auf none eingestellt.
Beispiel:
QLineEdit { border-width: 1px; border-style: solid; border-color: blue; }
Siehe auch border-color, border-style, border-image und Das Box-Modell.
border-top-style
Der Stil des oberen Randes des Rahmens.
border-right-style
Der Stil des rechten Randes des Rahmens.
border-bottom-style
Der Stil des unteren Randes des Rahmens.
border-left-style
Der Stil des linken Randes des Rahmens.
border-width
| Typ | Box-Längen |
Die Breite des Rahmens. Entspricht der Einstellung border-top-width, border-right-width, border-bottom-width und border-left-width.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit und QToolTip unterstützt.
Beispiel:
QLineEdit { border-width: 2px; border-style: solid; border-color: darkblue; }
Siehe auch border-color, border-radius, border-style, border-image, und Das Box-Modell.
border-top-width
| Typ | Länge |
Die Breite des oberen Randes des Rahmens.
border-right-width
| Typ | Länge |
Die Breite des rechten Randes des Rahmens.
border-bottom-width
| Typ | Länge |
Die Breite des unteren Randes des Rahmens.
border-left-width
| Typ | Länge |
Die Breite des linken Randes des Rahmens.
unten
| Typ | Länge |
Wenn Position relative ist (die Vorgabe), wird eine Untersteuerung um einen bestimmten Offset nach oben verschoben; die Angabe von bottom: y ist dann äquivalent zur Angabe von top: -y.
Wenn position absolute ist, gibt die Eigenschaft bottom die untere Kante des Untersteuerelements im Verhältnis zur unteren Kante des übergeordneten Elements an (siehe auch subcontrol-origin).
Beispiel:
QSpinBox::down-button { bottom: 2px }
Siehe auch links, rechts und oben.
Schaltflächen-Layout
| Typ | Nummer |
Die Anordnung der Schaltflächen in einem QDialogButtonBox oder einem QMessageBox. Die möglichen Werte sind 0 (WinLayout), 1 (MacLayout), 2 (KdeLayout), 3 (GnomeLayout) und 5 (AndroidLayout).
Wird diese Eigenschaft nicht angegeben, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den Stilhinweis SH_DialogButtonLayout festgelegt ist.
Beispiel:
* { button-layout: 2 }
Farbe
| Typ | Pinsel |
Die Farbe, die zum Rendern von Text verwendet wird.
Diese Eigenschaft wird von allen Widgets unterstützt, die die QWidget::palette respektieren.
Wenn diese Eigenschaft nicht festgelegt ist, wird standardmäßig die Farbe verwendet, die in der Palette des Widgets für QWidget::foregroundRole festgelegt ist (normalerweise Schwarz).
Beispiel:
QPushButton { color: red }
Siehe auch background und selection-color.
dialogbuttonbox-buttons-have-icons
Zeigt an, ob die Schaltflächen in einer QDialogButtonBox Icons haben.
Wenn diese Eigenschaft auf 1 gesetzt ist, zeigen die Schaltflächen eines QDialogButtonBox Icons an; wenn sie auf 0 gesetzt ist, werden die Icons nicht angezeigt.
Im Abschnitt Liste der Symbole finden Sie Informationen darüber, wie Sie Symbole festlegen können.
QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }
Hinweis: Stile, die diese Eigenschaft definieren, müssen angewendet werden, bevor das QDialogButtonBox erstellt wird; das bedeutet, dass Sie den Stil auf das übergeordnete Widget oder auf die Anwendung selbst anwenden müssen.
Schriftart
| Typ | Schriftart |
Kurzschreibweise für die Einstellung der Schriftart des Textes. Entspricht der Angabe von font-family, font-size, font-style, und/oder font-weight.
Diese Eigenschaft wird von allen Widgets unterstützt, die die QWidget::font respektieren.
Wenn diese Eigenschaft nicht festgelegt ist, wird standardmäßig die QWidget::font verwendet.
Beispiel:
QCheckBox { font: bold italic large "Times New Roman" }
font-family
| Typ | Zeichenfolge |
Die Schriftfamilie.
Beispiel:
QCheckBox { font-family: "New Century Schoolbook" }
font-size
| Typ | Schriftgröße |
Die Schriftgröße. In dieser Version von Qt werden nur die Metriken pt und px unterstützt.
Beispiel:
QTextEdit { font-size: 12px }
font-style
| Typ | Schriftstil |
Der Schriftstil.
Beispiel:
QTextEdit { font-style: italic }
font-weight
Das Gewicht der Schriftart.
Gitterlinien-Farbe*
| Typ | Farbe |
Die Farbe der Rasterlinie in einem QTableView.
Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den SH_Table_GridLineColor style hint angegeben ist.
Beispiel:
* { gridline-color: gray }
Höhe
| Typ | Länge |
Die Höhe eines Untersteuerelements (oder, in manchen Fällen, eines Widgets).
Wenn diese Eigenschaft nicht angegeben wird, wird sie standardmäßig auf einen Wert gesetzt, der von dem Untersteuerelement/Widget und dem aktuellen Stil abhängt.
Warnung: Wenn nicht anders angegeben, hat diese Eigenschaft keine Wirkung, wenn sie auf Widgets gesetzt wird. Wenn Sie ein Widget mit einer festen Höhe wünschen, setzen Sie min-height und max-height auf denselben Wert.
Beispiel:
QSpinBox::down-button { height: 10px }
Siehe auch width.
Symbol
| Typ | Url+ |
Das verwendete Symbol für Widgets, die ein Symbol haben.
Das einzige Widget, das diese Eigenschaft derzeit unterstützt, ist QPushButton.
Hinweis: Es liegt in der Verantwortung der Anwendung, einer Schaltfläche ein Symbol zuzuweisen (unter Verwendung der QAbstractButton API), und nicht in der des Styles. Seien Sie also vorsichtig mit der Einstellung, es sei denn, Ihr Stylesheet ist auf eine bestimmte Anwendung ausgerichtet.
Verfügbar seit 5.15.
icon-size
| Typ | Länge |
Die Breite und Höhe des Symbols in einem Widget.
Die Symbolgröße der folgenden Widgets kann mit dieser Eigenschaft festgelegt werden.
Bild*
| Typ | Url+ |
Das Bild, das im Inhaltsrechteck eines Untersteuerelements gezeichnet wird.
Die Eigenschaft image akzeptiert eine Liste von Urlsoder ein svg. Das tatsächliche Bild, das gezeichnet wird, wird mit demselben Algorithmus wie QIcon bestimmt (d. h. das Bild wird nie vergrößert, sondern immer verkleinert, falls erforderlich. Wird ein svg angegeben, wird das Bild auf die Größe des Inhaltsrechtecks skaliert.
Die Einstellung der Eigenschaft image für Untersteuerelemente legt implizit die Breite und Höhe des Untersteuerelements fest (es sei denn, das Bild ist ein SVG).
In Qt 4.3 und höher kann die Ausrichtung des Bildes innerhalb des Rechtecks mit image-position festgelegt werden.
Diese Eigenschaft ist nur für Untersteuerelemente - für andere Elemente wird sie nicht unterstützt.
Achtung! Das QIcon SVG-Plugin wird benötigt, um SVG-Bilder darzustellen.
Beispiel:
// implicitly sets the size of down-button to the // size of spindown.png QSpinBox::down-button { image: url(:/images/spindown.png) }
image-position
| Typ | Ausrichtung |
In Qt 4.3 und höher kann die Ausrichtung der Position des Bildes mit relativer oder absoluter Position angegeben werden.
links
| Typ | Länge |
Wenn Position relative ist (Standardeinstellung), wird ein Untersteuerelement um einen bestimmten Abstand nach rechts verschoben.
Wenn position absolute ist, gibt die Eigenschaft left den linken Rand des Untersteuerelements im Verhältnis zum linken Rand des übergeordneten Elements an (siehe auch subcontrol-origin).
Wird diese Eigenschaft nicht angegeben, ist sie standardmäßig auf 0 eingestellt.
Beispiel:
QSpinBox::down-button { left: 2px }
Siehe auch rechts, oben und unten.
lineedit-password-character*
| Typ | Nummer |
Das Kennwortzeichen QLineEdit als Unicode-Zahl.
Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den SH_LineEdit_PasswordCharacter style hint angegeben wurde.
Beispiel:
* { lineedit-password-character: 9679 }
lineedit-password-mask-delay*
| Typ | Nummer |
Die Verzögerung der Kennwortmaske QLineEdit in Millisekunden, bevor lineedit-password-character auf sichtbare Zeichen angewendet wird.
Wenn diese Eigenschaft nicht angegeben wird, wird sie standardmäßig auf den Wert gesetzt, der durch den aktuellen Stil für den SH_LineEdit_PasswordMaskDelay style hint angegeben ist.
Verfügbar seit Qt 5.4.
Beispiel:
* { lineedit-password-mask-delay: 1000 }
margin
| Typ | Box Längen |
Die Ränder des Widgets. Entspricht der Angabe von margin-top, margin-right, margin-bottom, und margin-left.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, und QToolTip unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig auf 0 eingestellt.
Beispiel:
QLineEdit { margin: 2px }
Siehe auch padding, spacing und The Box Model.
margin-top
| Typ | Länge |
Der obere Rand des Widgets.
margin-right
| Typ | Länge |
Der rechte Rand des Widgets.
rand-unten
| Typ | Länge |
Der untere Rand des Widgets.
margin-left
| Typ | Länge |
Der linke Rand des Widgets.
max-height
| Typ | Länge |
Die maximale Höhe des Widgets oder eines Untersteuerelements.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, und QToolTip unterstützt.
Der Wert bezieht sich auf das Inhalts-Rect im Box-Modell.
Beispiel:
QSpinBox { max-height: 24px }
Siehe auch max-width.
max-breite
| Typ | Länge |
Die maximale Breite des Widgets oder eines Untersteuerelements.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, und QToolTip unterstützt.
Der Wert bezieht sich auf das Inhalts-Rect im Box-Modell.
Beispiel:
QComboBox { max-width: 72px }
Siehe auch max-height.
messagebox-text-interaction-flags*
| Typ | Nummer |
Das Interaktionsverhalten für Text in einer Messagebox. Die möglichen Werte basieren auf Qt::TextInteractionFlags.
Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den SH_MessageBox_TextInteractionFlags style hint angegeben ist.
Beispiel:
QMessageBox { messagebox-text-interaction-flags: 5 }
min-height
| Typ | Länge |
Die Mindesthöhe des Widgets oder eines Untersteuerelements.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton, und QToolTip unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, wird die Mindesthöhe auf der Grundlage des Inhalts des Widgets und des Stils abgeleitet.
Der Wert bezieht sich auf das Inhaltsrect im Boxmodell.
Beispiel:
QComboBox { min-height: 24px }
Hinweis: Die Einstellung dieser Eigenschaft kann dazu führen, dass Widgets kleiner werden als der für den Inhalt benötigte Platz.
Siehe auch min-width.
min-width
| Typ | Länge |
Die Mindestbreite des Widgets oder eines Untersteuerelements.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton, und QToolTip unterstützt.
Wenn diese Eigenschaft nicht angegeben ist, wird die Mindestbreite auf der Grundlage des Widget-Inhalts und des Stils abgeleitet.
Der Wert ist relativ zum Inhalts-Rect im Box-Modell.
Beispiel:
QComboBox { min-width: 72px }
Hinweis: Die Einstellung dieser Eigenschaft kann dazu führen, dass Widgets kleiner werden als der für den Inhalt benötigte Platz.
Siehe auch min-height.
Opazität*
| Typ | Zahl |
Die Deckkraft für ein Widget. Mögliche Werte liegen zwischen 0 (transparent) und 255 (undurchsichtig). Im Moment wird dies nur für tooltips unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den SH_ToolTipLabel_Opacity style hint angegeben ist.
Beispiel:
QToolTip { opacity: 223 }
outline
Der Umriss, der um den Rand des Objekts gezeichnet wird.
outline-color
| Typ | Farbe |
Die Farbe des Umrisses. Siehe auch border-color
Umriss-Versatz
| Typ | Länge |
Abstand des Umrisses vom Rand des Widgets.
outline-style
Gibt das Muster an, das zum Zeichnen des Umrisses verwendet wird. Siehe auch border-style
Umriss-Radius
Fügt dem Umriss abgerundete Ecken hinzu.
outline-bottom-left-radius
| Typ | Radius |
Der Radius für die linke untere abgerundete Ecke des Umrisses.
outline-bottom-right-radius
| Typ | Radius |
Der Radius für die rechte untere abgerundete Ecke des Umrisses.
outline-top-left-radius
| Typ | Radius |
Der Radius für die linke obere Ecke des Umrisses.
outline-top-right-radius
| Typ | Radius |
Der Radius für die rechte obere abgerundete Ecke des Umrisses.
Auffüllung
| Typ | Box-Längen |
Die Füllung des Widgets. Entspricht der Angabe von padding-top, padding-right, padding-bottom, und padding-left.
Diese Eigenschaft wird von QAbstractItemView Unterklassen, QAbstractSpinBox Unterklassen, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, und QToolTip unterstützt.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig auf 0 eingestellt.
Beispiel:
QLineEdit { padding: 3px }
Siehe auch Rand, Abstand und Das Boxmodell.
padding-top
| Typ | Länge |
Die obere Füllung des Widgets.
padding-right
| Typ | Länge |
Die rechte Auffüllung des Widgets.
padding-bottom
| Typ | Länge |
Die untere Polsterung des Widgets.
padding-left
| Typ | Länge |
Der linke Abstand des Widgets.
paint-alternating-row-colors-for-empty-area
| Typ | bool |
Gibt an, ob QTreeView für den leeren Bereich (d. h. den Bereich, in dem sich keine Artikel befinden) abwechselnde Reihenfarben malt.
platzhalter-text-farbe*
| Typ | Pinsel |
Die Farbe, die für den Platzhaltertext von Textbearbeitungs-Widgets verwendet wird.
Wenn diese Eigenschaft nicht festgelegt ist, ist der Standardwert derjenige, der für die Rolle PlaceholderText der Palette festgelegt ist.
Beispiel:
QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */
Verfügbar seit 6.5.
Position
| Typ | relative | absolute |
Ob die mit links, rechts, oben und unten angegebenen Versätze relative oder absolute Koordinaten sind.
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig auf relative eingestellt.
rechts
| Typ | Länge |
Wenn Position relative ist (die Vorgabe), wird ein Untersteuerelement um einen bestimmten Offset nach links verschoben; die Angabe von right: x ist dann äquivalent zur Angabe von left: -x.
Wenn position absolute ist, gibt die Eigenschaft right den rechten Rand des Untersteuerelements im Verhältnis zum rechten Rand des übergeordneten Elements an (siehe auch subcontrol-origin).
Beispiel:
QSpinBox::down-button { right: 2px }
Siehe auch links, oben und unten.
auswahl-hintergrund-farbe*
| Typ | Pinsel |
Der Hintergrund von ausgewähltem Text oder Elementen.
Diese Eigenschaft wird von allen Widgets unterstützt, die QWidget::palette respektieren und die Auswahltext anzeigen.
Wenn diese Eigenschaft nicht festgelegt ist, ist der Standardwert derjenige, der für die Rolle Highlight der Palette festgelegt ist.
Beispiel:
QTextEdit { selection-background-color: darkblue }
Siehe auch selection-color und background.
auswahl-farbe*
| Typ | Pinsel |
Der Vordergrund von ausgewähltem Text oder Elementen.
Diese Eigenschaft wird von allen Widgets unterstützt, die QWidget::palette respektieren und die Auswahltext anzeigen.
Wenn diese Eigenschaft nicht festgelegt ist, ist der Standardwert derjenige, der für die Rolle HighlightedText der Palette festgelegt ist.
Beispiel:
QTextEdit { selection-color: white }
Siehe auch selection-background-color und color.
show-decoration-selected*
Steuert, ob Markierungen in einer QListView die gesamte Zeile oder nur den Umfang des Textes abdecken.
Wenn diese Eigenschaft nicht angegeben ist, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den SH_ItemView_ShowDecorationSelected style hint angegeben ist.
Beispiel:
* { show-decoration-selected: 1 }
abstand*
| Typ | Länge |
Interne Abstände im Widget.
Diese Eigenschaft wird unterstützt von QCheckBox, checkable QGroupBoxes, QMenuBar und QRadioButton.
Wenn diese Eigenschaft nicht angegeben wird, hängt der Standardwert vom Widget und vom aktuellen Stil ab.
Beispiel:
QMenuBar { spacing: 10 }
Siehe auch padding und margin.
subcontrol-origin*
| Typ | Ursprung |
Das Ursprungsrechteck des Untersteuerelements innerhalb des übergeordneten Elements.
Wird diese Eigenschaft nicht angegeben, ist der Standardwert padding.
Beispiel:
QSpinBox::up-button { image: url(:/images/spinup.png); subcontrol-origin: content; subcontrol-position: right top; }
Siehe auch subcontrol-position.
Untersteuerungs-Position*
| Typ | Ausrichtung |
Die Ausrichtung des Untersteuerelements innerhalb des durch subcontrol-origin angegebenen Ursprungsrechtecks.
Wenn diese Eigenschaft nicht angegeben ist, wird standardmäßig ein Wert verwendet, der vom Untersteuerelement abhängt.
Beispiel:
QSpinBox::down-button { image: url(:/images/spindown.png); subcontrol-origin: padding; subcontrol-position: right bottom; }
Siehe auch subcontrol-origin.
titlebar-show-tooltips-on-buttons
| Typ | bool |
Ob Tooltips auf den Schaltflächen der Titelleiste des Fensters angezeigt werden.
widget-animation-dauer*
| Typ | Zahl |
Wie lange eine Animation dauern soll (in Millisekunden). Ein Wert gleich Null bedeutet, dass die Animationen deaktiviert werden.
Wird diese Eigenschaft nicht angegeben, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den SH_Widget_Animation_Duration style hint angegeben wurde.
Verfügbar seit Qt 5.10.
Beispiel:
* { widget-animation-duration: 100 }
text-align
| Typ | Ausrichtung |
Die Ausrichtung von Text und Symbol innerhalb des Inhalts des Widgets.
Wenn dieser Wert nicht angegeben wird, wird er standardmäßig auf den Wert gesetzt, der vom nativen Stil abhängt.
Beispiel:
QPushButton { text-align: left; }
Diese Eigenschaft wird derzeit nur von QPushButton und QProgressBar unterstützt.
text-decoration
| Typ | none underline overline line-through |
Zusätzliche Texteffekte.
oben
| Schrift | Länge |
Wenn Position relative ist (Standardeinstellung), wird eine Untersteuerung um einen bestimmten Versatz nach unten verschoben.
Wenn position absolute ist, gibt die Eigenschaft top die Oberkante des Untersteuerelements im Verhältnis zur Oberkante des übergeordneten Elements an (siehe auch subcontrol-origin).
Wenn diese Eigenschaft nicht angegeben wird, ist sie standardmäßig auf 0 eingestellt.
Beispiel:
QSpinBox::up-button { top: 2px }
Siehe auch links, rechts und unten.
Breite
| Typ | Länge |
Die Breite eines Untersteuerelements (oder in manchen Fällen eines Widgets).
Wenn diese Eigenschaft nicht angegeben wird, wird sie standardmäßig auf einen Wert gesetzt, der vom Untersteuerelement/Widget und vom aktuellen Stil abhängt.
Warnung: Wenn nicht anders angegeben, hat diese Eigenschaft keine Wirkung, wenn sie auf Widgets gesetzt wird. Wenn Sie ein Widget mit einer festen Breite wünschen, setzen Sie min-width und max-width auf denselben Wert.
Beispiel:
QSpinBox::up-button { width: 12px }
Siehe auch height.
-qt-hintergrund-rolle
| Typ | PaletteRole |
Die background-color für das Untersteuerelement oder Widget basierend auf der gewählten Rolle.
-qt-style-features
| Typ | list |
Die Liste der CSS-Eigenschaften, auf die Sie Qt-spezifische Stile anwenden möchten.
Hinweis: list kann nur Eigenschaften enthalten, die nicht pixmap-basiert sind.
Liste der Icons
Die in Qt verwendeten Icons können mit den folgenden Eigenschaften angepasst werden. Jede der in diesem Abschnitt aufgeführten Eigenschaften hat den Typ Icon.
Beachten Sie, dass Sie die Eigenschaft dialogbuttonbox-buttons-have-icons auf true setzen müssen, damit Icons in den Schaltflächen von QDialogButtonBox erscheinen. Um die Größe der Icons anzupassen, verwenden Sie die Eigenschaft icon-size.
Liste der Eigenschaftstypen
In der folgenden Tabelle sind die Syntax und die Bedeutung der verschiedenen Eigenschaftstypen zusammengefasst.
| Typ | Syntax | Beschreibung |
|---|---|---|
| Ausrichtung | { top | bottom | left | right | center }* | Horizontal and/or vertical alignment. Example: QTextEdit { background-position: bottom center } |
| Anhang | { scroll | fixed }* | Scroll or fixed attachment. |
| Hintergrund | { Brush | Url | Repeat | Alignment }* | Eine Folge von Brush, Url, Repeat und Alignment. |
| Boolescher Wert | 0 | 1 | Wahr (1) oder falsch (0).Beispiel: QDialog { etch-disabled-text: 1 } |
| Border | { Border Style | Länge | Pinsel }* | Umrandungseigenschaft in Kurzform. |
| Border Image | none | Url Number{4} ( stretch | repeat){0,2} | A border image is an image that is composed of nine parts (top left, top center, top right, center left, center, center right, bottom left, bottom center, and bottom right). When a border of a certain size is required, the corner parts are used as is, and the top, right, bottom, and left parts are stretched or repeated to produce a border with the desired size. See the CSS3 Draft Specification for details. |
| Umrandung Stil | dashed | dot-dash | dot-dot-dash | dotted | double | groove | inset | outset | ridge | solid | none | Specifies the pattern used to draw a border. See the CSS3 Draft Specification for details. |
| Box-Farben | Pinsel{1,4} | Ein bis vier Vorkommen von Brush, die jeweils den oberen, rechten, unteren und linken Rand eines Kastens angeben. Wenn die linke Farbe nicht angegeben wird, wird sie als dieselbe wie die rechte Farbe angenommen. Wenn die untere Farbe nicht angegeben ist, wird sie mit der oberen Farbe gleichgesetzt. Wenn die rechte Farbe nicht angegeben ist, wird sie mit der oberen Farbe gleichgesetzt. Beispiel: |
| Kästchenlängen | Länge{1,4} | Ein bis vier Vorkommen von Length, die jeweils die obere, rechte, untere und linke Kante eines Feldes angeben. Wenn die linke Länge nicht angegeben ist, wird sie als gleich der rechten Länge angenommen. Wenn die untere Länge nicht angegeben ist, wird angenommen, dass sie mit der oberen Länge übereinstimmt. Wenn die rechte Länge nicht angegeben ist, wird angenommen, dass sie der oberen Länge entspricht. Beispiele: |
| Pinsel | Farbe | Farbverlauf | PaletteRole | Gibt eine Farbe oder einen Farbverlauf oder einen Eintrag in der Palette an. |
| Farbe | rgb(r, g, b) | rgba(r, g, b, a) | hsv(h, s, v) | hsva(h, s, v, a) | hsl(h, s, l) | hsla(h, s, l, a) | #rrggbb | Color Name | Gibt eine Farbe als RGB (Rot, Grün, Blau), RGBA (Rot, Grün, Blau, Alpha), HSV (Farbton, Sättigung, Wert), HSVA (Farbton, Sättigung, Wert, Alpha), HSL (Farbton, Sättigung, Helligkeit), HSLA (Farbton, Sättigung, Helligkeit, Alpha) oder eine benannte Farbe an. Die Syntax rgb() oder rgba() kann mit ganzzahligen Werten zwischen 0 und 255 oder mit Prozentwerten verwendet werden. Die Werte von s, v, l und a in hsv(), hsva() hsl() oder hsla() müssen alle im Bereich 0-255 oder bei Prozentwerten liegen, der Wert von h muss im Bereich 0-359 liegen. Die Unterstützung für HSL(A) ist seit 5.13 verfügbar.Beispiele: /* opaque red */ QLabel { border-color: red } /* opaque red */ QLabel { border-color: #FF0000 } /* 75% opaque red */ QLabel { border-color: rgba(255, 0, 0, 75%) } /* opaque red */ QLabel { border-color: rgb(255, 0, 0) } /* opaque red */ QLabel { border-color: rgb(100%, 0%, 0%) } /* opaque yellow */ QLabel { border-color: hsv(60, 100%, 100%) } /* 75% blue */ QLabel { border-color: hsva(240, 255, 255, 75%) } /* opaque yellow */ QLabel { border-color: hsl(60, 100%, 50%) } /* 75% blue */ QLabel { border-color: hsla(240, 255, 50%, 75%) } Hinweis: Die erlaubten RGB-Farben sind die gleichen wie die in CSS 2.1 erlaubten, wie hier aufgeführt. |
| Schriftart | (Schriftstil | Schriftstärke){0,2} Schriftgröße String | Shorthand-Schrifteigenschaft. |
| Schriftgröße | Länge | Die Größe einer Schriftart. |
| Schriftstil | normal | italic | oblique | The style of a font. |
| Schriftart Gewicht | normal | bold | 100 | 200 ... | 900 | The weight of a font. |
| Steigung | qlineargradient | qradialgradient | qconicalgradient | Specifies gradient fills. There are three types of gradient fills:
Farbverläufe werden im Objektbegrenzungsmodus angegeben. Stellen Sie sich den Rahmen, in dem der Farbverlauf gerendert wird, so vor, dass seine obere linke Ecke bei (0, 0) und seine untere rechte Ecke bei (1, 1) liegt. Die Parameter des Farbverlaufs werden dann als Prozentwerte von 0 bis 1 angegeben. Diese Werte werden zur Laufzeit auf die tatsächlichen Koordinaten der Box extrapoliert. Es ist möglich, Werte anzugeben, die außerhalb des Begrenzungsrahmens liegen (z. B. -0,6 oder 1,8). Achtung! Die Stopps müssen in aufsteigender Reihenfolge erscheinen. Beispiele: /* linear gradient from white to green */ QTextEdit { background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 white, stop: 0.4 gray, stop:1 green) } /* linear gradient from white to green */ QTextEdit { background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 white, stop: 0.4 rgba(10, 20, 30, 40), stop:1 rgb(0, 200, 230, 200)) } /* conical gradient from white to green */ QTextEdit { background: qconicalgradient(cx:0.5, cy:0.5, angle:30, stop:0 white, stop:1 #00FF00) } /* radial gradient from white to green */ QTextEdit { background: qradialgradient(cx:0, cy:0, radius: 1, fx:0.5, fy:0.5, stop:0 white, stop:1 green) } |
| Icon | (Url (disabled | active | normal | selected)? (on | off)? )* | Eine Liste von Url, QIcon::Mode und QIcon::State. Beispiel: * { file-icon: url(file.png), url(file_selected.png) selected; } QMessageBox { dialogbuttonbox-buttons-have-icons: true; dialog-ok-icon: url(ok.svg); dialog-cancel-icon: url(cancel.png), url(grayed_cancel.png) disabled; } |
| Länge | Zahl (px | pt | em | ex)? | Eine Zahl, gefolgt von einer Maßeinheit. Der CSS-Standard empfiehlt, dass User-Agents eine Deklaration mit einem illegalen Wert ignorieren müssen. In Qt ist es obligatorisch, Maßeinheiten anzugeben. Aus Gründen der Kompatibilität mit früheren Versionen von Qt werden Zahlen ohne Maßeinheiten in den meisten Kontexten als Pixel behandelt. Die unterstützten Einheiten sind:
Qt ist jedoch auf die Schriftgrößen |
| Zahl | Eine dezimale Ganzzahl oder eine reelle Zahl | Beispiele: 0, 18, +127, -255, 12.34, -.5, 0009. |
| Ursprung | margin | border | padding | content | Indicates which of four rectangles to use.
Siehe auch Das Box-Modell. |
| PaletteRole | alternate-base | accent | base | bright-text | button | button-text | dark | highlight | highlighted-text | light | link | link-visited | mid | midlight | shadow | text | window | window-text | Diese Werte entsprechen den Color roles im Widget QPalette . Zum Beispiel QPushButton { color: palette(dark); } |
| Radius | Länge{1, 2} | Ein oder zwei Vorkommen von Länge. Wenn nur eine Länge angegeben wird, wird diese als Radius des Viertelkreises verwendet, der die Ecke definiert. Wenn zwei Längen angegeben werden, ist die erste Länge der horizontale Radius einer Viertelellipse, während die zweite Länge der vertikale Radius ist. |
| Wiederholung | repeat-x | repeat-y | repeat | no-repeat | A value indicating the nature of repetition.
|
| Url | url(filename) | filename ist der Name einer Datei auf der lokalen Festplatte oder mit dem Qt Resource System gespeichert. Das Setzen eines Bildes setzt implizit auch die Breite und Höhe des Elements. |
Liste der Pseudo-Zustände
Die folgenden Pseudo-Zustände werden unterstützt:
| Pseudo-Zustand | Beschreibung |
|---|---|
:active | Dieser Status wird gesetzt, wenn sich das Widget in einem aktiven Fenster befindet. |
:adjoins-item | Dieser Zustand wird gesetzt, wenn der ::Zweig eines QTreeView an ein Element angrenzt. |
:alternate | Dieser Zustand wird für jede alternative Zeile gesetzt, die die Zeile eines QAbstractItemView malt, wenn QAbstractItemView::alternatingRowColors() auf true gesetzt ist. |
:bottom | Das Element wird am unteren Rand positioniert. Zum Beispiel ein QTabBar, dessen Registerkarten unten positioniert sind. |
:checked | Das Element ist markiert. Zum Beispiel der Zustand checked von QAbstractButton. |
:closable | Die Elemente können geschlossen werden. Zum Beispiel ist bei QDockWidget die Funktion QDockWidget::DockWidgetClosable aktiviert. |
:closed | Das Element befindet sich im geschlossenen Zustand. Zum Beispiel ein nicht-erweiterter Eintrag in einer QTreeView |
:default | Der Eintrag ist der Standardeintrag. Zum Beispiel ein default QPushButton oder eine Standardaktion in einem QMenu. |
:disabled | Das Element ist disabled. |
:editable | Das Element QComboBox ist bearbeitbar. |
:edit-focus | Das Element hat den Bearbeitungsfokus (siehe QStyle::State_HasEditFocus). Dieser Status ist nur für Qt Extended-Anwendungen verfügbar. |
:enabled | Das Element ist enabled. |
:exclusive | Der Eintrag ist Teil einer exklusiven Eintragsgruppe. Zum Beispiel ein Menüpunkt in einer exklusiven QActionGroup. |
:first | Das Element ist das erste (in einer Liste). Zum Beispiel die erste Registerkarte in einem QTabBar. |
:flat | Das Element ist flach. Zum Beispiel ein flat QPushButton . |
:floatable | Die Elemente können frei beweglich sein. Beispiel: QDockWidget hat die Funktion QDockWidget::DockWidgetFloatable aktiviert. |
:focus | Das Element hat input focus. |
:has-children | Das Element hat Kinder. Zum Beispiel ein Element in einem QTreeView, das untergeordnete Elemente hat. |
:has-siblings | Der Artikel hat Geschwister. Zum Beispiel, ein Element in einem QTreeView, das Geschwister hat. |
:horizontal | Das Element hat eine horizontale Ausrichtung |
:hover | Der Mauszeiger bewegt sich über dem Element. |
:indeterminate | Das Element hat einen unbestimmten Status. Zum Beispiel ist ein QCheckBox oder QRadioButton partially checked . |
:last | Das Element ist das letzte (in einer Liste). Zum Beispiel die letzte Registerkarte in einer QTabBar. |
:left | Das Element ist links positioniert. Zum Beispiel eine QTabBar, deren Registerkarten links positioniert sind. |
:maximized | Das Element ist maximiert. Zum Beispiel ein maximiertes QMdiSubWindow. |
:middle | Das Element befindet sich in der Mitte (in einer Liste). Zum Beispiel eine Registerkarte, die sich nicht am Anfang oder am Ende einer QTabBar befindet. |
:minimized | Das Element ist minimiert. Zum Beispiel ein minimiertes QMdiSubWindow. |
:movable | Das Element kann verschoben werden. Beispiel: QDockWidget hat die Funktion QDockWidget::DockWidgetMovable aktiviert. |
:no-frame | Das Element hat keinen Rahmen. Zum Beispiel ein rahmenloses QSpinBox oder QLineEdit. |
:non-exclusive | Der Eintrag ist Teil einer nicht-exklusiven Eintragsgruppe. Zum Beispiel ein Menüpunkt in einer nicht-exklusiven QActionGroup. |
:off | Bei Elementen, die umgeschaltet werden können, gilt dies für Elemente im Zustand "Aus". |
:on | Bei Elementen, die umgeschaltet werden können, gilt dies für Widgets im "Ein"-Zustand. |
:only-one | Das Element ist das einzige Element (in einer Liste). Zum Beispiel eine einzelne Registerkarte in einer QTabBar. |
:open | Das Element befindet sich im geöffneten Zustand. Zum Beispiel ein aufgeklapptes Element in einem QTreeView oder ein QComboBox oder QPushButton mit einem offenen Menü. |
:next-selected | Das nächste Element (in einer Liste) ist ausgewählt. Zum Beispiel befindet sich die ausgewählte Registerkarte einer QTabBar neben diesem Element. |
:pressed | Das Element wird gerade mit der Maus gedrückt. |
:previous-selected | Das vorherige Element (in einer Liste) ist ausgewählt. Zum Beispiel eine Registerkarte in einer QTabBar, die sich neben der ausgewählten Registerkarte befindet. |
:read-only | Das Element ist als schreibgeschützt oder nicht editierbar gekennzeichnet. Zum Beispiel eine schreibgeschützte QLineEdit oder eine nicht editierbare QComboBox. |
:right | Das Element ist rechts positioniert. Zum Beispiel ein QTabBar, dessen Registerkarten rechts positioniert sind. |
:selected | Das Element ist ausgewählt. Zum Beispiel die ausgewählte Registerkarte in einer QTabBar oder das ausgewählte Element in einer QMenu. |
:top | Das Element ist oben positioniert. Zum Beispiel ein QTabBar, dessen Registerkarten oben positioniert sind. |
:unchecked | Das Element ist unchecked. |
:vertical | Das Element ist vertikal ausgerichtet. |
:window | Das Widget ist ein Fenster (d. h. ein Widget der obersten Ebene). |
Liste der Untersteuerelemente
Die folgenden Sub-Controls sind verfügbar:
| Untersteuerelement | Beschreibung |
|---|---|
::add-line | Die Schaltfläche zum Hinzufügen einer Zeile eines QScrollBar. |
::add-page | Der Bereich zwischen dem Griff (Schieberegler) und der hinzugefügten Zeile eines QScrollBar. |
::branch | Die Verzweigungsanzeige eines QTreeView. |
::chunk | Der Fortschrittsanzeiger eines QProgressBar. |
::close-button | Die Schaltfläche zum Schließen einer QDockWidget oder von Tabs QTabBar |
::corner | Die Ecke zwischen zwei Scrollbars in einem QAbstractScrollArea |
::down-arrow | Der Abwärtspfeil eines QComboBox, QHeaderView (Sortieranzeige), QScrollBar oder QSpinBox. |
::down-button | Die Abwärts-Schaltfläche eines QScrollBar oder eines QSpinBox. |
::drop-down | Die Dropdown-Schaltfläche eines QComboBox. |
::float-button | Die Float-Taste eines QDockWidget |
::groove | Die Rille eines QSlider. |
::indicator | Der Indikator eines QAbstractItemView, eines QCheckBox, eines QRadioButton, eines überprüfbaren QMenu oder eines überprüfbaren QGroupBox. |
::handle | Der Griff (Schieberegler) eines QScrollBar, eines QSplitter, oder eines QSlider. |
::icon | Das Symbol eines QAbstractItemView oder eines QMenu. |
::item | Ein Element eines QAbstractItemView, eines QMenuBar, eines QMenu oder eines QStatusBar. |
::left-arrow | Der linke Pfeil einer QScrollBar. |
::left-corner | Die linke Ecke eines QTabWidget. Dieses Steuerelement kann zum Beispiel verwendet werden, um die Position des linken Eck-Widgets in einem QTabWidget zu steuern. |
::menu-arrow | Der Pfeil eines QToolButton mit einem Menü. |
::menu-button | Die Menütaste eines QToolButton. |
::menu-indicator | Die Menüanzeige eines QPushButton. |
::right-arrow | Der rechte Pfeil eines QMenu oder eines QScrollBar. |
::pane | Das Fenster (Rahmen) eines QTabWidget. |
::right-corner | Die rechte Ecke eines QTabWidget. Dieses Steuerelement kann beispielsweise verwendet werden, um die Position des Widgets der rechten Ecke in einem QTabWidget zu steuern. |
::scroller | Der Scroller einer QMenu oder QTabBar. |
::section | Der Abschnitt eines QHeaderView. |
::separator | Das Trennzeichen in einem QMenu oder in einem QMainWindow. |
::sub-line | Die Schaltfläche zum Subtrahieren einer Zeile in einem QScrollBar. |
::sub-page | Der Bereich zwischen dem Griff (Schieberegler) und der Unterzeile eines QScrollBar. |
::tab | Der Tabulator eines QTabBar oder QToolBox. |
::tab-bar | Die Tabulatorleiste eines QTabWidget. Dieses Untersteuerelement dient nur dazu, die Position des QTabBar innerhalb des QTabWidget zu steuern. Um die Tabulatoren mit dem Untersteuerelement ::tab zu gestalten. |
::tear | Der Abrissindikator eines QTabBar. |
::tearoff | Der Abrissindikator eines QMenu. |
::text | Der Text eines QAbstractItemView. |
::title | Der Titel eines QGroupBox oder eines QDockWidget. |
::up-arrow | Der Aufwärtspfeil eines QHeaderView (Sortierkennzeichen), QScrollBar oder eines QSpinBox. |
::up-button | Die Aufwärts-Schaltfläche eines QSpinBox. |
Ein Beispiel für die Anpassung eines Untersteuerelements finden Sie unter Anpassen des Untersteuerelements für den Menüindikator von QPushButton.
© 2025 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.
