|  | Home · Examples

# Qt Style Sheets

[Next: The Style Sheet Syntax]

How to use style sheets to customize the appearance of widgets. Qt Style Sheets are a powerful mechanism that allows you to customize the appearance of widgets, in addition to what is already possible by subclassing QStyle. The concepts, terminology, and syntax of Qt Style Sheets are heavily inspired by HTML Cascading Style Sheets (CSS) but adapted to the world of widgets.

Topics:

- Overview
- The Style Sheet Syntax
  - Style Rules
  - Selector Types
  - Sub-Controls
  - Pseudo-States
  - Conflict Resolution
  - Cascading
  - Inheritance
  - Widgets inside C++ namespaces
  - Setting QObject properties
- Qt Designer Integration
- Customizing Qt Widgets Using Style Sheets
  - The Box Model
  - Sub-controls
- Qt Style Sheets Reference
  - List of Stylable Widgets
  - List of Properties
  - List of Icons
  - List of Property Types
  - List of Pseudo-States
  - List of Sub-Controls
- Qt Style Sheets Examples
  - Style Sheet Usage
  - Customizing the Foreground and Background Colors
  - Customizing Using Dynamic Properties
  - Customizing a QPushButton Using the Box Model
  - Customizing the QPushButton's Menu Indicator Sub-Control
  - Complex Selector Example
  - Customizing specific widgets
  - Customizing QAbstractScrollArea
  - Customizing QCheckBox
  - Customizing QComboBox
  - Customizing QDockWidget
  - Customizing QFrame
  - Customizing QGroupBox
  - Customizing QHeaderView
  - Customizing QLineEdit
  - Customizing QListView
  - Customizing QMainWindow
  - Customizing QMenu
  - Customizing QMenuBar
  - Customizing QProgressBar
  - Customizing QPushButton
  - Customizing QRadioButton
  - Customizing QScrollBar
  - Customizing QSizeGrip
  - Customizing QSlider
  - Customizing QSpinBox
  - Customizing QSplitter
  - Customizing QStatusBar
  - Customizing QTabWidget and QTabBar
  - Customizing QTableView
  - Customizing QToolBar
  - Customizing QToolBox
  - Customizing QToolButton
  - Customizing QToolTip
  - Customizing QTreeView
  - Common mistakes
  - QPushButton and images

## Overview

Styles sheets are textual specifications that can be set on the whole application using QApplication::setStyleSheet() or on a specific widget (and its children) using QWidget::setStyleSheet(). If several style sheets are set at different levels, Qt derives the effective style sheet from all of those that are set. This is called cascading.

For example, the following style sheet specifies that all QLineEdits should use yellow as their background color, and all QCheckBoxes should use red as the text color:

    QLineEdit { background: yellow }
    QCheckBox { color: red }

For this kind of customization, style sheets are much more powerful than QPalette. For example, it might be tempting to set the QPalette::Button role to red for a QPushButton to obtain a red push button. However, this wasn't guaranteed to work for all styles, because style authors are restricted by the different platforms' guidelines and (on Windows XP and Mac OS X) by the native theme engine.

Style sheets let you perform all kinds of customizations that are difficult or impossible to perform using QPalette alone. If you want yellow backgrounds for mandatory fields, red text for potentially destructive push buttons, or fancy check boxes, style sheets are the answer.

Style sheets are applied on top of the current widget style, meaning that your applications will look as native as possible, but any style sheet constraints will be taken into consideration. Unlike palette fiddling, style sheets offer guarantees: If you set the background color of a QPushButton to be red, you can be assured that the button will have a red background in all styles, on all platforms. In addition, Qt Designer provides style sheet integration, making it easy to view the effects of a style sheet in different widget styles.

In addition, style sheets can be used to provide a distinctive look and feel for your application, without having to subclass QStyle. For example, you can specify arbitrary images for radio buttons and check boxes to make them stand out. Using this technique, you can also achieve minor customizations that would normally require subclassing several style classes, such as specifying a style hint. The Style Sheet example depicted below defines two distinctive style sheets that you can try out and modify at will.

When a style sheet is active, the QStyle returned by QWidget::style() is a wrapper "style sheet" style, not the platform-specific style. The wrapper style ensures that any active style sheet is respected and otherwise forwards the drawing operations to the underlying, platform-specific style (e.g., QWindowsXPStyle on Windows XP).

Warning: Qt style sheets are currently not supported for Mac OS X and custom QStyle subclasses. We plan to address this in some future release.