QOpcUaGenericStructHandler Class

QOpcUaGenericStructHandler handler(opcuaClient);
handler.initialize();

QObject::connect(&handler, &QOpcUaGenericStructHandler::initializedChanged, [opcuaClient, &handler](bool initialized) {
    if (!initialized)
        return;

    auto node = opcuaClient->node("ns=4;i=3003"); // A custom struct test node in the open62541-testserver
    node->readValueAttribute();

    QObject::connect(node, &QOpcUaNode::attributeRead, [node, &handler](QOpcUa::NodeAttributes attr) {
        if (!attr.testFlag(QOpcUa::NodeAttribute::Value) || node->valueAttributeError() != QOpcUa::UaStatusCode::Good)
            return;

        auto extObj = node->valueAttribute().value<QOpcUaExtensionObject>();
        qDebug() << "Got object of type" << handler.typeNameForBinaryEncodingId(extObj.encodingTypeId());

        const auto result = handler.decode(extObj);

        if (!result)
            return;

        qDebug() << *result;
    });
});

QOpcUaGenericStructHandler handler(opcuaClient);
handler.initialize();

QObject::connect(&handler, &QOpcUaGenericStructHandler::initializedChanged, [opcuaClient, &handler](bool initialized) {
    if (!initialized)
        return;

    QOpcUaGenericStructValue value = handler.createGenericStructValueForTypeId("ns=4;i=3006");
    value.fieldsRef()["MandatoryMember"] = 23.0;
    value.fieldsRef()["OptionalMember"] = 42.0;

    const auto ext = handler.encode(value);

    if (!ext)
        return;

    // Use the extension object to write a node's value attribute, in a method parameter, etc...
});

メンバ関数 ドキュメント

[explicit] QOpcUaGenericStructHandler::QOpcUaGenericStructHandler(QOpcUaClient *client, QObject *parent = nullptr)

client の汎用構造体ハンドラを構築します。

bool QOpcUaGenericStructHandler::addCustomEnumDefinition(const QOpcUaEnumDefinition &definition, const QString &typeId, const QString &name, QOpcUa::IsAbstract isAbstract = QOpcUa::IsAbstract::NotAbstract)

カスタム enum 定義definition を既知の型に追加します。これは、サーバーが StructureDefinition を公開していないカスタム構造体をサポートするために使用できます。パラメータdefinition 、typeId 、name は、適切なデコードとエンコードに必要です。isAbstract がセットされていると、その型はエンコードもデコードもできません。

列挙型の定義が正常に追加された場合はtrue を返します。

bool QOpcUaGenericStructHandler::addCustomStructureDefinition(const QOpcUaStructureDefinition &definition, const QString &typeId, const QString &name, QOpcUa::IsAbstract isAbstract = QOpcUa::IsAbstract::NotAbstract)

カスタム構造体定義definition を既知の型に追加します。これは、サーバーがStructureDefinitionを公開していないカスタム構造をサポートするために使用できます。パラメータdefinition 、typeId 、name は、適切なデコードとエンコードに必要です。isAbstract がセットされている場合、その型をエンコードおよびデコードすることはできません。

構造体定義が正常に追加された場合はtrue を返す。

QOpcUaGenericStructValue QOpcUaGenericStructHandler::createGenericStructValueForTypeId(const QString &typeId)

typeId に対応する構造体定義、型 ID、および型名があらかじめ入力された汎用構造体値を返します。すべての必須フィールドには、無効なプレースホルダQVariant が挿入されます。

QOpcUaGenericStructHandler::DataTypeKind QOpcUaGenericStructHandler::dataTypeKindForTypeId(const QString &id) const

型ノード IDid のデータ型 kind を返します。

std::optional<QOpcUaGenericStructValue> QOpcUaGenericStructHandler::decode(const QOpcUaExtensionObject &extensionObject) const

extensionObject QOpcUaGenericStructValueデコーダが失敗すると、std::nullopt が返されます。

std::optional<QOpcUaExtensionObject> QOpcUaGenericStructHandler::encode(const QOpcUaGenericStructValue &value)

QOpcUaExtensionObject としてエンコードされたvalue を返し、値がエンコードできなかった場合はstd::nullopt を返す。

QOpcUaEnumDefinition QOpcUaGenericStructHandler::enumDefinitionForTypeId(const QString &id) const

型ノード IDid のQOpcUaEnumDefinition を返す。ノード ID が不明な場合、または列挙型に属さない場合は、既定の構築値が返されます。

bool QOpcUaGenericStructHandler::initialize()

データ型階層の走査を開始します。成功または失敗はinitializedChanged シグナルで報告されます。

操作を開始できない場合はfalse を返す。

[since 6.7] bool QOpcUaGenericStructHandler::initialized() const

ジェネリック構造体ハンドラが初期化されている場合はtrue を返します。

この関数はQt 6.7で導入されました。

[signal] void QOpcUaGenericStructHandler::initializedChanged(bool initialized)

このシグナルは、初期化プロセスが終了したときに発行されます。initialized は、初期化が成功したかどうかを示します。

bool QOpcUaGenericStructHandler::isAbstractTypeId(const QString &id) const

id で記述されたデータ型が抽象の場合、true を返します。

QOpcUaStructureDefinition QOpcUaGenericStructHandler::structureDefinitionForBinaryEncodingId(const QString &id) const

バイナリ符号化ノード IDid のQOpcUaStructureDefinition を返します。ノード ID が不明な場合、または構造体タイプに属さない場合は、デフォルトの構築された値が返されます。

QOpcUaStructureDefinition QOpcUaGenericStructHandler::structureDefinitionForTypeId(const QString &id) const

型ノード IDid に対するQOpcUaStructureDefinition を返します。ノード ID が不明な場合、または struct 型に属さない場合、デフォルトの構築済み値が返されます。

QString QOpcUaGenericStructHandler::typeIdForBinaryEncodingId(const QString &id) const

バイナリ符号化 idid に関連付けられた型ノード ID を返します。

QString QOpcUaGenericStructHandler::typeNameForBinaryEncodingId(const QString &id) const

バイナリ符号化ノード IDid に属する型名を返します。ノード ID が不明な場合、または構造体タイプに属さない場合は、空の文字列が返されます。

QString QOpcUaGenericStructHandler::typeNameForTypeId(const QString &id) const

型ノード IDid で識別されるデータ型ノードに属する型名を返す。ノード ID が不明な場合は、空文字列が返されます。