From 488f24540d087ae98fff4b3a4de82bdf9acbc72c Mon Sep 17 00:00:00 2001
From: Leena Miettinen <riitta-leena.miettinen@qt.io>
Date: Fri, 20 Sep 2019 13:57:47 +0200
Subject: [PATCH] Doc: Explain that property editor cannot handle custom class
properties
That is, Q_PROPERTY types for custom types that have been declared
with Q_DECLARE_METATYPE().
Fixes: QTBUG-17816
Change-Id: I48c33af13d85b877596caca4fbd1103bf383d6e8
Reviewed-by: Friedemann Kleint <Friedemann.Kleint@qt.io>
---
src/designer/src/lib/sdk/propertysheet.qdoc | 29 +++++++++++++--------
1 file changed, 18 insertions(+), 11 deletions(-)
diff --git a/src/designer/src/lib/sdk/propertysheet.qdoc b/src/designer/src/lib/sdk/propertysheet.qdoc
index 4e0ccddf2..e5ab420f4 100644
--- a/src/designer/src/lib/sdk/propertysheet.qdoc
+++ b/src/designer/src/lib/sdk/propertysheet.qdoc
@@ -68,17 +68,24 @@
also provides an interface for creating custom property sheet
extensions.
- \warning \QD uses the QDesignerPropertySheetExtension to feed its
- property editor. Whenever a widget is selected in its workspace,
- \QD will query for the widget's property sheet extension. If the
- selected widget has an implemented property sheet extension, this
- extension will override the default property sheet.
-
- \warning The data types used by the property sheet for some properties
- are opaque custom QVariant types containing additional information
- instead of plain Qt data types.
- For example, this is the case for enumerations, flags,
- icons, pixmaps and strings.
+ Keep the following limitations in mind:
+
+ \list
+ \li \QD uses the QDesignerPropertySheetExtension to feed its
+ property editor. Whenever a widget is selected in its workspace,
+ \QD will query for the widget's property sheet extension. If the
+ selected widget has an implemented property sheet extension, this
+ extension will override the default property sheet.
+
+ \li The data types used by the property sheet for some properties
+ are opaque custom QVariant types containing additional information
+ instead of plain Qt data types. For example, this is the case for
+ enumerations, flags, icons, pixmaps and strings.
+
+ \li \QD's property editor has no implementation for handling
+ Q_PROPERTY types for custom types that have been declared
+ with Q_DECLARE_METATYPE().
+ \endlist
To create a property sheet extension, your extension class must
inherit from both QObject and
--
GitLab