Référence des feuilles de style Qt
Les feuilles de style Qt prennent en charge diverses propriétés, pseudo-états et sous-contrôles qui permettent de personnaliser l'apparence des widgets.
Liste des widgets stylisables
Le tableau suivant dresse la liste des Qt Widgets pouvant être personnalisés à l'aide de feuilles de style :
| Widget | Comment styliser |
|---|---|
| QAbstractScrollArea | Prend en charge le modèle de boîte. 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. Voir la personnalisation de QAbstractScrollArea pour un exemple. |
| QCheckBox | Prend en charge le modèle de boîte. L'indicateur de contrôle peut être stylisé à l'aide du sous-contrôle ::indicator. Par défaut, l'indicateur est placé dans le coin supérieur gauche du rectangle de contenu du widget. La propriété spacing spécifie l'espacement entre l'indicateur de contrôle et le texte. Voir Personnaliser QCheckBox pour un exemple. |
| QColumnView | La poignée peut être stylisée à l'aide de la propriété image. Les indicateurs de flèche peuvent être stylisés à l'aide des sous-contrôles ::left-arrow et ::right-arrow. |
| QComboBox | Le cadre autour de la boîte combobox peut être stylisé à l'aide du modèle de boîte. Le bouton déroulant peut être stylisé à l'aide du sous-contrôle ::drop-down. Par défaut, le bouton déroulant est placé dans le coin supérieur droit du rectangle de remplissage du widget. La flèche à l'intérieur du bouton déroulant peut être stylisée à l'aide du sous-contrôle ::down-arrow. Par défaut, la flèche est placée au centre du rectangle de contenu du sous-contrôle déroulant. La couleur du texte de l'espace réservé peut être définie à l'aide de la propriété placeholder-text-color. Voir Personnaliser QComboBox pour un exemple. |
| QDateEdit | Voir QSpinBox. |
| QDateTimeEdit | Voir QSpinBox. |
| QDialog | Ne prend en charge que les propriétés background, background-clip et background-origin. Attention : Assurez-vous de définir la macro Q_OBJECT pour votre widget personnalisé. |
| QDialogButtonBox | La disposition des boutons peut être modifiée à l'aide de la propriété button-layout. |
| QDockWidget | Prend en charge le style de la barre de titre et des boutons de la barre de titre lorsqu'ils sont ancrés. La bordure du widget d'ancrage peut être stylisée à l'aide de la propriété border. Le sous-contrôle ::title peut être utilisé pour personnaliser la barre de titre. Les boutons close et float sont positionnés par rapport au sous-contrôle ::title à l'aide des propriétés ::close-button et ::float-button respectivement. Lorsque la barre de titre est verticale, la pseudo classe :vertical est définie. En outre, en fonction de QDockWidget::DockWidgetFeature, les pseudo-états :closable, :floatable et :movable sont définis. Remarque : utilisez QMainWindow::separator pour styliser la poignée de redimensionnement. Attention : La feuille de style n'a aucun effet lorsque le site QDockWidget est désancré, car Qt utilise les fenêtres de premier niveau natives lorsqu'elles sont désancrées. Voir Personnaliser QDockWidget pour un exemple. |
| QDoubleSpinBox | Voir QSpinBox. |
| QFrame | Prend en charge le modèle de boîte. Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel. Voir la personnalisation de QFrame pour un exemple. |
| QGroupBox | Prend en charge le modèle de boîte. Le titre peut être stylisé à l'aide du sous-contrôle ::title. Par défaut, le titre est placé en fonction de QGroupBox::textAlignment. 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. Voir la personnalisation de QGroupBox pour un exemple. |
| QHeaderView | Prend en charge le modèle de boîte. Les sections de l'en-tête sont stylisées à l'aide du sous-contrôle ::section. Le sous-contrôle section prend en charge les pseudo-états :middle, :first, :last, :only-one, :next-selected, :previous-selected, :selected et :checked. L'indicateur de tri peut être stylisé à l'aide des sous-contrôles ::up-arrow et ::down-arrow. Voir Personnaliser QHeaderView pour un exemple. |
| QLabel | Prend en charge le modèle de boîte. Ne prend pas en charge le pseudo-état :hover. Since 4.3, setting a stylesheet on a QLabel automatically sets the QFrame::frameStyle property to QFrame::StyledPanel. Voir la personnalisation de QFrame pour un exemple (un QLabel dérive de QFrame). |
| QLineEdit | Prend en charge le modèle de boîte. La couleur et l'arrière-plan de l'élément sélectionné sont stylisés à l'aide des propriétés selection-color et selection-background-color respectivement. La couleur du texte de l'espace réservé peut être définie à l'aide de la propriété placeholder-text-color. Le caractère du mot de passe peut être stylisé à l'aide de la propriété lineedit-password-character. Le délai de masquage du mot de passe peut être modifié à l'aide de la propriété lineedit-password-mask-delay. Voir la personnalisation de QLineEdit pour un exemple. |
| QListView | Prend en charge le modèle de boîte. When alternating row colors is enabled, the alternating colors can be styled using the alternate-background-color property. La couleur et l'arrière-plan de l'élément sélectionné sont stylisés à l'aide des propriétés selection-color et selection-background-color respectivement. Le comportement de la sélection est contrôlé par la propriété show-decoration-selected. Utilisez le sous-contrôle ::item pour un contrôle plus fin des éléments du site QListView. Voir QAbstractScrollArea pour styliser les arrière-plans déroulants. Voir Customzing QListView pour un exemple. |
| QListWidget | Voir QListView. |
| QMainWindow | Prend en charge le style du séparateur. The separator in a QMainWindow when using QDockWidget is styled using the ::separator subcontrol. Voir la personnalisation de QMainWindow pour un exemple. |
| QMenu | Prend en charge le modèle de boîte. Les éléments individuels sont stylisés à l'aide du sous-contrôle ::item. Outre les pseudo-états habituellement pris en charge, le sous-contrôle item prend en charge les pseudo-états :selected, :default, :exclusive et non-exclusive. L'indicateur des éléments de menu à cocher est stylisé à l'aide du sous-contrôle ::indicator. Le séparateur est stylisé à l'aide du sous-contrôle ::separator. Pour les éléments comportant un sous-menu, les flèches sont stylisées à l'aide de la flèche droite et de la flèche gauche. Le défilement est stylisé à l'aide du sous-contrôle ::scroller. Le style de la ligne de séparation est défini à l'aide de ::tearoff. Voir la personnalisation de QMenu pour un exemple. |
| QMenuBar | Prend en charge le modèle de boîte. La propriété spacing spécifie l'espacement entre les éléments du menu. Les éléments individuels sont stylisés à l'aide du sous-contrôle ::item. Attention : Sous Qt/Mac, la barre de menu est généralement intégrée à la barre de menu générale du système. Dans ce cas, la feuille de style n'aura aucun effet. Voir Personnaliser QMenuBar pour un exemple. |
| QMessageBox | La propriété messagebox-text-interaction-flags peut être utilisée pour modifier l'interaction avec le texte dans la boîte de message. |
| QProgressBar | Prend en charge le modèle de boîte. Les morceaux de la barre de progression peuvent être stylisés à l'aide du sous-contrôle ::chunk. Le morceau est affiché dans le rectangle de contenu du widget. Si la barre de progression affiche du texte, utilisez la propriété text-align pour positionner le texte. Les barres de progression indéterminées ont le pseudo-état :indeterminate défini. Voir la personnalisation de QProgressBar pour un exemple. |
| QPushButton | Prend en charge le modèle de boîte. Prend en charge les pseudo-états :default, :flat, :checked. Depuis la version 5.15, la propriété icon peut être définie pour remplacer l'icône du bouton. 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. Attention : Si vous ne définissez qu'une couleur d'arrière-plan sur un site QPushButton, l'arrière-plan risque de ne pas apparaître si vous ne donnez pas une certaine valeur à la propriété "border". En effet, par défaut, le site QPushButton dessine une bordure native qui recouvre complètement la couleur d'arrière-plan. Par exemple, QPushButton { background-color: red; border: none; } Voir le Customizing de QPushButton pour un exemple. |
| QRadioButton | Prend en charge le modèle de boîte. L'indicateur de contrôle peut être stylisé à l'aide du sous-contrôle ::indicator. Par défaut, l'indicateur est placé dans le coin supérieur gauche du rectangle de contenu du widget. La propriété spacing spécifie l'espacement entre l'indicateur de contrôle et le texte. Voir l'exemple de personnalisation de QRadioButton. |
| QScrollBar | Prend en charge le modèle de boîte. 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. Le curseur peut être stylisé à l'aide du sous-contrôle ::handle. La définition des valeurs min-width et min-height permet d'imposer des contraintes de taille au curseur en fonction de l'orientation. Le sous-contrôle ::add-line peut être utilisé pour styliser le bouton afin d'ajouter une ligne. Par défaut, le sous-contrôle add-line est placé dans le coin supérieur droit du rectangle Border du widget. En fonction de l'orientation, les flèches ::right-arrow ou ::down-arrow. Par défaut, les flèches sont placées au centre du rectangle Contents du sous-contrôle add-line. Le sous-contrôle ::sub-line peut être utilisé pour styliser le bouton afin de soustraire une ligne. Par défaut, le sous-contrôle de sous-ligne est placé dans le coin inférieur droit du rectangle Border du widget. Selon l'orientation, les flèches ::left-arrow ou ::up-arrow. Par défaut, les flèches sont placées au centre du rectangle Contents du sous-contrôle de ligne. Le sous-contrôle ::sub-page peut être utilisé pour styliser la région du curseur qui soustrait une page. Le sous-contrôle ::add-page peut être utilisé pour styliser la région du curseur qui ajoute une page. Voir l'exemple de personnalisation de QScrollBar. |
| QSizeGrip | Prend en charge les propriétés width, height et image. Voir la personnalisation de QSizeGrip pour un exemple. |
| QSlider | Prend en charge le modèle de boîte. Pour les diapositives horizontales, les propriétés min-width et height doivent être fournies. Pour les curseurs verticaux, les propriétés min-height et width doivent être fournies. La rainure du curseur est stylisée à l'aide de la propriété ::groove. La rainure est positionnée par défaut dans le rectangle de contenu du widget. Le pouce du curseur est stylisé à l'aide du sous-contrôle ::handle. Le sous-contrôle se déplace dans le rectangle de contenu du sous-contrôle groove. Voir la personnalisation de QSlider pour un exemple. |
| QSpinBox | Le cadre de la boîte de rotation peut être stylisé à l'aide du modèle de boîte. Le bouton et la flèche vers le haut peuvent être stylisés à l'aide des sous-contrôles ::up-button et ::up-arrow. Par défaut, le bouton haut est placé dans le coin supérieur droit du rectangle de remplissage du widget. Sans taille explicite, il occupe la moitié de la hauteur de son rectangle de référence. La flèche vers le haut est placée au centre du rectangle de contenu du bouton vers le haut. Le bouton et la flèche vers le bas peuvent être stylisés à l'aide des sous-contrôles ::down-button et ::down-arrow. Par défaut, le bouton vers le bas est placé dans le coin inférieur droit du rectangle Padding du widget. Sans taille explicite, il occupe la moitié de la hauteur de son rectangle de référence. La flèche du bas est placée au centre du rectangle de contenu du bouton du bas. Voir la personnalisation de QSpinBox pour un exemple. |
| QSplitter | Prend en charge le modèle de boîte. La poignée du séparateur est stylisée à l'aide du sous-contrôle ::handle. Voir la personnalisation de QSplitter pour un exemple. |
| QStatusBar | Ne prend en charge que la propriété d'arrière-plan. Le cadre des éléments individuels peut être stylisé à l'aide du sous-contrôle ::item. Voir la personnalisation de QStatusBar pour un exemple. |
| QTabBar | Les onglets individuels peuvent être stylisés à l'aide du sous-contrôle ::tab. Les boutons peuvent être fermés à l'aide du sous-contrôle ::close-button. Les onglets prennent en charge les pseudo-états :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected. Les pseudo-états :top, :left, :right, :bottom dépendent de l'orientation des onglets. 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. Attention : Pour modifier la position du site QTabBar à l'intérieur d'un site QTabWidget, utilisez le sous-contrôle de la barre de tabulation (et définissez le sous-contrôle-position). Voir Personnaliser QTabBar pour un exemple. |
| QTabWidget | Le cadre du widget tab est stylisé à l'aide du sous-contrôle ::pane. Les coins gauche et droit sont stylisés à l'aide des sous-contrôles ::left-corner et ::right-corner respectivement. La position de la barre d'onglets est contrôlée à l'aide du sous-contrôle ::tab-bar. 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. Les pseudo-états :top, :left, :right, :bottom dépendent de l'orientation des onglets. Voir Personnaliser QTabWidget pour un exemple. |
| QTableView | Prend en charge le modèle de boîte. Lorsque alternating row colors est activé, les couleurs alternées peuvent être stylisées à l'aide de la propriété alternate-background-color. La couleur et l'arrière-plan de l'élément sélectionné sont stylisés à l'aide des propriétés selection-color et selection-background-color respectivement. The corner widget in a QTableView is implemented as a QAbstractButton and can be styled using the "QTableView QTableCornerButton::section" selector. Attention : Si vous définissez uniquement une couleur d'arrière-plan sur un QTableCornerButton, l'arrière-plan risque de ne pas apparaître si vous ne donnez pas une certaine valeur à la propriété border. En effet, par défaut, le QTableCornerButton dessine une bordure native qui recouvre complètement la couleur d'arrière-plan.
|
| QTableWidget | Voir QTableView. |
| QTextEdit | Prend en charge le modèle de boîte. La couleur et l'arrière-plan du texte sélectionné sont stylisés à l'aide des propriétés selection-color et selection-background-color respectivement. La couleur du texte de l'espace réservé peut être définie à l'aide de la propriété placeholder-text-color. Voir QAbstractScrollArea pour styliser les arrière-plans déroulants. |
| QTimeEdit | Voir QSpinBox. |
| QToolBar | Prend en charge le modèle de boîte. Les pseudo-états :top, :left, :right, :bottom dépendent de la zone dans laquelle la barre d'outils est groupée. Les pseudo-états :first, :last, :middle, :only-one indiquent la position de la barre d'outils dans un groupe de lignes (voir QStyleOptionToolBar::positionWithinLine). The separator of a QToolBar is styled using the ::separator subcontrol. La poignée (pour déplacer la barre d'outils) est stylisée à l'aide du sous-contrôle ::handle. Voir la personnalisation de QToolBar pour un exemple. |
| QToolBox | Prend en charge le modèle de boîte. Les onglets individuels peuvent être stylisés à l'aide du sous-contrôle ::tab. Les onglets prennent en charge les pseudo-états :only-one, :first, :last, :middle, :previous-selected, :next-selected, :selected. |
| QToolButton | Prend en charge le modèle de boîte. 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. Attention : Si vous ne définissez qu'une couleur d'arrière-plan sur une page QToolButton, l'arrière-plan n'apparaîtra pas à moins que vous ne donniez une certaine valeur à la propriété "border". En effet, par défaut, le site QToolButton dessine une bordure native qui recouvre complètement la couleur d'arrière-plan. Par exemple, QToolButton { background-color: red; border: none; } Voir la section Personnalisation de QToolButton pour un exemple. |
| QToolTip | Prend en charge le modèle de boîte. La propriété opacity contrôle l'opacité de l'info-bulle. Voir la personnalisation de QFrame pour un exemple (un QToolTip est un QFrame). |
| QTreeView | Prend en charge le modèle de boîte. Lorsque alternating row colors est activé, les couleurs alternées peuvent être stylisées à l'aide de la propriété alternate-background-color. La couleur et l'arrière-plan de l'élément sélectionné sont stylisés à l'aide des propriétés selection-color et selection-background-color respectivement. Le comportement de la sélection est contrôlé par la propriété show-decoration-selected. Les branches de l'arborescence peuvent être stylisées à l'aide du sous-contrôle ::branch. Le sous-contrôle ::branch prend en charge les pseudo-états :open, :closed, :has-sibling et :has-children. Utilisez le sous-contrôle ::item pour un contrôle plus fin des éléments de la page QTreeView. Voir QAbstractScrollArea pour styliser les arrière-plans déroulants. Voir Personnaliser QTreeView pour un exemple de style des branches. |
| QTreeWidget | Voir QTreeView. |
| QWidget | Ne prend en charge que les propriétés background, background-clip et 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) ; } Le code ci-dessus ne fonctionne pas si aucune feuille de style n'est définie. Attention : Assurez-vous de définir la macro Q_OBJECT pour votre widget personnalisé. |
Liste des propriétés
Cette section énumère toutes les propriétés prises en charge par les feuilles de style Qt. Les valeurs pouvant être attribuées à une propriété dépendent de son type. Sauf indication contraire, les propriétés suivantes s'appliquent à tous les widgets. Les propriétés marquées d'un astérisque * sont spécifiques à Qt et n'ont pas d'équivalent en CSS2 ou CSS3. Les propriétés spécifiques à Qt sont les suivantes :
- couleur du quadrillage*
- image*
- lineedit-mot-de-passe-caractère*
- lineedit-password-mask-delay* (délai de masquage du mot de passe)
- messagebox-text-interaction-flags*
- opacité*
- placeholder-text-color* (couleur du texte de l'espace réservé)
- sélection-couleur d'arrière-plan*
- sélection-couleur*
- show-decoration-selected*
- espacement*
- subcontrol-origin* (origine du sous-contrôle)
- subcontrol-position*
- widget-animation-duration*
accent-color
| Type | Pinceau |
Cette propriété définit la couleur Accent, qui est utilisée pour mettre en valeur les éléments interactifs de l'interface utilisateur. Si cette propriété n'est pas définie, elle prend par défaut la couleur highlight.
couleur d'arrière-plan alternatif
| Type | Pinceau |
Le site alternate background color utilisé dans les sous-classes de QAbstractItemView.
Si cette propriété n'est pas définie, la valeur par défaut est celle définie pour le rôle AlternateBase de la palette.
Exemple :
QTreeView { alternate-background-color: blue; background: yellow; }
Voir aussi background et selection-background-color.
arrière-plan
| Type | Arrière-plan |
Notation abrégée pour définir l'arrière-plan. Équivalent à background-color, background-image, background-repeat, et/ou background-position.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, et les QWidgetordinaires.
Exemple :
QTextEdit { background: yellow }Il est souvent nécessaire de définir un motif de remplissage similaire aux styles de Qt::BrushStyle. Vous pouvez utiliser la propriété background-color pour Qt::SolidPattern, Qt::RadialGradientPattern, Qt::LinearGradientPattern et Qt::ConicalGradientPattern. Les autres motifs sont facilement réalisables en créant une image d'arrière-plan qui contient le motif.
Exemple :
QLabel { background-image: url(dense6pattern.png); background-repeat: repeat-xy; }
Voir aussi background-origin, selection-background-color, background-clip, background-attachment et alternate-background-color.
couleur d'arrière-plan
| Type | Pinceau |
La couleur d'arrière-plan utilisée pour le widget.
Exemples :
background-image
| Type | Url |
L'image de fond utilisée pour le widget. Les parties semi-transparentes de l'image laissent transparaître le site background-color.
Exemple :
QFrame { background-image: url(:/images/hydro.png) }
arrière-plan-répétition
| Type | Répétition |
Indique si et comment l'image d'arrière-plan est répétée pour remplir le rectangle background-origin.
Si cette propriété n'est pas spécifiée, l'image d'arrière-plan est répétée dans les deux sens (repeat).
Exemple :
QFrame { background: white url(:/images/ring.png); background-repeat: repeat-y; background-position: left; }
background-position
| Type d'alignement | Alignement |
L'alignement de l'image d'arrière-plan dans le rectangle background-origin.
Si cette propriété n'est pas spécifiée, l'alignement est top left .
Exemple :
QFrame { background: url(:/images/footer.png); background-position: bottom left; }
background-attachment
| Type de pièce jointe | Pièce jointe |
Détermine si l'image d'arrière-plan d'une page QAbstractScrollArea défile ou est fixe par rapport à la fenêtre. Par défaut, l'image d'arrière-plan défile avec la fenêtre.
Exemple :
QTextEdit { background-image: url("leaves.png"); background-attachment: fixed; }
Voir aussi arrière-plan
arrière-plan-clip
| Type d'origine | Origine |
Le rectangle du widget dans lequel background est dessiné.
Cette propriété spécifie le rectangle dans lequel les background-color et background-image sont découpés.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, et les QWidgetordinaires.
Si cette propriété n'est pas spécifiée, la valeur par défaut est border.
Exemple :
QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; background-clip: padding; }
Voir aussi background, background-origin et The Box Model.
arrière-plan-origine
| Type d'origine | Origine |
Le rectangle d'arrière-plan du widget, à utiliser en conjonction avec background-position et background-image.
Cette propriété est prise en charge par les sous-classes de QAbstractItemView, les sous-classes de QAbstractSpinBox, QCheckBox, QComboBox, QDialog, QFrame, QGroupBox, QLabel, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, et les QWidgetordinaires.
Si cette propriété n'est pas spécifiée, la valeur par défaut est padding.
Exemple :
QFrame { background-image: url(:/images/header.png); background-position: top left; background-origin: content; }
Voir aussi arrière-plan et modèle de la boîte.
bordure
| Type de | Bordure |
Notation abrégée pour définir la bordure du widget. Équivalent à border-color, border-style, et/ou border-width.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, et les QWidgetordinaires.
Exemple :
QLineEdit { border: 1px solid white }
border-top
| Type de bordure | Bordure |
Notation abrégée pour définir la bordure supérieure du widget. Équivalent à border-top-color, border-top-style, et/ou border-top-width.
bordure-droite
| Type | Bordure |
Notation abrégée pour définir la bordure droite du widget. Équivalent à border-right-color, border-right-style, et/ou border-right-width.
border-bottom
| Type | Bordure |
Notation abrégée pour définir la bordure inférieure du widget. Équivalent à border-bottom-color, border-bottom-style, et/ou border-bottom-width.
bordure-gauche
| Type | Bordure |
Notation abrégée pour définir la bordure gauche du widget. Équivalent à border-left-color, border-left-style, et/ou border-left-width.
couleur de la bordure
La couleur de tous les bords de la bordure. Équivalent à border-top-color, border-right-color, border-bottom-color, et border-left-color.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, QToolTip, et les QWidgetordinaires.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur color (c'est-à-dire la couleur d'avant-plan du widget).
Exemple :
QLineEdit { border-width: 1px; border-style: solid; border-color: white; }
Voir également border-style, border-width, border-image et The Box Model.
couleur de la bordure supérieure
| Type | Pinceau |
La couleur du bord supérieur de la bordure.
couleur de la bordure droite
| Type | Pinceau |
La couleur du bord droit de la bordure.
couleur du bord inférieur
| Type | Pinceau |
La couleur du bord inférieur de la bordure.
couleur du bord gauche
| Type | Pinceau |
La couleur du bord gauche de la bordure.
image de la bordure
| Type d'image | Image de la bordure |
L'image utilisée pour remplir la bordure. L'image est découpée en neuf parties et étirée de manière appropriée si nécessaire. Voir Image de la bordure pour plus de détails.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit et QToolTip.
Voir aussi couleur de la bordure, style de la bordure, largeur de la bordure et modèle de la boîte.
rayon de la bordure
| Type | Rayon |
Le rayon des coins de la bordure. Équivalent à border-top-left-radius, border-top-right-radius, border-bottom-right-radius, et border-bottom-left-radius.
Le rayon de la bordure découpe l'arrière-plan de l'élément.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, et QToolTip.
Si cette propriété n'est pas spécifiée, la valeur par défaut est 0.
Exemple :
QLineEdit { border-width: 1px; border-style: solid; border-radius: 4px; }
Voir également border-width et The Box Model.
rayon de la bordure en haut à gauche
| Type | Rayon |
Rayon du coin supérieur gauche de la bordure.
rayon du coin supérieur droit de la bordure
| Type | Rayon |
Rayon du coin supérieur droit de la bordure.
border-bottom-right-radius
| Type | Rayon |
Rayon du coin inférieur droit de la bordure. La définition d'une valeur positive pour cette propriété permet d'obtenir un coin arrondi.
border-bottom-left-radius
| Type | Rayon |
Rayon du coin inférieur gauche de la bordure. La définition d'une valeur positive pour cette propriété permet d'obtenir un coin arrondi.
style de la bordure
| Type | Style de bordure |
Le style de tous les bords de la bordure.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, et QToolTip.
Si cette propriété n'est pas spécifiée, la valeur par défaut est none.
Exemple :
QLineEdit { border-width: 1px; border-style: solid; border-color: blue; }
Voir aussi border-color, border-style, border-image et The Box Model.
style de la bordure supérieure
Style du bord supérieur de la bordure.
style de la bordure droite
Style du bord droit de la bordure.
style du bord inférieur
Style du bord inférieur de la bordure.
style-bordure-gauche
Style du bord gauche de la bordure.
largeur de la bordure
Largeur de la bordure. Équivalent aux paramètres border-top-width, border-right-width, border-bottom-width, et border-left-width.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, et QToolTip.
Exemple :
QLineEdit { border-width: 2px; border-style: solid; border-color: darkblue; }
Voir également border-color, border-radius, border-style, border-image et The Box Model.
largeur de la bordure supérieure
| Type | Longueur |
Largeur du bord supérieur de la bordure.
largeur de la bordure droite
| Type de bordure | Longueur |
Largeur du bord droit de la bordure.
largeur du bord inférieur
| Type | Longueur |
Largeur du bord inférieur de la bordure.
largeur de la bordure gauche
| Type de bordure | Longueur |
Largeur du bord gauche de la bordure.
bas
| Type | Longueur |
Si la position est relative (par défaut), elle déplace un sous-contrôle d'un certain décalage vers le haut. bottom: y équivaut alors à spécifier top: -y.
Si la position est absolute, la propriété bottom spécifie le bord inférieur du sous-contrôle par rapport au bord inférieur du parent (voir également subcontrol-origin).
Exemple :
QSpinBox::down-button { bottom: 2px }
Voir également left, right et top.
présentation des boutons
| Type de bouton | Nombre |
La disposition des boutons dans un site QDialogButtonBox ou QMessageBox. Les valeurs possibles sont 0 (WinLayout), 1 (MacLayout), 2 (KdeLayout), 3 (GnomeLayout) et 5 (AndroidLayout).
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_DialogButtonLayout.
Exemple :
* { button-layout: 2 }
couleur
| Type | Pinceau |
La couleur utilisée pour rendre le texte.
Cette propriété est prise en charge par tous les widgets qui respectent la norme QWidget::palette.
Si cette propriété n'est pas définie, la valeur par défaut est celle définie dans la palette du widget pour QWidget::foregroundRole (généralement le noir).
Exemple :
QPushButton { color: red }Voir également background et selection-color.
dialogbuttonbox-buttons-have-icons
| Type | Booléen |
Indique si les boutons d'une boîte de dialogue QDialogButtonBox affichent des icônes.
Si cette propriété vaut 1, les boutons d'un site QDialogButtonBox affichent des icônes ; si elle vaut 0, les icônes ne sont pas affichées.
Voir la section Liste des icônes pour plus d'informations sur la définition des icônes.
QDialogButtonBox { dialogbuttonbox-buttons-have-icons: 1; }
Remarque : les styles définissant cette propriété doivent être appliqués avant la création de QDialogButtonBox; cela signifie que vous devez appliquer le style au widget parent ou à l'application elle-même.
police
| Type | Police |
Notation abrégée pour définir la police de caractères du texte. Équivalent à font-family, font-size, font-style, et/ou font-weight.
Cette propriété est prise en charge par tous les widgets qui respectent la norme QWidget::font.
Si cette propriété n'est pas définie, la police par défaut est QWidget::font.
Exemple :
QCheckBox { font: bold italic large "Times New Roman" }
font-family
| Type de texte | Chaîne |
La famille de polices.
Exemple :
QCheckBox { font-family: "New Century Schoolbook" }
taille de police
| Type de police | Taille de la police |
La taille de la police. Dans cette version de Qt, seules les mesures pt et px sont prises en charge.
Exemple :
QTextEdit { font-size: 12px }
font-style
| Type de police | Style de police |
Le style de la police.
Exemple :
QTextEdit { font-style: italic }
font-weight
| Type de police | Poids de la police |
Le poids de la police.
couleur du quadrillage*
| Type de | Couleur |
La couleur de la ligne de grille dans un site QTableView.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_Table_GridLineColor.
Exemple :
* { gridline-color: gray }
hauteur
| Type | Longueur |
La hauteur d'un sous-contrôle (ou dans certains cas, d'un widget).
Si cette propriété n'est pas spécifiée, elle prend par défaut une valeur qui dépend du sous-contrôle/du widget et du style actuel.
Attention : Sauf indication contraire, cette propriété n'a aucun effet sur les widgets. Si vous souhaitez que le widget ait une hauteur fixe, donnez la même valeur à la hauteur minimale et à la hauteur maximale.
Exemple :
QSpinBox::down-button { height: 10px }
Voir aussi largeur.
icône
| Type d'icône | Url+ |
L'icône utilisée, pour les widgets qui ont une icône.
Le seul widget prenant actuellement en charge cette propriété est QPushButton.
Remarque : c'est à l'application qu'il incombe d'attribuer une icône à un bouton (à l'aide de l'API QAbstractButton ), et non au style. Soyez donc prudent si vous ne ciblez pas une application spécifique dans votre feuille de style.
Disponible depuis la version 5.15.
taille de l'icône
| Type d'icône | Longueur |
La largeur et la hauteur de l'icône dans un widget.
La taille de l'icône des widgets suivants peut être définie à l'aide de cette propriété.
image*
| Type d'image | Url+ |
L'image qui est dessinée dans le rectangle de contenu d'un sous-contrôle.
La propriété image accepte une liste d'Urlsou un svg. L'image réelle qui est dessinée est déterminée en utilisant le même algorithme que QIcon (c'est-à-dire que l'image n'est jamais redimensionnée à la hausse mais toujours à la baisse si nécessaire). Si une adresse svg est spécifiée, l'image est adaptée à la taille du rectangle de contenu.
La définition de la propriété image sur les sous-contrôles définit implicitement la largeur et la hauteur du sous-contrôle (sauf si l'image est un SVG).
Dans Qt 4.3 et les versions ultérieures, l'alignement de l'image dans le rectangle peut être spécifié à l'aide de image-position.
Cette propriété est réservée aux sous-contrôles ; elle n'est pas disponible pour les autres éléments.
Attention : Le plugin QIcon SVG est nécessaire pour rendre les images SVG.
Exemple :
// implicitly sets the size of down-button to the // size of spindown.png QSpinBox::down-button { image: url(:/images/spindown.png) }
image-position
| Type d'image | alignement |
Dans Qt 4.3 et les versions ultérieures, l'alignement de la position de l'image peut être spécifié en utilisant la position relative ou absolue.
gauche
| Type d'image | Longueur |
Si la position est relative (par défaut), déplace un sous-contrôle d'un certain décalage vers la droite.
Si la position est absolute, la propriété left spécifie le bord gauche du sous-contrôle par rapport au bord gauche du parent (voir aussi subcontrol-origin).
Si cette propriété n'est pas spécifiée, la valeur par défaut est 0.
Exemple :
QSpinBox::down-button { left: 2px }
Voir également right, top et bottom.
espacement des lettres
| Type de caractères | Longueur |
Espace entre les caractères d'une chaîne de caractères dans un widget.
lineedit-mot-de-passe-caractère*
| Type de caractères | Nombre de caractères |
Le caractère du mot de passe QLineEdit sous forme de nombre Unicode.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_LineEdit_PasswordCharacter.
Exemple :
* { lineedit-password-character: 9679 }
lineedit-password-mask-delay*
| Type de mot de passe | Nombre de mots |
Le délai du masque de mot de passe QLineEdit en millisecondes avant que lineedit-password-character soit appliqué au caractère visible.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_LineEdit_PasswordMaskDelay.
Disponible depuis Qt 5.4.
Exemple :
* { lineedit-password-mask-delay: 1000 }
marge
| Type de boîte | Longueur des boîtes |
Marges du widget. Équivalent à margin-top, margin-right, margin-bottom, et margin-left.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, et QToolTip.
Si cette propriété n'est pas spécifiée, la valeur par défaut est 0.
Exemple :
QLineEdit { margin: 2px }
Voir également padding, spacing et The Box Model.
marge-haut
| Type | Longueur |
Marge supérieure du widget.
marge-droite
| Type de marge | Longueur |
La marge droite du widget.
marge-bas
| Type de marge | Longueur |
Marge inférieure du widget.
marge-gauche
| Type de marge | Longueur |
Marge gauche du widget.
hauteur maximale
| Type de texte | Longueur |
Hauteur maximale du widget ou d'un sous-contrôle.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, et QToolTip.
La valeur est relative au contenu rect dans le modèle de boîte.
Exemple :
QSpinBox { max-height: 24px }
Voir aussi max-width.
largeur maximale
| Type | Longueur |
Largeur maximale du widget ou d'un sous-contrôle.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, et QToolTip.
La valeur est relative au contenu rect dans le modèle de boîte.
Exemple :
QComboBox { max-width: 72px }
Voir aussi max-height.
messagesbox-text-interaction-flags*
| Type | Nombre |
Comportement d'interaction pour le texte dans une boîte de message. Les valeurs possibles sont basées sur Qt::TextInteractionFlags.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_MessageBox_TextInteractionFlags.
Exemple :
QMessageBox { messagebox-text-interaction-flags: 5 }
min-height
| Type d'article | Longueur |
Hauteur minimale du widget ou d'un sous-contrôle.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton, et QToolTip.
Si cette propriété n'est pas spécifiée, la hauteur minimale est déterminée en fonction du contenu du widget et du style.
La valeur est relative au rectangle de contenu dans le modèle de boîte.
Exemple :
QComboBox { min-height: 24px }
Remarque : la définition de cette propriété peut permettre aux widgets de se rétrécir au-delà de l'espace requis pour le contenu.
Voir aussi min-width.
largeur minimale
| Type | Longueur |
Largeur minimale du widget ou d'un sous-contrôle.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSizeGrip, QSpinBox, QSplitter, QStatusBar, QTextEdit, QToolButton, et QToolTip.
Si cette propriété n'est pas spécifiée, la largeur minimale est calculée en fonction du contenu du widget et du style.
La valeur est relative au contenu rect dans le modèle de boîte.
Exemple :
QComboBox { min-width: 72px }
Remarque : la définition de cette propriété peut permettre aux widgets de se rétrécir au-delà de l'espace requis pour le contenu.
Voir également min-height.
opacité*
| Type | Nombre |
L'opacité d'un widget. Les valeurs possibles sont comprises entre 0 (transparent) et 255 (opaque). Pour l'instant, ce paramètre n'est pris en charge que pour tooltips.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_ToolTipLabel_Opacity.
Exemple :
QToolTip { opacity: 223 }
outline
Le contour dessiné autour de la bordure de l'objet.
couleur du contour
| Type | Couleur |
La couleur du contour. Voir aussi couleur de la bordure
décalage du contour
| Type de texte | Longueur |
Décalage du contour par rapport à la bordure du widget.
style de contour
Spécifie le motif utilisé pour dessiner le contour. Voir aussi style de bordure
rayon du contour
Ajoute des coins arrondis au contour.
rayon du contour en bas à gauche
| Type | Rayon |
Rayon du coin arrondi inférieur gauche du contour.
outline-bottom-right-radius
| Type | Rayon |
Rayon du coin arrondi en bas à droite du contour.
rayon de l'angle supérieur gauche du contour
| Type | Rayon |
Rayon du coin supérieur gauche du contour.
rayon du coin supérieur droit du contour
| Type | Rayon |
Rayon du coin arrondi supérieur droit du contour.
padding
Le remplissage du widget. Équivalent à padding-top, padding-right, padding-bottom, et padding-left.
Cette propriété est prise en charge par les sous-classes QAbstractItemView, QAbstractSpinBox, QCheckBox, QComboBox, QFrame, QGroupBox, QLabel, QLineEdit, QMenu, QMenuBar, QPushButton, QRadioButton, QSplitter, QTextEdit, et QToolTip.
Si cette propriété n'est pas spécifiée, la valeur par défaut est 0.
Exemple :
QLineEdit { padding: 3px }
Voir également marge, espacement et modèle de boîte.
padding-top
| Type | Longueur |
L'espacement supérieur du widget.
padding-right
| Type | Longueur |
L'espacement à droite du widget.
padding-bottom
| Type | Longueur |
Rembourrage de la partie inférieure du widget.
padding-left
| Type | Longueur |
L'espacement à gauche du widget.
couleurs des rangs alternatifs pour les zones vides
| Type de couleur | bool |
Indique si QTreeView peint des couleurs de ligne alternées pour la zone vide (c'est-à-dire la zone où il n'y a pas d'éléments).
placeholder-text-color*
| Type | Pinceau |
Couleur utilisée pour le texte de l'espace réservé dans les widgets d'édition de texte.
Si cette propriété n'est pas définie, la valeur par défaut est celle définie pour le rôle PlaceholderText de la palette.
Exemple :
QLineEdit { placeholder-text-color: #800000ff } /* semi-transparent blue */
Disponible depuis la version 6.5.
position
| Type | relative | absolute |
Si les décalages spécifiés à l'aide de la gauche, de la droite, du haut et du bas sont des coordonnées relatives ou absolues.
Si cette propriété n'est pas spécifiée, la valeur par défaut est relative.
droite
| Type de propriété | Longueur |
Si la position est relative (par défaut), déplace un sous-contrôle d'un certain décalage vers la gauche. right: x équivaut alors à spécifier left: -x.
Si la position est absolute, la propriété right spécifie le bord droit du sous-contrôle par rapport au bord droit du parent (voir aussi subcontrol-origin).
Exemple :
QSpinBox::down-button { right: 2px }
Voir également left, top et bottom.
couleur de fond de la sélection*
| Type | Pinceau |
L'arrière-plan du texte ou des éléments sélectionnés.
Cette propriété est prise en charge par tous les widgets qui respectent le site QWidget::palette et qui affichent le texte de sélection.
Si cette propriété n'est pas définie, la valeur par défaut est celle définie pour le rôle Highlight de la palette.
Exemple :
QTextEdit { selection-background-color: darkblue }
Voir aussi couleur de sélection et arrière-plan.
couleur de sélection*
| Type de couleur | Pinceau |
Le premier plan du texte ou des éléments sélectionnés.
Cette propriété est prise en charge par tous les widgets qui respectent QWidget::palette et qui affichent le texte de sélection.
Si cette propriété n'est pas définie, la valeur par défaut est celle définie pour le rôle HighlightedText de la palette.
Exemple :
QTextEdit { selection-color: white }
Voir également selection-background-color et color.
montrer-décoration-sélectionné*
| Type | booléen |
Contrôle si les sélections dans un site QListView couvrent toute la ligne ou seulement l'étendue du texte.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_ItemView_ShowDecorationSelected.
Exemple :
* { show-decoration-selected: 1 }
espacement*
| Type d'espacement | Longueur |
Espacement interne dans le widget.
Cette propriété est prise en charge par QCheckBox, checkable QGroupBoxes, QMenuBar, et QRadioButton.
Si cette propriété n'est pas spécifiée, la valeur par défaut dépend du widget et du style actuel.
Exemple :
QMenuBar { spacing: 10 }
origine du sous-contrôle*
| Type de sous-contrôle | Origine |
Le rectangle d'origine du sous-contrôle dans l'élément parent.
Si cette propriété n'est pas spécifiée, la valeur par défaut est padding.
Exemple :
QSpinBox::up-button { image: url(:/images/spinup.png); subcontrol-origin: content; subcontrol-position: right top; }
Voir aussi subcontrol-position.
position de sous-contrôle*
| Type | Alignement |
Alignement du sous-contrôle dans le rectangle d'origine spécifié par subcontrol-origin.
Si cette propriété n'est pas spécifiée, elle prend par défaut une valeur qui dépend du sous-contrôle.
Exemple :
QSpinBox::down-button { image: url(:/images/spindown.png); subcontrol-origin: padding; subcontrol-position: right bottom; }
Voir aussi subcontrol-origin.
titlebar-show-tooltips-on-buttons
| Type | bool |
Indique si les bulles d'aide sont affichées sur les boutons de la barre de titre de la fenêtre.
widget-animation-duration*
| Type | Nombre |
Durée d'une animation (en millisecondes). Une valeur égale à zéro signifie que les animations seront désactivées.
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur spécifiée par le style actuel pour l'indice de style SH_Widget_Animation_Duration.
Disponible depuis Qt 5.10.
Exemple :
* { widget-animation-duration: 100 }
alignement du texte
| Type de texte | Alignement |
L'alignement du texte et de l'icône dans le contenu du widget.
Si cette valeur n'est pas spécifiée, elle prend par défaut la valeur qui dépend du style natif.
Exemple :
QPushButton { text-align: left; }
Cette propriété n'est actuellement prise en charge que par QPushButton et QProgressBar.
décoration du texte
| Type | none underline overline line-through |
Effets de texte supplémentaires.
haut
| Type de texte | Longueur |
Si la position est relative (par défaut), déplace un sous-contrôle d'un certain décalage vers le bas.
Si la position est absolute, la propriété top spécifie le bord supérieur du sous-contrôle par rapport au bord supérieur du parent (voir aussi subcontrol-origin).
Si cette propriété n'est pas spécifiée, elle prend par défaut la valeur 0.
Exemple :
QSpinBox::up-button { top: 2px }
Voir aussi gauche, droite et bas.
largeur
| Type de texte | Longueur |
La largeur d'un sous-contrôle (ou d'un widget dans certains cas).
Si cette propriété n'est pas spécifiée, elle prend par défaut une valeur qui dépend du sous-contrôle/du widget et du style actuel.
Attention : Sauf indication contraire, cette propriété n'a aucun effet sur les widgets. Si vous souhaitez que le widget ait une largeur fixe, donnez la même valeur à la min-width et à la max-width.
Exemple :
QSpinBox::up-button { width: 12px }
Voir aussi hauteur.
espacement des mots
| Type d'espacement | Longueur |
Espace entre chaque mot d'une chaîne de caractères dans un widget.
-qt-background-role
| Type de rôle | Rôle de palette |
Le site background-color pour le sous-contrôle ou le widget en fonction du rôle choisi.
-qt-style-features
| Type | list |
La liste des propriétés CSS sur lesquelles vous souhaitez appliquer des styles spécifiques à Qt.
Remarque : le site list ne peut inclure que des propriétés qui ne sont pas basées sur des pixels.
Liste des icônes
Les icônes utilisées dans Qt peuvent être personnalisées à l'aide des propriétés suivantes. Chacune des propriétés énumérées dans cette section est de type Icône.
Notez que pour que les icônes apparaissent dans les boutons d'un site QDialogButtonBox, vous devez attribuer la valeur true à la propriété dialogbuttonbox-buttons-have-icons. De plus, pour personnaliser la taille des icônes, utilisez la propriété icon-size.
Liste des types de biens
Le tableau suivant résume la syntaxe et la signification des différents types de propriétés.
| Type de propriété | Syntaxe | Description de la propriété |
|---|---|---|
| Alignement | { top | bottom | left | right | center }* | Horizontal and/or vertical alignment. Example: QTextEdit { background-position: bottom center } |
| Pièce jointe | { scroll | fixed }* | Scroll or fixed attachment. |
| Arrière-plan | { Brush | Url | Repeat | Alignment }* | Une séquence de Brush, Url, Repeat et Alignment. |
| Booléen | 0 | 1 | Vrai (1) ou faux (0).Exemple : QDialog { etch-disabled-text: 1 } |
| Bordure | { Border Style | Length | Brush }* | Propriété abrégée de la bordure. |
| Image de la bordure | 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. |
| Style de bordure | 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. |
| Couleurs de la boîte | Pinceau{1,4} | Une à quatre occurrences de Brush, spécifiant respectivement les bords supérieur, droit, inférieur et gauche d'une boîte. Si la couleur gauche n'est pas spécifiée, elle est considérée comme identique à la couleur droite. Si la couleur du bas n'est pas spécifiée, elle est considérée comme identique à celle du haut. Si la couleur de droite n'est pas spécifiée, elle est considérée comme identique à la couleur du haut. Exemple : |
| Longueur des boîtes | Longueur{1,4} | Une à quatre occurrences de Longueur, spécifiant respectivement les bords supérieur, droit, inférieur et gauche d'une boîte. Si la longueur gauche n'est pas spécifiée, elle est considérée comme identique à la longueur droite. Si la longueur du bas n'est pas spécifiée, elle est considérée comme identique à la longueur du haut. Si la longueur droite n'est pas spécifiée, elle est considérée comme égale à la longueur supérieure. Exemples : |
| Pinceau | Couleur | Dégradé | PaletteRôle | Spécifie une couleur, un dégradé ou une entrée dans la palette. |
| Couleur | 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 | Spécifie une couleur comme RGB (rouge, vert, bleu), RGBA (rouge, vert, bleu, alpha), HSV (teinte, saturation, valeur), HSVA (teinte, saturation, valeur, alpha), HSL (teinte, saturation, luminosité), HSLA (teinte, saturation, luminosité, alpha) ou une couleur nommée. La syntaxe rgb() ou rgba() peut être utilisée avec des valeurs entières comprises entre 0 et 255, ou avec des pourcentages. Les valeurs s, v, l et a dans hsv(), hsva() hsl() ou hsla() doivent toutes être comprises entre 0 et 255 ou avec des pourcentages, la valeur h doit être comprise entre 0 et 359. La prise en charge de HSL(A) est disponible depuis la version 5.13.Exemples : /* 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%) } Remarque : les couleurs RVB autorisées sont les mêmes que celles autorisées par CSS 2.1, comme indiqué ici. |
| Police | (Style de police | Poids de police){0,2} Taille de la police Chaîne | Propriété de police abrégée. |
| Taille de la police | Longueur | La taille d'une police. |
| Style de police | normal | italic | oblique | The style of a font. |
| Poids de la police | normal | bold | 100 | 200 ... | 900 | The weight of a font. |
| Gradient | qlineargradient | qradialgradient | qconicalgradient | Specifies gradient fills. There are three types of gradient fills:
Les dégradés sont spécifiés en mode délimitation d'objet. Imaginez que la boîte dans laquelle le dégradé est rendu ait son coin supérieur gauche à (0, 0) et son coin inférieur droit à (1, 1). Les paramètres du dégradé sont alors spécifiés sous la forme de pourcentages compris entre 0 et 1. Ces valeurs sont extrapolées aux coordonnées réelles de la boîte au moment de l'exécution. Il est possible de spécifier des valeurs qui se situent en dehors de la boîte de délimitation (-0,6 ou 1,8, par exemple). Attention : Les arrêts doivent être triés par ordre croissant. Exemples : /* 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) } |
| Icône | (Url (disabled | active | normal | selected) ? (on | off) ? )* | Une liste d'url, QIcon::Mode et QIcon::State. Exemple : * { 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; } |
| Longueur | Nombre (px | pt | em | ex) ? | Un nombre suivi d'une unité de mesure. La norme CSS recommande aux agents utilisateurs d'ignorer une déclaration dont la valeur est illégale. Dans Qt, il est obligatoire de spécifier les unités de mesure. Pour des raisons de compatibilité avec les versions antérieures de Qt, les nombres sans unité de mesure sont traités comme des pixels dans la plupart des contextes. Les unités supportées sont les suivantes :
Cependant, Qt XML est limité aux tailles de police dans |
| Nombre | Un nombre entier décimal ou un nombre réel | Exemples : 0 18 , +127, -255, 12.34, -.5, 0009. |
| Origine | margin | border | padding | content | Indicates which of four rectangles to use.
Voir également le modèle de la boîte. |
| PaletteRole | alternate-base | accent | base | bright-text | button | button-text | dark | highlight | highlighted-text | light | link | link-visited | mid | midlight | placeholder-text | shadow | text | tooltip-base | tooltip-text | window | window-text | Ces valeurs correspondent aux Color roles du widget QPalette Par exemple, QPushButton { color: palette(dark); } |
| Rayon | Longueur{1, 2} | Une ou deux occurrences de Length. Si une seule longueur est spécifiée, elle est utilisée comme rayon du quart de cercle définissant le coin. Si deux longueurs sont spécifiées, la première est le rayon horizontal d'un quart d'ellipse, tandis que la seconde est le rayon vertical. |
| Répéter | repeat-x | repeat-y | repeat | no-repeat | A value indicating the nature of repetition.
|
| Url | url(filename) | filename est le nom d'un fichier sur le disque local ou stocké à l'aide du système de ressources Qt. La définition d'une image définit implicitement la largeur et la hauteur de l'élément. |
Liste des pseudo-états
Les pseudo-états suivants sont pris en charge :
| Pseudo-état | Description de l'état |
|---|---|
:active | Cet état est défini lorsque le widget se trouve dans une fenêtre active. |
:adjoins-item | Cet état est activé lorsque le ::branch d'un QTreeView est adjacent à un élément. |
:alternate | Cet état est défini pour chaque rangée alternative peignant la rangée d'un QAbstractItemView lorsque QAbstractItemView::alternatingRowColors() est défini comme vrai. |
:bottom | L'élément est positionné en bas. Par exemple, une page QTabBar dont les onglets sont positionnés en bas. |
:checked | L'élément est coché. Par exemple, l'état checked de QAbstractButton. |
:closable | Les éléments peuvent être fermés. Par exemple, le site QDockWidget a la fonction QDockWidget::DockWidgetClosable activée. |
:closed | L'élément est fermé. Par exemple, un élément non développé dans une page d'accueil. QTreeView |
:default | L'élément est l'élément par défaut. Par exemple, un default QPushButton ou une action par défaut dans un QMenu. |
:disabled | L'élément est disabled. |
:editable | Le site QComboBox est modifiable. |
:edit-focus | L'élément est en cours d'édition (voir QStyle::State_HasEditFocus). Cet état n'est disponible que pour les applications Qt Extended. |
:enabled | L'élément est enabled. |
:exclusive | L'élément fait partie d'un groupe d'éléments exclusifs. Par exemple, un élément de menu dans une application exclusive QActionGroup. |
:first | L'élément est le premier (dans une liste). Par exemple, le premier onglet d'une liste QTabBar. |
:flat | L'élément est plat. Par exemple, un flat QPushButton . |
:floatable | Les éléments peuvent être flottants. Par exemple, la fonction QDockWidget::DockWidgetFloatable est activée sur le site QDockWidget. |
:focus | L'élément a input focus. |
:has-children | L'élément a des enfants. Par exemple, un élément d'une page QTreeView qui a des éléments enfants. |
:has-siblings | L'élément a des frères et sœurs. Par exemple, un élément d'un site QTreeView qui a des frères et sœurs. |
:horizontal | L'élément a une orientation horizontale |
:hover | La souris survole l'élément. |
:indeterminate | L'état de l'élément est indéterminé. Par exemple, un QCheckBox ou QRadioButton est partially checked. |
:last | L'élément est le dernier (dans une liste). Par exemple, le dernier onglet d'une page QTabBar. |
:left | L'élément est positionné à gauche. Par exemple, un site QTabBar dont les onglets sont positionnés à gauche. |
:maximized | L'élément est maximisé. Par exemple, une page QMdiSubWindow maximisée. |
:middle | L'élément est au milieu (dans une liste). Par exemple, un onglet qui n'est ni au début ni à la fin d'un site QTabBar. |
:minimized | L'élément est minimisé. Par exemple, une page QMdiSubWindow réduite. |
:movable | L'élément peut être déplacé. Par exemple, la fonction QDockWidget::DockWidgetMovable est activée sur le site QDockWidget. |
:no-frame | L'élément n'a pas de cadre. Par exemple, une page QSpinBox ou QLineEdit sans cadre. |
:non-exclusive | L'élément fait partie d'un groupe d'éléments non exclusifs. Par exemple, un élément de menu dans un groupe non exclusif QActionGroup. |
:off | Pour les éléments qui peuvent être basculés, cela s'applique aux éléments dans l'état "éteint". |
:on | Pour les éléments qui peuvent être basculés, cela s'applique aux widgets à l'état "allumé". |
:only-one | L'élément est unique (dans une liste). Par exemple, un onglet isolé dans une page QTabBar. |
:open | L'élément est à l'état ouvert. Par exemple, un élément développé dans une page QTreeView, ou une page QComboBox ou QPushButton avec un menu ouvert. |
:next-selected | L'élément suivant (dans une liste) est sélectionné. Par exemple, l'onglet sélectionné d'un site QTabBar se trouve à côté de cet élément. |
:pressed | L'élément est pressé à l'aide de la souris. |
:previous-selected | L'élément précédent (dans une liste) est sélectionné. Par exemple, un onglet d'un site QTabBar qui se trouve à côté de l'onglet sélectionné. |
:read-only | L'élément est en lecture seule ou non modifiable. Par exemple, une page en lecture seule QLineEdit ou une page non modifiable QComboBox. |
:right | L'élément est positionné à droite. Par exemple, une page QTabBar dont les onglets sont positionnés à droite. |
:selected | L'élément est sélectionné. Par exemple, l'onglet sélectionné dans un QTabBar ou l'élément sélectionné dans un QMenu. |
:top | L'élément est positionné en haut. Par exemple, un site QTabBar dont les onglets sont positionnés en haut. |
:unchecked | L'élément est unchecked. |
:vertical | L'élément est orienté verticalement. |
:window | Le widget est une fenêtre (c'est-à-dire un widget de premier niveau). |
Liste des sous-contrôles
Les sous-contrôles suivants sont disponibles :
| Sous-contrôle | Description |
|---|---|
::add-line | Le bouton pour ajouter une ligne d'un QScrollBar. |
::add-page | La région entre la poignée (curseur) et la ligne d'ajout d' un QScrollBar. |
::branch | L'indicateur de branche d'un QTreeView. |
::chunk | Le bloc de progression d'un QProgressBar. |
::close-button | Le bouton de fermeture d'un site QDockWidget ou des onglets d'un site . QTabBar |
::corner | Le coin entre deux barres de défilement d'une page Web. QAbstractScrollArea |
::down-arrow | La flèche vers le bas d'un site QComboBox, QHeaderView (indicateur de tri), QScrollBar ou QSpinBox. |
::down-button | Le bouton de descente d'un QScrollBar ou d'un QSpinBox. |
::drop-down | Le bouton déroulant d'une page QComboBox. |
::float-button | Le bouton flottant d'un QDockWidget |
::groove | La rainure d'un QSlider. |
::indicator | L'indicateur d'un QAbstractItemView, d'un QCheckBox, d'un QRadioButton, d'un élément vérifiable QMenu ou d'un élément vérifiable QGroupBox. |
::handle | La poignée (curseur) d'un QScrollBar, d'un QSplitter, ou d'un QSlider. |
::icon | L'icône d'un QAbstractItemView ou d'un QMenu. |
::item | Un élément d'un QAbstractItemView, d'un QMenuBar, d'un QMenu, ou d'un QStatusBar. |
::left-arrow | La flèche gauche d'un QScrollBar. |
::left-corner | Le coin gauche d'un QTabWidget. Par exemple, ce contrôle peut être utilisé pour contrôler la position du widget du coin gauche dans un QTabWidget. |
::menu-arrow | La flèche d'une page QToolButton avec un menu. |
::menu-button | Le bouton de menu d'un site QToolButton. |
::menu-indicator | L'indicateur de menu d'un site QPushButton. |
::right-arrow | La flèche droite d'un QMenu ou d'un QScrollBar. |
::pane | Le volet (cadre) d'un site QTabWidget. |
::right-corner | Le coin droit d'un site QTabWidget. Par exemple, ce contrôle peut être utilisé pour contrôler la position du widget du coin droit dans un site QTabWidget. |
::scroller | Le scroller d'une page QMenu ou QTabBar. |
::section | La section d'une page QHeaderView. |
::separator | Le séparateur d'un QMenu ou d'un QMainWindow. |
::sub-line | Le bouton pour soustraire une ligne d'un QScrollBar. |
::sub-page | La région entre la poignée (curseur) et la sous-ligne d'un QScrollBar. |
::tab | La tabulation d'un QTabBar ou d'un QToolBox. |
::tab-bar | La barre d'onglets d'un QTabWidget. Ce sous-contrôle n'existe que pour contrôler la position du QTabBar à l'intérieur du QTabWidget. Pour styliser les onglets à l'aide du sous-contrôle ::tab. |
::tear | L'indicateur de déchirure d'un QTabBar. |
::tearoff | L'indicateur de déchirement d'un QMenu. |
::text | Le texte d'une page QAbstractItemView. |
::title | Le titre d'un QGroupBox ou d'un QDockWidget. |
::up-arrow | La flèche vers le haut d'un QHeaderView (indicateur de tri), d'un QScrollBar ou d'un QSpinBox. |
::up-button | Le bouton haut d'un QSpinBox. |
Voir Personnaliser le sous-contrôle de l'indicateur de menu de QPushButton pour un exemple de personnalisation d'un sous-contrôle.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
