AbstractZonedFeature QML Type

The AbstractZonedFeature is not directly accessible. The QML type provides base QML properties for each QML Vehicle feature like zone and error access. More...

Import Statement: import QtIvi 1.0
Instantiates: QIviAbstractZonedFeature
Inherits:

AbstractFeature

Inherited By:

ClimateControl and WindowControl

Properties

Methods

Detailed Description

Property Documentation

availableZones : QStringList

List of the available zones.


discoveryMode : enumeration

Holds the mode that is used for the autoDiscovery

Available values are:

ConstantDescription
NoAutoDiscoveryNo auto discovery is done and the ServiceObject needs to be set manually.
AutoDiscoveryTries to find a production backend with a matching interface and falls back to a simulation backend if not found.
LoadOnlyProductionBackendsOnly tries to load a production backend with a matching interface.
LoadOnlySimulationBackendsOnly tries to load a simulation backend with a matching interface.

If needed the auto discovery will be started once the Feature creation is completed.

Note: If you change this property after the Feature is instantiated you need to call startAutoDiscovery() to search for a new Service Object


discoveryResult : enumeration

The result of the last autoDiscovery

Available values are:

ConstantDescription
NoResultIndicates that no auto discovery was started because the feature has already assigned a valid ServiceObject.
ErrorWhileLoadingAn error has happened while searching for a backend with a matching interface.
ProductionBackendLoadedAs a result of the auto discovery a production backend was loaded.
SimulationBackendLoadedAs a result of the auto discovery a simulation backend was loaded.

isInitialized : bool

Indicates whether the feature has been initialized with all the values from the backend.

The property is true once the backend sends the QIviFeatureInterface::initializationDone signal to indicate that all values have now been initialized with values from the backend.

See also isValid and QIviFeatureInterface::initializationDone.


isValid : bool

Indicates whether the feature is ready for use.

The property is true if the feature is ready to be used, otherwise false. Not being ready usually indicates that no suitable service object could be found, or that automatic discovery has not been triggered.

The backend still might not have sent all properties yet and is not fully initialized. Use isInitialized instead to know when the feature holds all correct values.

See also QIviServiceObject, discoveryMode, and isInitialized.


serviceObject : ServiceObject

Sets the service object for the feature.

As features only expose the front API facing the developer, a service object implementing the actual function is required. This is usually retrieved through the auto discovery mechanism.

The setter for this property returns false if the Service Object is already set to exactly this instance or the Service Object doesn't get accepted by the feature.

See also discoveryMode.


zone : QString

Name of the zone of this zoned feature.

The zone can be given in the feature initialization. With this property it's possible to control only a single specific feature zone.

This property is writable only before the backend is connected. When the backend is discovered and the component is verified to be valid, zone is not writable anymore. It's not recommended to change the zone after the initialization.

 ClimateControl {
     zone: "FrontLeft"
     onAirConditioningChanged: {
         // Take action on front left A/C changes.
     }
}

zoneAt : QVariantMap

Direct feature access to the given zone.

feature.zoneAt.FrontLeft

zones : QVariantList

Access to the feature zones model.

model: feature.zones

Method Documentation

enumeration startAutoDiscovery()

Performs an automatic discovery attempt.

The feature will try to locate a single service object implementing the required interface.

If no service object is found, the feature will stay invalid. If more than one service object is found, the first instance is used.

Either the type of the backend which was loaded or an error is returned.

If the discoveryMode is set to QIviAbstractFeature::NoAutoDiscovery this function will do nothing and return QIviAbstractFeature::NoResult.

Return values are:

ConstantDescription
NoResultIndicates that no auto discovery was started because the feature has already assigned a valid ServiceObject.
ErrorWhileLoadingAn error has happened while searching for a backend with a matching interface.
ProductionBackendLoadedAs a result of the auto discovery a production backend was loaded.
SimulationBackendLoadedAs a result of the auto discovery a simulation backend was loaded.

See also Dynamic Backend System and QIviServiceManager.


© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.