From 6f8ed8a6130f5583ec24220ddf440877dc45afa0 Mon Sep 17 00:00:00 2001 From: Mitch Curtis Date: Wed, 6 Nov 2019 13:51:55 +0100 Subject: Doc: advise against naming root resource dirs the same as style names Task-number: QTBUG-59330 Change-Id: Ie983f27f2eca0bc9c906fb7bcfe9e077616ef88b Reviewed-by: Kavindra Palaraja Reviewed-by: Paul Wicking --- src/imports/controls/doc/src/qtquickcontrols2-styles.qdoc | 7 +++++++ 1 file changed, 7 insertions(+) (limited to 'src/imports/controls') diff --git a/src/imports/controls/doc/src/qtquickcontrols2-styles.qdoc b/src/imports/controls/doc/src/qtquickcontrols2-styles.qdoc index 27731e42..75e59f42 100644 --- a/src/imports/controls/doc/src/qtquickcontrols2-styles.qdoc +++ b/src/imports/controls/doc/src/qtquickcontrols2-styles.qdoc @@ -78,6 +78,13 @@ from highest to lowest. That is, using QQuickStyle to set the style will always take priority over using the command line argument, for example. + \warning When resolving a given style name to an absolute path, QQuickStyle + may search the root resource directory (\c {:}). Consequently, make sure + that your resource directories are named differently than the names of the + styles that your application supports. Otherwise, the styles may not load. + For example, avoid naming a resource directory \c :/material + (or \c {:/Material}) if the application supports the Material style. + \section2 Using QQuickStyle in C++ \l QQuickStyle provides C++ API for configuring a specific style. The following -- cgit v1.2.3