QIfAbstractFeature 类

成员函数文档

[显式] QIfAbstractFeature::QIfAbstractFeature(const QString &interfaceName, QObject *parent = nullptr)

构造一个抽象特征。

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

interfaceName参数用于定位合适的服务对象。

[虚拟受保护] bool QIfAbstractFeature::acceptServiceObject(QIfServiceObject *serviceObject)

此方法预期将被任何继承自QIfAbstractFeature的类实现。

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

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

默认实现接受serviceObject，如果它实现了由interfaceName()返回的接口；

另请参阅 connectToServiceObject()、disconnectFromServiceObject()和clearServiceObject。

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

此方法预期将被任何继承自QIfAbstractFeature的类实现。

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

不需要与服务对象断开连接。如果它仍然存在，则保证首先调用disconnectFromServiceObject。

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

[override virtual protected] void QIfAbstractFeature::componentComplete()

重写： QQmlParserStatus::componentComplete。

在使用 QML 时自动调用。调用 startAutoDiscovery()。

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

此方法预期将被任何继承自QIfAbstractFeature的类实现。

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

没有连接先前服务对象，因为此函数调用始终在调用 disconnectFromServiceObject 或 clearServiceObject 之后。

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

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

在重写时请记住在使用此函数之前连接所有信号。例如。

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
}

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

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

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

不需要将内部变量重置为安全默认值。对此函数的调用总是紧跟在调用 connectToServiceObject 或 clearServiceObject 之后。

默认实现与此实例断开来自 serviceObject 的所有信号。

大多数情况下，您不需要重写此方法。只有在之前连接了多个接口或断开连接之前需要对其后端执行特殊清理调用时才需要重写。如果您需要重写此函数，请确保使用 interfaceName() 方法获取后端实例，而不是使用特定的 interfaceName 编码它，否则解除连接调用不再适用于派生接口。

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

QIfAbstractFeature::Error QIfAbstractFeature::error() const

返回最后一个错误代码。

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

[protected] QString QIfAbstractFeature::errorText() const

将 QIfAbstractFeature::Error 转换为 QString 的当前错误代码

另请参阅 error。

[protected] QString QIfAbstractFeature::interfaceName() const

返回该功能正在实现的对象名称。

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

另请参阅 acceptServiceObject。

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

从后端更新 error 和 message。

实现新功能时使用此槽位来报告通用的错误。

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

使用 message 设置 error。

发出 errorChanged() 信号。

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

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

执行自动发现尝试。

功能将尝试定位实现所需接口的单个服务对象。

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

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

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

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