成员函数文档

QIviAbstractFeature::QIviAbstractFeature(const QString &interfaceName, QObject *parent = nullptr)

构建一个抽象特征。

将parent参数传递给QObject构造函数。

interfaceName参数用于查找合适的查找服务对象。

[虚拟受保护槽] void QIviAbstractFeature::onErrorChanged(QIviAbstractFeature::Error error, const QString &message = QString())

从后端更新error和message。

当实现新特征以报告通用错误时，请使用此槽。

[槽] QIviAbstractFeature::DiscoveryResult QIviAbstractFeature::startAutoDiscovery()

执行自动发现尝试。

功能将尝试查找一个实现所需接口的单一查找服务对象。

如果没有找到查找服务对象，则该功能将保持无效。如果找到多个查找服务对象，则使用第一个实例。

返回已加载的后端类型或错误。

如果discoveryMode设置为QIviAbstractFeature::NoAutoDiscovery，则此函数将不执行任何操作并返回QIviAbstractFeature::NoResult。

另请参阅 discoveryMode()和动态后端系统。

[虚拟受保护] bool QIviAbstractFeature::acceptServiceObject(QIviServiceObject *serviceObject)

此方法预期由所有继承自QIviAbstractFeature的类实现。

方法应返回true，如果给定的serviceObject被接受并可用于使用；否则返回false。

如果对象被接受，则调用connectToServiceObject来实际连接到服务对象。

默认实现接受由interfaceName()返回的接口的serviceObject;

另请参阅 connectToServiceObject、disconnectFromServiceObject和clearServiceObject。

[纯虚拟受保护] void QIviAbstractFeature::clearServiceObject()

此方法预期由所有继承自QIviAbstractFeature的类实现。

当没有服务对象可用时调用。期望实现将所有属性设置为安全默认值，并忘记与先前服务对象的全部链接。

注意：您必须发出相应属性的更改信号，这样特征就可以得知状态变化。这使得实现类之后能够连接到新的服务对象。

无需从服务对象断开连接。如果它仍然存在，则保证首先调用disconnectFromServiceObject方法。

另请参阅：acceptServiceObject()，connectToServiceObject()和disconnectFromServiceObject。

[覆盖虚拟保护] void QIviAbstractFeature::componentComplete()

重新实现：QQmlParserStatus::componentComplete。

在从QML使用时自动调用。调用startAutoDiscovery。

[虚拟保护] void QIviAbstractFeature::connectToServiceObject(QIviServiceObject *serviceObject)

此方法预期由所有继承自QIviAbstractFeature的类实现。

实现应连接到serviceObject，并将所有属性设置为反映服务对象的状态。

因为此函数调用之前总是跟随disconnectFromServiceObject或clearServiceObject调用，所以没有前一个连接的服务对象。

可以安全地假设，在传递给此方法之前，serviceObject已经通过acceptServiceObject方法接受。

默认实现连接到QIviFeatureInterface提供的信号，并在之后调用QIviFeatureInterface::initialize()。

在重新实现时，请注意在调用此函数之前连接所有信号。例如：

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

// 连接您的信号 connect(backend, &SimpleFeatureBackendInterface::propertyChanged, this, &SimpleFeature::onPropertyChanged);

// 连接基本信号并调用 initialize() QIviAbstractFeature::connectToServiceObject(serviceObject);

// 可在此处添加其他初始化函数 } /endcode

另请参阅：acceptServiceObject，disconnectFromServiceObject和clearServiceObject。

[虚拟保护] void QIviAbstractFeature::disconnectFromServiceObject(QIviServiceObject *serviceObject)

此方法断开所有对serviceObject的连接。

无需将内部变量重置为安全默认值。调用此函数总是跟随对connectToServiceObject或clearServiceObject的调用。

默认实现从serviceObject到该实例断开所有信号。

大部分情况下，您不需要重新实现此方法。只有在之前已经连接了多个接口或断开连接前后端之前需要进行特殊清理调用时，才需要重新实现。如果您需要重新实现此功能，请确保使用 interfaceName() 方法获取后端实例，而不是将特定的 interfaceName 编入硬代码，否则断开连接的调用不再适用于派生接口。

另请参阅 acceptServiceObject()，connectToServiceObject() 和 clearServiceObject()。

QIviAbstractFeature::Error QIviAbstractFeature::error() const

返回最后一个错误代码。

另请参阅 setError() 和 QIviAbstractFeature::Error。

[protected] QString QIviAbstractFeature::errorText() const

返回从 QIviAbstractFeature::Error 转换为 QString 的当前错误代码。

另请参阅 error。

[protected] QString QIviAbstractFeature::interfaceName() const

返回该功能所实现的接口名称。

当功能发现一个匹配的后端时，该接口名称需要由该功能所连接的服务对象支持。

有关更多信息，请参阅 扩展 Qt IVI。

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

使用 message 设置 error。

触发 errorChanged() 信号。

另请参阅 error() 和 QIviAbstractZonedFeature::Error。