QRemoteObjectHost Class

Ein (Host-)Knoten in einem Qt Remote Objects Netzwerk. Mehr...

Kopfzeile: #include <QRemoteObjectHost>
CMake: find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects)
qmake: QT += remoteobjects
In QML: Host
Vererbt: QRemoteObjectHostBase

Eigenschaften

Öffentliche Funktionen

QRemoteObjectHost(QObject *parent = nullptr)
QRemoteObjectHost(const QUrl &address, QObject *parent)
QRemoteObjectHost(const QUrl &address, const QUrl &registryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr)

Reimplementierte öffentliche Funktionen

virtual QUrl hostUrl() const override
virtual bool setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override

Signale

Statische öffentliche Mitglieder

(since 6.7) void setLocalServerOptions(QLocalServer::SocketOptions options)

Detaillierte Beschreibung

Die Klasse QRemoteObjectHost bietet einen Einstiegspunkt in ein QtRemoteObjects Netzwerk. Ein Netzwerk kann so einfach wie zwei Knoten sein, oder eine beliebig komplexe Menge von Prozessen und Geräten.

QRemoteObjectHosts haben die gleichen Fähigkeiten wie QRemoteObjectNodes, aber sie können auch mit Quellobjekten im Netzwerk verbunden werden und diese gemeinsam nutzen.

Knoten können sich direkt über connectToNode miteinander verbinden, oder sie können zur Vereinfachung der Verbindungen die QRemoteObjectRegistry verwenden.

Die QRemoteObjectRegistry ist ein spezielles Replikat, das jedem Knoten zur Verfügung steht, der eine Verbindung zur Registry Url herstellt. Sie weiß, wie man sich mit jedem QRemoteObjectSource-Objekt im Netzwerk verbindet.

Siehe auch QRemoteObjectNode und QRemoteObjectRegistryHost.

Dokumentation der Eigenschaften

hostUrl : QUrl

Diese Eigenschaft enthält die Host-Adresse für den Knoten.

Dies ist die Adresse, an der sich die von diesem Knoten remoteten Quellobjekte befinden werden.

Zugriffsfunktionen:

virtual QUrl hostUrl() const override
virtual bool setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override

Benachrichtigungssignal:

void hostUrlChanged()

Member Function Dokumentation

QRemoteObjectHost::QRemoteObjectHost(QObject *parent = nullptr)

Konstruiert einen neuen QRemoteObjectHost Node (d.h. einen Node, der es unterstützt, Source-Objekte im QtRO-Netzwerk darzustellen) mit dem angegebenen parent. Dieser Konstruktor ist speziell für die Unterstützung von QML in der Zukunft gedacht, da er erst nach dem Aufruf von setHostUrl für eine Verbindung zur Verfügung stehen wird.

Siehe auch setHostUrl() und setRegistryUrl().

QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, QObject *parent)

Konstruiert einen neuen QRemoteObjectHost-Knoten (d.h. einen Knoten, der die Darstellung von Quellobjekten im QtRO-Netzwerk unterstützt) mit einer URL von address und dem angegebenen parent. Diese Überladung wird als Bequemlichkeit für die Angabe eines QObject Elternteils ohne Angabe einer Registry-Adresse bereitgestellt.

Siehe auch setHostUrl() und setRegistryUrl().

QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, const QUrl &registryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr)

Konstruiert einen neuen QRemoteObjectHost-Knoten (d.h. einen Knoten, der Quellobjekte im QtRO-Netzwerk anzeigen kann) mit der Adresse address. Falls gesetzt, wird registryAddress verwendet, um sich mit QRemoteObjectRegistry an der angegebenen Adresse zu verbinden. Der Parameter allowedSchemas wird nur benötigt (und sollte auf AllowExternalRegistration gesetzt werden), wenn das Schema der URL von der Registry als externes Schema verwendet werden soll.

Siehe auch setHostUrl() und setRegistryUrl().

[override virtual] QUrl QRemoteObjectHost::hostUrl() const

Gibt die Host-Adresse für QRemoteObjectNode als QUrl zurück. Wenn der Knoten kein Host-Knoten ist, wird ein leeres QUrl zurückgegeben.

Hinweis: Getter-Funktion für die Eigenschaft hostUrl.

Siehe auch setHostUrl().

[override virtual] bool QRemoteObjectHost::setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly)

Setzt die hostAddress für einen Host QRemoteObjectNode.

Gibt true zurück, wenn die Host-Adresse gesetzt ist, andernfalls false.

Der Parameter allowedSchemas wird nur benötigt (und sollte auf AllowExternalRegistration gesetzt werden), wenn das Schema der Url von der Registrierung als externes Schema verwendet werden soll.

Hinweis: Setter-Funktion für die Eigenschaft hostUrl.

Siehe auch hostUrl().

[static, since 6.7] void QRemoteObjectHost::setLocalServerOptions(QLocalServer::SocketOptions options)

Setzt die Socket-Optionen für QLocalServer Backends auf options.

Sie muss gesetzt werden, bevor das QRemoteObjectHost Objekt mit dem Lauschen beginnt. Es hat keine Auswirkungen auf bereits lauschende QRemoteObjectHost Objekte oder QRemoteObjectHost Objekte, die andere Backends als QLocalServer verwenden. QRemoteObjectHost Objekte beginnen während der Konstruktion zu lauschen, wenn das Adressargument nicht leer ist, andernfalls, wenn die Adresse über setHostUrl() gesetzt wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch setHostUrl() und QRemoteObjectHost().

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.