QOpcUaMonitoringParameters Class

QOpcUaMonitoringParameters p(100); // Set a publishing interval of 100ms and share the subscription.
node->enableMonitoring(QOpcUa::NodeAttribute::Value, p);

QOpcUaMonitoringParameters p(100, QOpcUaMonitoringParameters::SubscriptionType::Exclusive); // Create a new subscription

quint32 subscriptionId = node->monitoringStatus(QOpcUa::NodeAttribute::Value).subscriptionId();
QOpcUaMonitoringParameters p(100, QOpcUaMonitoringParameters::SubscriptionType::Shared, subscriptionId); // Add the monitored item to this subscription

メンバー関数のドキュメント

QOpcUaMonitoringParameters::QOpcUaMonitoringParameters()

QOpcUaMonitoringParameters のデフォルトコンストラクタ。

QOpcUaMonitoringParameters::QOpcUaMonitoringParameters(double publishingInterval, QOpcUaMonitoringParameters::SubscriptionType shared = SubscriptionType::Shared, quint32 subscriptionId = 0)

これは、Qt OPC UA のユーザーにとって、ほとんどのユースケースをカバーするコンストラクタです。publishingInterval は必須ですが、shared およびsubscriptionId はオプションです。

QOpcUaMonitoringParameters::QOpcUaMonitoringParameters(const QOpcUaMonitoringParameters &other)

other の値から、QOpcuaMonitoringParametersオブジェクトを生成します。

[noexcept] QOpcUaMonitoringParameters::~QOpcUaMonitoringParameters()

QOpcUaMonitoringParameters のデストラクタ。

void QOpcUaMonitoringParameters::clearFilter()

監視パラメータから現在のフィルタを削除します。

filter() およびsetFilter()も参照してください 。

void QOpcUaMonitoringParameters::clearFilterResult()

監視パラメータから現在のフィルタ結果を削除します。

filterResult() およびsetFilterResult()も参照してください 。

bool QOpcUaMonitoringParameters::discardOldest() const

監視対象項目の「discardOldest」設定を返します。

setDiscardOldest()も参照してください 。

[since 6.7] QHash<quint32, QOpcUa::UaStatusCode> QOpcUaMonitoringParameters::failedTriggeredItemsStatus() const

setTriggeredItemIds() によってトリガーされた項目のうち、正常に追加できなかったすべての項目のステータスコードを返します。

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

setFailedTriggeredItemsStatus()も参照してください 。

QVariant QOpcUaMonitoringParameters::filter() const

現在のフィルターを返します。

setFilter()も参照してください 。

QVariant QOpcUaMonitoringParameters::filterResult() const

フィルタリングの結果を返します。

属性監視の場合、この値は空になります。イベント監視の場合、サーバーがフィルタでエラーを検出しなかった場合、フィルタ結果は空になることがあります。

setFilterResult()も参照してください 。

QString QOpcUaMonitoringParameters::indexRange() const

監視対象項目のインデックス範囲を返します。

setIndexRange()も参照してください 。

bool QOpcUaMonitoringParameters::isPublishingEnabled() const

サブスクリプションの公開モードを返します。

quint32 QOpcUaMonitoringParameters::lifetimeCount() const

サブスクリプションの有効期間の回数を返します。

setLifetimeCount()も参照してください 。

quint32 QOpcUaMonitoringParameters::maxKeepAliveCount() const

サブスクリプションの最大キープアライブ回数を返します。

setMaxKeepAliveCount()も参照してください 。

quint32 QOpcUaMonitoringParameters::maxNotificationsPerPublish() const

サブスクリプションの「publish」値ごとの通知の上限数を返します。

setMaxNotificationsPerPublish()も参照してください 。

quint32 QOpcUaMonitoringParameters::monitoredItemId() const

サーバーによって割り当てられた監視対象項目のIDを返します。監視対象項目のIDが0の場合、監視対象項目の作成に失敗したことを意味します。

setMonitoredItemId()も参照してください 。

