diff options
Diffstat (limited to 'sources/pyside6/doc/extras/QtCore.ClassInfo.rst')
-rw-r--r-- | sources/pyside6/doc/extras/QtCore.ClassInfo.rst | 29 |
1 files changed, 20 insertions, 9 deletions
diff --git a/sources/pyside6/doc/extras/QtCore.ClassInfo.rst b/sources/pyside6/doc/extras/QtCore.ClassInfo.rst index b767ae153..75445e1fc 100644 --- a/sources/pyside6/doc/extras/QtCore.ClassInfo.rst +++ b/sources/pyside6/doc/extras/QtCore.ClassInfo.rst @@ -1,23 +1,34 @@ .. currentmodule:: PySide6.QtCore -.. _ClassInfo: +.. py:decorator:: ClassInfo -ClassInfo -********* - -This class is used to associates extra information to the class, which is available -using QObject.metaObject(). Qt and PySide doesn't use this information. +This decorator is used to associate extra information to the class, which is available +using ``QObject.metaObject()``. This information is used by the +*Qt D-Bus* and *Qt Qml* modules. The extra information takes the form of a dictionary with key and value in a literal string. -.. note:: This Class is a implementation of Q_CLASSINFO macro. - +The recommended usage is to provide the key/value using python keyword syntax, where the +keyword becomes the key, and the provided string becomes the value. + +If the key needs to contain special characters (spaces, commas, '::', start with a number, etc), +it is also possible to pass a python dictionary with arbitrary strings for both the key and +value and enabling special characters in the key. + +.. note:: This decorator is a implementation of the Q_CLASSINFO macro. + Example ------- -:: +.. code-block:: python + # Recommended syntax @ClassInfo(Author='PySide Team', URL='http://www.pyside.org') class MyObject(QObject): ... + + # Provided to support keys not supported by Python's keyword syntax + @ClassInfo({'Some key text $': 'This syntax supports special characters in keys'}) + class MyObject(QObject): + ... |