diff options
Diffstat (limited to 'sources/pyside6/doc/extras/QtQml.qmlRegisterUncreatableType.rst')
-rw-r--r-- | sources/pyside6/doc/extras/QtQml.qmlRegisterUncreatableType.rst | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/sources/pyside6/doc/extras/QtQml.qmlRegisterUncreatableType.rst b/sources/pyside6/doc/extras/QtQml.qmlRegisterUncreatableType.rst new file mode 100644 index 000000000..2f34cd987 --- /dev/null +++ b/sources/pyside6/doc/extras/QtQml.qmlRegisterUncreatableType.rst @@ -0,0 +1,36 @@ +.. currentmodule:: PySide6.QtQml +.. _qmlRegisterUncreatableType: + + +qmlRegisterUncreatableType +************************** + + +.. py:function:: qmlRegisterUncreatableType(pytype: type, uri: str, versionMajor: int, versionMinor: int, qmlName: str, noCreationReason: str) -> int + + + :param type pytype: Python class + :param str uri: uri to use while importing the component in QML + :param int versionMajor: major version + :param int versionMinor: minor version + :param str qmlName: name exposed to QML + :param str noCreationReason: Error message shown when trying to create the QML type + :return: int (the QML type id) + + This function registers the Python *type* in the QML system as an uncreatable type with the + name *qmlName*, in the library imported from *uri* having the + version number composed from *versionMajor* and *versionMinor*, + showing *noCreationReason* as an error message when creating the type is attempted. + + For example, this registers a Python class 'MySliderItem' as a QML + type named 'Slider' for version '1.0' of a module called + 'com.mycompany.qmlcomponents': + + :: + qmlRegisterUncreatableType(MySliderItem, "com.mycompany.qmlcomponents", 1, 0, "Slider", "Slider cannot be created.") + + Note that it's perfectly reasonable for a library to register types + to older versions than the actual version of the library. + Indeed, it is normal for the new library to allow QML written to + previous versions to continue to work, even if more advanced + versions of some of its types are available. |