Use Case - Style And Theme Support

Styling with QML involves creating a visual type and binding that to a property or by directly assigning a value to a property. For types that incorporate Qt Quick's delegates the visual type attaches to the delegate property.

When using Qt Quick Controls, the controls automatically set the appropriate style from the respective platforms.

Using the Styling QML Types

The controls have a style property to which the styling types bind. The controls have a corresponding styling type from the Qt Quick Controls Styles module. For example, Button has a ButtonStyle type and Menu has a MenuStyle type. The styling types provide properties applicable to their respective controls such as the background, label, or for some controls, the cursor appearance.

  Button {
      text: qsTr("Hello World")
      style: ButtonStyle {
          background: Rectangle {
              implicitWidth: 100
              implicitHeight: 25
              border.width: control.activeFocus ? 2 : 1
              border.color: "#FFF"
              radius: 4
              gradient: Gradient {
                  GradientStop { position: 0 ; color: control.pressed ? "#ccc" : "#fff" }
                  GradientStop { position: 1 ; color: control.pressed ? "#000" : "#fff" }
              }
          }
     }

Note: Qt Quick Controls Styles was introduced in Qt 5.1 and requires Qt Quick 2.1.

Accessing the System Palette

The SystemPalette type provides information about the system's palette information. QML applications can use this information to set the appearance of visual types to match the native look-and-feel. In addition, on desktop platforms, different color palettes are employed when changing states, for example, when the application loses keyboard focus.

When using the controls, the system colors are already used.