Qt-Stylesheet-Referenz

Qt-Stylesheets unterstützen verschiedene Eigenschaften, Pseudozustände und Untersteuerelemente, mit denen sich das Erscheinungsbild von Widgets anpassen lässt.

Liste der anpassbaren Widgets

Die folgende Tabelle listet die Qt Widgets auf, die mithilfe von Stylesheets angepasst werden können:

QPushButton { background-color: red; border: none; }

QToolButton { background-color: red; border: none; }

void CustomWidget::paintEvent(QPaintEvent *)
{
    QStyleOption opt;
    opt.initFrom(this);
    QPainter p(this);
    style()->drawPrimitive(QStyle::PE_Widget, &opt, &p, this);
}

Liste der Eigenschaften

In diesem Abschnitt sind alle von Qt Style Sheets unterstützten Eigenschaften aufgeführt. Welche Werte einer Eigenschaft zugewiesen werden können, hängt vom Typ der Eigenschaft ab. Sofern nicht anders angegeben, gelten die folgenden Eigenschaften für alle Widgets. Mit einem Sternchen * gekennzeichnete Eigenschaften sind Qt-spezifisch und haben keine Entsprechung in CSS2 oder CSS3. Die Qt-spezifischen Eigenschaften sind die folgenden:

• gridline-color*
• image*
• lineedit-password-character*
• lineedit-password-mask-delay*
• Meldungsfeld-Text-Interaktionsflags*
• Opazität*
• Platzhaltertext-Farbe*
• Auswahl-Hintergrundfarbe*
• Auswahlfarbe*
• Dekoration-bei-Auswahl-anzeigen*
• Abstand*
• Ursprung des Untersteuerelements*
• Subcontrol-Position*
• Widget-Animationsdauer*

Akzentfarbe

Die Eigenschaft legt die „ Accent “ fest, die zur Hervorhebung interaktiver UI-Elemente verwendet wird. Wenn diese Eigenschaft nicht festgelegt ist, wird standardmäßig die Farbe „ highlight “ verwendet.

alternate-background-color

Der „ alternate background color “ wird in Unterklassen von „ QAbstractItemView “ verwendet.

Wenn diese Eigenschaft nicht festgelegt ist, gilt der Standardwert, der für die Rolle „ AlternateBase “ der Palette festgelegt wurde.

Beispiel:

QTreeView {
    alternate-background-color: blue;
    background: yellow;
}

Siehe auch „background “ und „selection-background-color“.

background

Kurzschreibweise zum Festlegen des Hintergrunds. Entspricht der Angabe von „ background-color “, „ background-image “, „ background-repeat “ und/oder „ background-position “.

Diese Eigenschaft wird von Unterklassen von „ QAbstractItemView “, Unterklassen von „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QDialog “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “, „ QToolTip “ sowie von einfachen „ QWidgets“ unterstützt.

Beispiel:

QTextEdit { background: yellow }

Häufig ist es erforderlich, ein Füllmuster festzulegen, das den Stilen unter Qt::BrushStyle ähnelt. 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 erzielen, 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

Die für das Widget verwendete Hintergrundfarbe.

Beispiele:

QLabel { background-color: yellow }
QLineEdit { background-color: rgb(255, 0, 0) }

Hintergrundbild

Das für das Widget verwendete Hintergrundbild. Durch halbtransparente Bereiche des Bildes scheint das „ background-color “ hindurch.

Beispiel:

QFrame { background-image: url(:/images/hydro.png) }

background-repeat

Ob und wie das Hintergrundbild wiederholt wird, um das Rechteck „ background-origin “ auszufü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

Die Ausrichtung des Hintergrundbildes innerhalb des Rechtecks „ background-origin “.

Wenn diese Eigenschaft nicht angegeben ist, erfolgt die Ausrichtung „ top “ left.

Beispiel:

QFrame {
    background: url(:/images/footer.png);
    background-position: bottom left;
}

background-attachment

Legt fest, ob das Hintergrundbild in einem „ QAbstractScrollArea “ mit dem Viewport mitgescrollt wird oder relativ zum Viewport fixiert bleibt. Standardmäßig wird das Hintergrundbild mit dem Viewport mitgescrollt.