QOpcUaMonitoringParameters::MonitoringMode QOpcUaMonitoringParameters::monitoringMode() const

監視対象項目の監視モードを返します。

setMonitoringMode()も参照してください 。

quint8 QOpcUaMonitoringParameters::priority() const

監視対象の項目に使用されているサブスクリプションの優先度を返します。

setPriority()も参照してください 。

double QOpcUaMonitoringParameters::publishingInterval() const

サブスクリプションの発行間隔を返します。間隔はミリ秒単位で表されます。

setPublishingInterval()も参照してください 。

quint32 QOpcUaMonitoringParameters::queueSize() const

監視対象項目のキューサイズを返します。

setQueueSize()も参照してください 。

double QOpcUaMonitoringParameters::samplingInterval() const

監視対象項目の修正後のサンプリング間隔を返します。間隔はミリ秒単位で表されます。

setSamplingInterval()も参照してください 。

void QOpcUaMonitoringParameters::setDiscardOldest(bool discardOldest)

監視対象項目の「discardOldest 」設定として、「discardOldest 」を設定します。

「discardOldest()」も参照してください 。

[since 6.7] void QOpcUaMonitoringParameters::setFailedTriggeredItemsStatus(const QHash<quint32, QOpcUa::UaStatusCode> &status)

status に正常に追加できなかった、トリガーされたすべての項目のステータスコードを設定します。クライアント側でこの値を設定しても、何の効果もありません。

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

failedTriggeredItemsStatus()も参照してください 。

void QOpcUaMonitoringParameters::setFilter(const QOpcUaMonitoringParameters::DataChangeFilter &filter)

監視対象項目のフィルタとして、DataChangeFilter filter を設定します。別のデータ変更フィルタやイベントフィルタが存在する場合、それらは置き換えられます。

サーバーがこのフィルタを受け入れない場合、QOpcUaNode::enableMonitoring() リクエストの完了後にステータスコードによってその旨が示されます。

filter()も参照してください 。

void QOpcUaMonitoringParameters::setFilter(const QOpcUaMonitoringParameters::EventFilter &eventFilter)

監視対象アイテムのフィルターとして「eventFilter 」を指定してください。別のイベントフィルターやデータ変更フィルターが設定されている場合、それらは置き換えられます。サーバーがこのフィルターを受け入れない場合は、QOpcUaNode::enableMonitoring() リクエストの完了後に、ステータスコードおよびイベントフィルターの結果によってその旨が示されます。

filter()も参照してください 。

void QOpcUaMonitoringParameters::setFilterResult(const QOpcUaEventFilterResult &eventFilterResult)

イベントフィルタの結果を「eventFilterResult 」に設定します。

このメソッドはバックエンドでのみ使用する必要があります。ユーザーがイベントフィルタの結果を設定しても、何の効果もありません。

filterResult()も参照してください 。

void QOpcUaMonitoringParameters::setIndexRange(const QString &indexRange)

監視対象項目のインデックス範囲として、indexRange を指定します。インデックス範囲の文字列に関する詳細については、QOpcUaNode::readAttributeRange() を参照してください。

indexRange()も参照してください 。

void QOpcUaMonitoringParameters::setLifetimeCount(quint32 lifetimeCount)

サブスクリプションの有効期間として「lifetimeCount 」を指定してください。

lifetimeCount()も参照してください 。

void QOpcUaMonitoringParameters::setMaxKeepAliveCount(quint32 maxKeepAliveCount)

サブスクリプションの最大キープアライブ回数をmaxKeepAliveCount に設定してください。

maxKeepAliveCount()も参照してください 。

void QOpcUaMonitoringParameters::setMaxNotificationsPerPublish(quint32 maxNotificationsPerPublish)

maxNotificationsPerPublish を、そのサブスクリプションの「1回のパブリッシュあたりの最大通知数」として設定します。

「maxNotificationsPerPublish()」も参照してください 。

