diff options
authorMitch Curtis <mitch.curtis@qt.io>2019-11-06 13:51:55 +0100
committerMitch Curtis <mitch.curtis@qt.io>2019-11-07 09:58:08 +0100
commit6f8ed8a6130f5583ec24220ddf440877dc45afa0 (patch)
parent17cc497f16ea5e2d722db422e2c6611e107f62a8 (diff)
Doc: advise against naming root resource dirs the same as style names
Task-number: QTBUG-59330 Change-Id: Ie983f27f2eca0bc9c906fb7bcfe9e077616ef88b Reviewed-by: Kavindra Palaraja <kpalaraja@luxoft.com> Reviewed-by: Paul Wicking <paul.wicking@qt.io>
1 files changed, 7 insertions, 0 deletions
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