Beispiel:

QTextEdit {
    background-image: url("leaves.png");
    background-attachment: fixed;
}

Siehe auch „background“

background-clip

Das Rechteck des Widgets, in dem der „ background “ gezeichnet wird.

Diese Eigenschaft legt das Rechteck fest, auf das die Werte „ background-color “ und „ background-image “ beschnitten werden.

Diese Eigenschaft wird von Unterklassen von „ QAbstractItemView “, „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QDialog “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “, „ QToolTip “ sowie von einfachen „ QWidgets“ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, lautet 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

Das Hintergrundrechteck des Widgets, zur Verwendung in Verbindung mit „ background-position “ und „ background-image “.

Diese Eigenschaft wird von Unterklassen von „ QAbstractItemView “, „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QDialog “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “, „ QToolTip “ sowie von einfachen „ QWidgets“ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, lautet der Standardwert „ padding “.

Beispiel:

QFrame {
    background-image: url(:/images/header.png);
    background-position: top left;
    background-origin: content;
}

Siehe auch „background “ und „Das Box-Modell“.

border

Kurzschreibweise zum Festlegen des Rahmens des Widgets. Entspricht der Angabe von „ border-color “, „ border-style “ und/oder „ border-width “.

Diese Eigenschaft wird von Unterklassen von „ QAbstractItemView “, Unterklassen von „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “, „ QToolTip “ sowie von einfachen „ QWidgets“ unterstützt.

Beispiel:

QLineEdit { border: 1px solid white }

border-top

Kurzschreibweise zum Festlegen des oberen Rahmens des Widgets. Entspricht der Angabe von „ border-top-color “, „ border-top-style “ und/oder „ border-top-width “.

border-right

Kurzschreibweise zum Festlegen des rechten Randes des Widgets. Entspricht der Angabe von „ border-right-color “, „ border-right-style “ und/oder „ border-right-width “.

border-bottom

Kurzschreibweise zum Festlegen des unteren Rahmens des Widgets. Entspricht der Angabe von „ border-bottom-color “, „ border-bottom-style “ und/oder „ border-bottom-width “.

border-left

Kurzschreibweise zum Festlegen des linken Randes des Widgets. Entspricht der Angabe von „ border-left-color “, „ border-left-style “ und/oder „ border-left-width “.

border-color

Die Farbe aller Kanten des Rahmens. Entspricht der Angabe von „ border-top-color “, „ border-right-color “, „ border-bottom-color “ und „ border-left-color “.

