-
Bug
-
Resolution: Unresolved
-
P2: Important
-
None
-
6.5.10, 6.8.4, 6.10.0 Beta3
-
4b4088755 (dev), cbc0fa4cd (6.10), 853329b3c (6.10.0), d16eee5d6 (6.9), df410a336 (tqtc/lts-6.8), c52de19e7 (tqtc/lts-6.5)
-
DaVinci 124, DaVinci 125, DaVinci 126
https://codereview.qt-project.org/c/qt/qtpositioning/+/435520 gave formal names to the QML value types, which were previously "anonymous". This means: Before that patch, QML code was unable to refer to those types by name.
Informal names for these types already exist throughout our documentation (see https://doc.qt.io/qt-6/qtpositioning-qmlmodule.html#value-types and https://doc.qt.io/qt-6/qml-qtpositioning-location.html#coordinate-prop for example), but unfortunately these informal names don't match the actual names that QML code would now use. For example:
property geoCoordinate london1: ( { "latitude": 51.5072, "longitude": -0.1276 } ) // Correct property coordinate london2: ( { "latitude": 51.5072, "longitude": -0.1276 } ) // ERROR: "coordinate" does not exist
Here's a complete table of the value types:
Documented name | Actual name |
---|---|
coordinate | geoCoordinate |
geoSatelliteInfo | geoSatelliteInfo |
geocircle | geoCircle |
geopath | geoPath |
geopolygon | geoPolygon |
georectangle | geoRectangle |
geoshape | geoShape |
Notes
geoAddress, geoLocation, and geoPositionInfo are missing from https://doc.qt.io/qt-6/qtpositioning-qmlmodule.html#value-types
- geoAddress should be documented because there's a public property of this type: https://doc.qt.io/qt-6/qml-qtpositioning-address.html#address-prop
- geoLocation should be documented because there's a public property of this type: https://doc.qt.io/qt-6/qml-qtpositioning-location.html#location-prop
- I'm not sure about geoPositionInfo. It looks like Position (https://doc.qt.io/qt-6/qml-qtpositioning-position.html ) provides an "indirect" wrapper for geoPositionInfo/QGeoPositionInfo, so perhaps geoPositionInfo shouldn't be documented as a standalone type. I'll let the Qt Positioning maintainers comment on this.
- is required for
-
QTBUG-139782 Qt Positioning: Outdated documentation for value types
-
- Reported
-
- relates to
-
QTBUG-139652 Link to QML property goes to incorrect type
-
- Closed
-
For Gerrit Dashboard: QTBUG-139780 | ||||||
---|---|---|---|---|---|---|
# | Subject | Branch | Project | Status | CR | V |
672866,6 | Doc: Document the actual type names | dev | qt/qtpositioning | Status: MERGED | +2 | 0 |
674414,2 | Doc: Document the actual type names | 6.10 | qt/qtpositioning | Status: MERGED | +2 | 0 |
674553,2 | Doc: Document the actual type names | 6.10.0 | qt/qtpositioning | Status: MERGED | +2 | 0 |
674554,2 | Doc: Document the actual type names | 6.9 | qt/qtpositioning | Status: MERGED | +2 | 0 |
674615,2 | Doc: Document the actual type names | tqtc/lts-6.8 | qt/tqtc-qtpositioning | Status: MERGED | +2 | 0 |
674642,2 | Doc: Document the actual type names | tqtc/lts-6.5 | qt/tqtc-qtpositioning | Status: MERGED | +2 | 0 |