QIfAbstractFeatureListModel Class

Member Function Documentation

[explicit] QIfAbstractFeatureListModel::QIfAbstractFeatureListModel(const QString &interfaceName, QObject *parent = nullptr)

Constructs a QIfAbstractFeatureListModel.

The parent argument is passed on to the QAbstractListModel base class.

The interfaceName argument is used to locate suitable service objects.

[virtual protected] bool QIfAbstractFeatureListModel::acceptServiceObject(QIfServiceObject *serviceObject)

This method is expected to be implemented by any class subclassing QIfAbstractFeature.

The method should return true if the given serviceObject is accepted and can be used, otherwise false.

If the object is accepted, connectToServiceObject is called to actually connect to the service object.

The default implementation accepts the serviceObject if it implements the interface returned by interfaceName();

See also connectToServiceObject(), disconnectFromServiceObject(), and clearServiceObject().

[pure virtual protected] void QIfAbstractFeatureListModel::clearServiceObject()

This method is expected to be implemented by any class subclassing QIfAbstractFeatureListModel.

Called when no service object is available. The implementation is expected to set all properties to safe defaults and forget all links to the previous service object.

There is no need to disconnect from the service object. If it still exists, it is guaranteed that disconnectFromServiceObject is called first.

See also acceptServiceObject(), connectToServiceObject(), and disconnectFromServiceObject().

[virtual protected] void QIfAbstractFeatureListModel::connectToServiceObject(QIfServiceObject *serviceObject)

This method is expected to be implemented by any class subclassing QIfAbstractFeature.

The implementation should connect to the serviceObject, and set up all properties to reflect the state of the service object.

There is no previous service object connected, as this function call is always preceded by a call to disconnectFromServiceObject or clearServiceObject.

It is safe to assume that the serviceObject, has always been accepted through the acceptServiceObject method prior to being passed to this method.

The default implementation connects to the signals offered by QIfFeatureInterface and calls QIfFeatureInterface::initialize() afterwards.

When reimplementing please keep in mind to connect all signals before calling this function. e.g.

/code void SimpleFeature::connectToServiceObject(QIfServiceObject *serviceObject) { SimpleFeatureBackendInterface *backend = backend(serviceObject); if (!backend) return;

// connect your signals connect(backend, &SimpleFeatureBackendInterface::propertyChanged, this, &SimpleFeature::onPropertyChanged);

// connects the base signals and call initialize() QIfAbstractFeature::connectToServiceObject(serviceObject);

// Additional initialization functions can be added here } /endcode

See also acceptServiceObject(), disconnectFromServiceObject(), and clearServiceObject().

[virtual protected] void QIfAbstractFeatureListModel::disconnectFromServiceObject(QIfServiceObject *serviceObject)

This method is expected to be implemented by any class subclassing QIfAbstractFeature.

The implementation should disconnect all connections to the serviceObject.

There is no need to reset internal variables to safe defaults. A call to this function is always followed by a call to connectToServiceObject or clearServiceObject.

The default implementation disconnects all signals from the serviceObject to this instance.

See also acceptServiceObject(), connectToServiceObject(), and clearServiceObject().

QIfAbstractFeature::Error QIfAbstractFeatureListModel::error() const

Returns the last error code.

See also setError() and QIfAbstractFeature::Error.

[protected] QString QIfAbstractFeatureListModel::errorText() const

Returns the current error code converted from QIfAbstractFeature::Error to QString

See also error.

[protected] QString QIfAbstractFeatureListModel::interfaceName() const

Returns the interface name this Feature expect to be available from the Service Object and this Feature is implementing.

See also acceptServiceObject.

[virtual protected slot] void QIfAbstractFeatureListModel::onErrorChanged(QIfAbstractFeature::Error error, const QString &message = QString())

Updates error and message from the backend.

This slot can be used when implementing a new Feature to report generic errors.

[protected] void QIfAbstractFeatureListModel::setError(QIfAbstractFeature::Error error, const QString &message = QString())

Sets error with the message.

Emits errorChanged() signal.

See also error() and QIfAbstractFeature::Error.

[slot] QIfAbstractFeature::DiscoveryResult QIfAbstractFeatureListModel::startAutoDiscovery()

Performs an automatic discovery attempt.