void QOpcUaMonitoringParameters::setMonitoredItemId(quint32 monitoredItemId)

監視対象項目のIDをmonitoredItemId に設定します。

クライアント側でこの値を設定しても、何の影響もありません。

monitoredItemId()も参照してください 。

void QOpcUaMonitoringParameters::setMonitoringMode(QOpcUaMonitoringParameters::MonitoringMode monitoringMode)

監視対象項目の監視モードとして「monitoringMode 」を設定します。

「monitoringMode()」も参照してください 。

void QOpcUaMonitoringParameters::setPriority(quint8 priority)

priority をサブスクリプションの優先順位として設定します。

「priority()」も参照してください 。

void QOpcUaMonitoringParameters::setPublishingEnabled(bool publishingEnabled)

サブスクリプションの公開モードとして「publishingEnabled 」を設定します。

「isPublishingEnabled()」も参照してください 。

void QOpcUaMonitoringParameters::setPublishingInterval(double publishingInterval)

サブスクリプションの配信間隔として、publishingInterval を指定します。間隔はミリ秒単位で表されます。

publishingInterval()も参照してください 。

void QOpcUaMonitoringParameters::setQueueSize(quint32 queueSize)

監視対象のアイテムのキューサイズとして、queueSize を指定してください。

queueSize()も参照してください 。

void QOpcUaMonitoringParameters::setSamplingInterval(double samplingInterval)

監視対象項目のサンプリング間隔として、samplingInterval を指定します。間隔はミリ秒単位で指定します。

samplingInterval()も参照してください 。

void QOpcUaMonitoringParameters::setStatusCode(QOpcUa::UaStatusCode statusCode)

ステータスコードをstatusCode に設定します。

statusCode()も参照してください 。

void QOpcUaMonitoringParameters::setSubscriptionId(quint32 subscriptionId)

subscriptionId を使用して、既知のサブスクリプション上に監視対象項目を作成するようリクエストします。

「subscriptionId()」も参照してください 。

void QOpcUaMonitoringParameters::setSubscriptionType(QOpcUaMonitoringParameters::SubscriptionType shared)

サブスクリプションのサブスクリプションタイプとして「shared 」を指定してください。

subscriptionType()も参照してください 。

[since 6.7] void QOpcUaMonitoringParameters::setTriggeredItemIds(const QSet<quint32> &ids)

OPC UA 1.05 の 5.12.1.6 に記載されているとおり、ids 内のすべての監視対象項目にトリガーリンクを追加します。

ids 内の値は、同じサブスクリプション上の他の監視対象項目のIDでなければなりません。これらの項目の監視モードが「サンプリング」に設定されている場合、この監視機能がデータ変更を検出したたびに、そのデータ変更通知がクライアントに配信されます。

追加できなかったIDは、監視ステータスには含まれませんが、代わりにfailedTriggeredItemsStatus()に表示されます。

この設定を空のセットに変更すると、すべてのトリガーリンクが削除されます。

この機能は Qt 6.7 で導入されました。

triggeredItemIds()も参照してください 。

QOpcUa::UaStatusCode QOpcUaMonitoringParameters::statusCode() const

監視対象項目の作成に関するステータスコードを返します。

setStatusCode()も参照してください 。

quint32 QOpcUaMonitoringParameters::subscriptionId() const

割り当てられたサブスクリプションIDを返します。

setSubscriptionId()も参照してください 。

QOpcUaMonitoringParameters::SubscriptionType QOpcUaMonitoringParameters::subscriptionType() const

サブスクリプションのタイプを返します。

setSubscriptionType()も参照してください 。

[since 6.7] QSet<quint32> QOpcUaMonitoringParameters::triggeredItemIds() const

この監視対象アイテムによってトリガーされた監視対象アイテムのIDを返します。

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

setTriggeredItemIds()も参照してください 。

QOpcUaMonitoringParameters &QOpcUaMonitoringParameters::operator=(const QOpcUaMonitoringParameters &other)

このオブジェクトにother の値を割り当てます。