Diese Eigenschaft wird von Unterklassen von „ QAbstractItemView “, „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “, „ QToolTip “ sowie von einfachen „ QWidget“ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, gilt standardmäßig die Farbe „color“ (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

Die Farbe der Oberkante des Rahmens.

border-right-color

Die Farbe des rechten Randes des Rahmens.

border-bottom-color

Die Farbe der unteren Kante des Rahmens.

border-left-color

Die Farbe des linken Randes des Rahmens.

border-image

Das Bild, das zum Ausfüllen des Rahmens verwendet wird. Das Bild wird in neun Teile zerlegt und bei Bedarf entsprechend gestreckt. Weitere Informationen finden Sie unter „Rahmenbild “.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “ und „ QToolTip “ unterstützt.

Siehe auch „border-color“, „border-style“, „border-width“ und „Das Box-Modell“.

border-radius

Der Radius der Ecken des Rahmens. Entspricht der Angabe von „ border-top-left-radius “, „ border-top-right-radius “, „ border-bottom-right-radius “ und „ border-bottom-left-radius “.

Der `border-radius` schneidet den Hintergrund des Elements ab.

Diese Eigenschaft wird von den Unterklassen von QAbstractItemView, den Unterklassen von QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit und QToolTip unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, ist der Standardwert 0.

Beispiel:

QLineEdit {
    border-width: 1px;
    border-style: solid;
    border-radius: 4px;
}

Siehe auch „border-width “ und „Das Box-Modell“.

border-top-left-radius

Der Radius der oberen linken Ecke des Rahmens.

border-top-right-radius

Der Radius der oberen rechten Ecke des Rahmens.

border-bottom-right-radius

Der Radius der unteren rechten Ecke des Rahmens. Wenn Sie für diese Eigenschaft einen positiven Wert festlegen, wird die Ecke abgerundet.

border-bottom-left-radius

Der Radius der unteren linken Ecke des Rahmens. Wird diese Eigenschaft auf einen positiven Wert gesetzt, entsteht eine abgerundete Ecke.

border-style

Der Stil aller Kanten des Rahmens.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “ und „ QToolTip “ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, lautet der Standardwert „ none “.

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 der oberen Kante des Rahmens.

border-right-style

Der Stil der rechten Kante des Rahmens.

border-bottom-style

Der Stil der unteren Kante des Rahmens.

border-left-style

Der Stil der linken Kante des Rahmens.

border-width

Die Breite des Rahmens. Entspricht der Einstellung von border-top-width, border-right-width, border-bottom-width und border-left-width.

Diese Eigenschaft wird von den Unterklassen von ` QAbstractItemView `, den Unterklassen von ` QAbstractSpinBox `, sowie von ` 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

Die Breite der oberen Kante des Rahmens.

border-right-width

Die Breite des rechten Randes der Umrandung.

border-bottom-width

Die Breite der unteren Kante des Rahmens.

border-left-width

Die Breite der linken Kante des Rahmens.

unten

Wenn die Position auf „ relative “ gesetzt ist (Standard), wird ein Unterelement um einen bestimmten Versatz nach oben verschoben; die Angabe bottom: y entspricht dann der Angabe von top: -y.

Wenn die Position „ absolute “ ist, legt die Eigenschaft „ bottom “ die Unterkante des Untersteuerelements relativ zur Unterkante des übergeordneten Elements fest (siehe auch „subcontrol-origin“).

Beispiel:

QSpinBox::down-button { bottom: 2px }

Siehe auch „left“, „right“ und „top“.

Schaltflächenanordnung

Das Layout der Schaltflächen in einem „ QDialogButtonBox “ oder einem „ QMessageBox “. Mögliche Werte sind 0 (WinLayout), 1 (MacLayout), 2 (KdeLayout), 3 (GnomeLayout) und 5 (AndroidLayout).

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den Stilhinweis „ SH_DialogButtonLayout “ festgelegt ist.

Beispiel:

* { button-layout: 2 }

Farbe

Die Farbe, die zum Darstellen von Text verwendet wird.

Diese Eigenschaft wird von allen Widgets unterstützt, die die Eigenschaft „ QWidget::palette “ berücksichtigen.

Wenn diese Eigenschaft nicht festgelegt ist, gilt als Standardwert die in der Palette des Widgets für die Eigenschaft „ QWidget::foregroundRole “ festgelegte Farbe (in der Regel Schwarz).

Beispiel:

QPushButton { color: red }

Siehe auch „background “ und „selection-color“.

dialogbuttonbox-buttons-have-icons

Gibt an, ob die Schaltflächen in einer „ QDialogButtonBox “ Symbole anzeigen

Ist diese Eigenschaft auf 1 gesetzt, werden die Schaltflächen eines „ QDialogButtonBox “ mit Symbolen angezeigt; ist sie auf 0 gesetzt, werden die Symbole nicht angezeigt.

Informationen zum Festlegen von Symbolen finden Sie im Abschnitt „Liste der Symbole “.

QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }

Schriftart

Kurzschreibweise zum Festlegen 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 Eigenschaft „ QWidget::font “ berücksichtigen.

Wenn diese Eigenschaft nicht festgelegt ist, gilt als Standardwert der „ QWidget::font “.

Beispiel:

QCheckBox { font: bold italic large "Times New Roman" }

font-family

Die Schriftfamilie.

Beispiel:

QCheckBox { font-family: "New Century Schoolbook" }

Schriftgröße

Die Schriftgröße. In dieser Version von Qt werden nur die Maßeinheiten pt und px unterstützt.

Beispiel:

QTextEdit { font-size: 12px }

Schriftstil

Der Schriftstil.

Beispiel:

QTextEdit { font-style: italic }

font-weight

Die Stärke der Schriftart.

gridline-color*

Die Farbe der Gitterlinie in einem „ QTableView “.

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den Stilhinweis „ SH_Table_GridLineColor “ festgelegt ist.

Beispiel:

* { gridline-color: gray }

height

Die Höhe eines Untersteuerelements (oder in manchen Fällen eines Widgets).

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig ein Wert verwendet, der vom Unterelement bzw. Widget und vom aktuellen Stil abhängt.

Beispiel:

QSpinBox::down-button { height: 10px }

Siehe auch „width“.

Symbol

Das Symbol, das für Widgets mit einem Symbol verwendet wird.

Das einzige Widget, das diese Eigenschaft derzeit unterstützt, ist „ QPushButton “.

Verfügbar seit Version 5.15.

icon-size

Die Breite und Höhe des Symbols in einem Widget.

Die Symbolgröße der folgenden Widgets kann mithilfe dieser Eigenschaft festgelegt werden.

• QCheckBox
• QListView
• QPushButton
• QRadioButton
• QTabBar
• QToolBar
• QToolBox
• QTreeView

image*

Das Bild, das im Inhaltsrechteck eines Untersteuerelements gezeichnet wird.

Die Eigenschaft „image“ akzeptiert eine Liste von URLsoder ein „ svg “. Das tatsächlich gezeichnete Bild wird nach demselben Algorithmus wie bei „ QIcon “ ermittelt (d. h., das Bild wird niemals vergrößert, sondern bei Bedarf immer verkleinert). Wird ein „ svg “ angegeben, wird das Bild auf die Größe des Inhaltsrechtecks skaliert. Die Größe eines „ svg “ kann über die Eigenschaften „width“ und „height“ festgelegt werden (unterstützt seit Qt 6.13).

Das Festlegen der Eigenschaft „image“ bei Unterelementen legt implizit die Breite und Höhe des Unterelements fest (es sei denn, es handelt sich um ein SVG-Bild).

Verwenden Sie „image-position“, um das Bild innerhalb des Rechtecks auszurichten.

Diese Eigenschaft gilt nur für Untersteuerelemente – für andere Elemente wird sie nicht unterstützt.

Beispiel:

// implicitly sets the size of down-button to the
// size of spindown.png
QSpinBox::down-button { image: url(:/images/spindown.png) }

image-position

Die Ausrichtung der Bildposition kann mithilfe einer relativen oder absoluten Position festgelegt werden.

links

Wenn die Position auf „ relative “ gesetzt ist (Standardeinstellung), wird ein Unterelement um einen bestimmten Versatz nach rechts verschoben.

Wenn die Position auf „ absolute “ gesetzt ist (Standardeinstellung), gibt die Eigenschaft „ left “ die linke Kante des Untersteuerelements relativ zur linken Kante des übergeordneten Elements an (siehe auch „subcontrol-origin“).

Wenn diese Eigenschaft nicht angegeben ist, lautet der Standardwert „ 0 “.

Beispiel:

QSpinBox::down-button { left: 2px }

Siehe auch „right“, „top“ und „bottom“.

Zeichenabstand

Abstand zwischen den Zeichen in einer Zeichenfolge innerhalb eines Widgets.

lineedit-password-character*

Das Passwortzeichen „ QLineEdit “ als Unicode-Zahl.

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den Stilhinweis „ SH_LineEdit_PasswordCharacter “ festgelegt ist.

Beispiel:

* { lineedit-password-character: 9679 }

lineedit-password-mask-delay*

Die Verzögerung der Passwortmaske „ QLineEdit “ in Millisekunden, bevor „lineedit-password-character“ auf das sichtbare Zeichen angewendet wird.

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den Stilhinweis „ SH_LineEdit_PasswordMaskDelay “ festgelegt ist.

Verfügbar seit Qt 5.4.

Beispiel:

* { lineedit-password-mask-delay: 1000 }

Rand

Die Ränder des Widgets. Entspricht der Angabe von „ margin-top “, „ margin-right “, „ margin-bottom “ und „ margin-left “.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “ und „ QToolTip “ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, lautet der Standardwert „ 0 “.

Beispiel:

QLineEdit { margin: 2px }

Siehe auch „padding“, „spacing“ und „Das Box-Modell“.

margin-top

Der obere Rand des Widgets.

margin-right

Der rechte Rand des Widgets.

margin-bottom

Der untere Rand des Widgets.

margin-left

Der linke Rand des Widgets.

max-height

Die maximale Höhe des Widgets oder eines Unterelements.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, „ QAbstractSpinBox “, „ 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 Inhaltsrechteck im Box-Modell.

Beispiel:

QSpinBox { max-height: 24px }

Siehe auch „max-width“.

max-width

Die maximale Breite des Widgets oder eines Unterelements.

Diese Eigenschaft wird von den Unterklassen „ QAbstractItemView “, „ QAbstractSpinBox “, „ 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 Inhaltsrechteck im Box-Modell.

Beispiel:

QComboBox { max-width: 72px }

Siehe auch „max-height“.

messagebox-text-interaction-flags*

Das Interaktionsverhalten für Text in einem Meldungsfeld. Mögliche 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 Stilhinweis „ SH_MessageBox_TextInteractionFlags “ festgelegt ist.

Beispiel:

QMessageBox { messagebox-text-interaction-flags: 5 }

min-height

Die Mindesthöhe des Widgets oder eines Unterelements.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, „ 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 anhand des Inhalts und des Stils des Widgets ermittelt.

Der Wert bezieht sich relativ auf das Inhaltsrechteck im Box-Modell.

Beispiel:

QComboBox { min-height: 24px }

Siehe auch „min-width“.

min-width

Die Mindestbreite des Widgets oder eines Unterelements.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, „ 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 Mindestbreite anhand des Inhalts des Widgets und des Stils abgeleitet.

Der Wert bezieht sich relativ auf das Inhaltsrechteck im Box-Modell.

Beispiel:

QComboBox { min-width: 72px }

Siehe auch „min-height“.

opacity*

Die Deckkraft eines Widgets. Mögliche Werte reichen von 0 (transparent) bis 255 (undurchsichtig). Derzeit 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 Stilhinweis „ SH_ToolTipLabel_Opacity “ festgelegt ist.

Beispiel:

QToolTip { opacity: 223 }

outline

Der Umriss, der um den Rand des Objekts gezeichnet wird.

Konturfarbe

Die Farbe des Umrisses. Siehe auch border-color

outline-offset

Der Abstand der Kontur vom Rand des Widgets.

Umrissstil

Legt das Muster fest, das zum Zeichnen der Kontur verwendet wird. Siehe auch border-style

outline-radius

Fügt der Kontur abgerundete Ecken hinzu.

outline-bottom-left-radius

Der Radius für die abgerundete linke untere Ecke des Umrisses.

outline-bottom-right-radius

Der Radius für die abgerundete Ecke unten rechts des Umrisses.

outline-top-left-radius

Der Radius für die obere linke Ecke des Umrisses.

outline-top-right-radius

Der Radius für die abgerundete Ecke oben rechts des Umrisses.

Abstand

Der Abstand des Widgets. Entspricht der Angabe von „ padding-top “, „ padding-right “, „ padding-bottom “ und „ padding-left “.

Diese Eigenschaft wird von den Unterklassen von „ QAbstractItemView “, den Unterklassen von „ QAbstractSpinBox “, sowie von „ QCheckBox “, „ QComboBox “, „ QFrame “, „ QGroupBox “, „ QLabel “, „ QLineEdit “, „ QMenu “, „ QMenuBar “, „ QPushButton “, „ QRadioButton “, „ QSplitter “, „ QTextEdit “ und „ QToolTip “ unterstützt.

Wenn diese Eigenschaft nicht angegeben wird, lautet der Standardwert „ 0 “.

Beispiel:

QLineEdit { padding: 3px }

Siehe auch „margin“, „spacing“ und „Das Box-Modell“.

padding-top

Der obere Abstand des Widgets.

padding-right

Der Abstand des Widgets nach rechts.

padding-bottom

Der Abstand des Widgets nach unten.

padding-left

Der linke Abstand des Widgets.

paint-alternating-row-colors-for-empty-area

Gibt an, ob der „ QTreeView “ im leeren Bereich (d. h. dem Bereich, in dem sich keine Elemente befinden) abwechselnde Zeilenfarben anwendet

placeholder-text-color*

Die Farbe, die für den Platzhaltertext von Textbearbeitungs-Widgets verwendet wird.

Wenn diese Eigenschaft nicht festgelegt ist, gilt als Standardwert die Einstellung, die für die Rolle „ PlaceholderText “ der Palette festgelegt wurde.

Beispiel:

QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */

Verfügbar seit Version 6.5.

Position

Ob die mit „left“, „right“, „top“ und „bottom“ angegebenen Versätze relative oder absolute Koordinaten sind.

Wenn diese Eigenschaft nicht angegeben wird, lautet der Standardwert „ relative “.

right

Wenn die Position auf „ relative “ gesetzt ist (Standard), wird ein Unterelement um einen bestimmten Versatz nach links verschoben; die Angabe right: x entspricht dann der Angabe von left: -x.

Wenn „position“ auf „ absolute “ gesetzt ist, legt die Eigenschaft „ right “ die rechte Kante des Unterelements relativ zur rechten Kante des übergeordneten Elements fest (siehe auch „subcontrol-origin“).

Beispiel:

QSpinBox::down-button { right: 2px }

Siehe auch „left“, „top“ und „bottom“.

selection-background-color*

Der Hintergrund von ausgewähltem Text oder ausgewählten Elementen.

Diese Eigenschaft wird von allen Widgets unterstützt, die das „ QWidget::palette “ einhalten und einen Auswahltext anzeigen.

Wenn diese Eigenschaft nicht festgelegt ist, gilt als Standardwert die Einstellung, die für die Rolle „ Highlight “ der Palette festgelegt wurde.

Beispiel:

QTextEdit { selection-background-color: darkblue }

Siehe auch „selection-color “ und „background“.

selection-color*

Die Vordergrundfarbe des ausgewählten Textes oder der ausgewählten Elemente.

Diese Eigenschaft wird von allen Widgets unterstützt, die die Eigenschaft „ QWidget::palette “ berücksichtigen und einen Auswahltext anzeigen.

Ist diese Eigenschaft nicht festgelegt, gilt als Standardwert die Einstellung, die für die Rolle „ HighlightedText “ der Palette festgelegt wurde.

Beispiel:

QTextEdit { selection-color: white }

Siehe auch „selection-background-color “ und „color“.

show-decoration-selected*

Legt fest, ob die Auswahl in einem „ QListView “ die gesamte Zeile oder nur den Textbereich umfasst.

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der durch den aktuellen Stil für den Stilhinweis „ SH_ItemView_ShowDecorationSelected “ festgelegt ist.

Beispiel:

* { show-decoration-selected: 1 }

spacing*

Interner Abstand innerhalb des Widgets.

Diese Eigenschaft wird von QCheckBox, QGroupBoxes, QMenuBar und QRadioButton unterstützt.

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*

Das Ursprungsrechteck des Unterelements innerhalb des übergeordneten Elements.

Wenn diese Eigenschaft nicht angegeben ist, lautet der Standardwert „ padding “.

Beispiel:

QSpinBox::up-button {
    image: url(:/images/spinup.png);
    subcontrol-origin: content;
    subcontrol-position: right top;
}

Siehe auch „subcontrol-position“.

subcontrol-position*

Die Ausrichtung des Untersteuerelements innerhalb des durch „subcontrol-origin“ festgelegten Ursprungsrechtecks.

Wenn diese Eigenschaft nicht angegeben wird, 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

Gibt an, ob Tooltips auf den Schaltflächen der Fenstertitelleiste angezeigt werden.

widget-animation-duration*

Wie lange eine Animation dauern soll (in Millisekunden). Ein Wert von Null bedeutet, dass die Animationen deaktiviert sind.

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig der Wert verwendet, der im aktuellen Stil für den Stilhinweis „ SH_Widget_Animation_Duration “ festgelegt ist.

Verfügbar seit Qt 5.10.

Beispiel:

* { widget-animation-duration: 100 }

text-align

Die Ausrichtung von Text und Symbol innerhalb des Widget-Inhalts.

Wenn dieser Wert nicht angegeben wird, wird standardmäßig der Wert verwendet, der vom nativen Stil abhängt.

Beispiel:

QPushButton {
    text-align: left;
}

Diese Eigenschaft wird derzeit nur von QPushButton und QProgressBar unterstützt.

text-decoration

Weitere Texteffekte.

Nach oben

Wenn die Position auf „ relative “ gesetzt ist (Standardeinstellung), wird ein Unterelement um einen bestimmten Versatz nach unten verschoben.

Wenn die Position auf „ absolute “ gesetzt ist, gibt die Eigenschaft „ top “ die Oberkante des Untersteuerelements relativ zur Oberkante des übergeordneten Elements an (siehe auch „subcontrol-origin“).

Wenn diese Eigenschaft nicht angegeben ist, lautet der Standardwert „ 0 “.

Beispiel:

QSpinBox::up-button { top: 2px }

Siehe auch „left“, „right“ und „bottom“.

Breite

Die Breite eines Untersteuerelements (oder in manchen Fällen eines Widgets).

Wenn diese Eigenschaft nicht angegeben wird, wird standardmäßig ein Wert verwendet, der vom Untersteuerelement bzw. Widget und vom aktuellen Stil abhängt.

Beispiel:

QSpinBox::up-button { width: 12px }

Siehe auch „height“.

Wortabstand

Abstand zwischen den einzelnen Wörtern in einer Zeichenfolge innerhalb eines Widgets.

-qt-background-role

Die „ background-color “ für das Unterelement oder Widget basierend auf der gewählten Rolle.

-qt-style-features

Die Liste der CSS-Eigenschaften, auf die Sie Qt-spezifische Stile anwenden möchten.

Liste der Symbole

Die in Qt verwendeten Symbole können mithilfe der folgenden Eigenschaften angepasst werden. Alle in diesem Abschnitt aufgeführten Eigenschaften haben den Typ „Icon“.

Beachten Sie, dass die Eigenschaft „dialogbuttonbox-buttons-have-icons“ auf „true“ gesetzt werden muss, damit Symbole in den Schaltflächen einer „ QDialogButtonBox “ angezeigt werden. Um die Größe der Symbole anzupassen, verwenden Sie die Eigenschaft „icon-size“.

Liste der Eigenschaftstypen

Die folgende Tabelle fasst die Syntax und Bedeutung der verschiedenen Eigenschaftstypen zusammen.

QTextEdit { background-position: bottom center }

QDialog { etch-disabled-text: 1 }

/* red red red red */
QLabel { border-color: red }
/* red blue red blue */
QLabel { border-color: red blue }
/* red blue green blue */
QLabel { border-color: red blue green }
/* red blue green yellow */
QLabel { border-color: red blue green yellow }

/* 1px 1px 1px 1px */
QLabel { border-width: 1px }
/* 1px 2px 1px 2px */
QLabel { border-width: 1px 2px }
/* 1px 2px 3px 2px */
QLabel { border-width: 1px 2px 3px }
/* 1px 2px 3px 4px */
QLabel { border-width: 1px 2px 3px 4px }

/* 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%) }

/* 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)
}

* {
    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;
}

QPushButton { color: palette(dark); }

Liste der Pseudo-Zustände

Die folgenden Pseudo-Zustände werden unterstützt:

Liste der Unterelemente

Die folgenden Unterelemente stehen zur Verfügung:

Ein Beispiel für die Anpassung eines Unterelements finden Sie unter „Anpassen des Menüanzeige-Unterelements des QPushButton “.