On this page

StyleKitDebug QML Type

Traces how style properties are resolved for a control. More...

Import Statement: import Qt.labs.StyleKit
Status: Technology preview

This type is in technology preview and is subject to change.

Properties

Detailed Description

StyleKitDebug is a diagnostic tool that logs style property reads to the debug output. It is useful for understanding why a control ends up with a particular appearance, especially in complex styles that involve multiple themes or style variations.

It is accessed through StyleKit.debug.

Note: This tool is experimental. Enabling it will severely degrade performance and should only be used for debugging. The output format may change in future versions.

To start tracing, assign the id of a Control to the control property:

StyleKit.debug.control = myButton

Each resolved property is printed as a single line showing where the value came from and what it resolved to:

[read] StyleReader[Normal].button.background.color -> button[Normal] = #ff0000

Use filter to limit the output to properties of interest.

Note: Types in Qt.labs modules are not guaranteed to remain compatible in future versions.

See also StyleKit::debug.

Property Documentation

control : Item

The id of the Control to trace.

When set, StyleKit logs all style property reads for this item to the debug output. Set to null to stop tracing.

See also filter.

filter : string

A regular expression used to filter the debug output. Only lines matching the pattern are printed. By default, all output is shown.

For example, to show only reads of the background color:

StyleKit.debug.filter = "background.color"

See also control.

© 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.