Sur cette page

QRemoteObjectHost Class

Un nœud (hôte) sur un réseau Qt Remote Objects. En savoir plus...

En-tête : #include <QRemoteObjectHost>
CMake : find_package(Qt6 REQUIRED COMPONENTS RemoteObjects)
target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects)
qmake : QT += remoteobjects
En QML : Host
Hérite de : QRemoteObjectHostBase

Propriétés

Fonctions publiques

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)

Fonctions publiques réimplémentées

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

Signaux

Membres publics statiques

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

Description détaillée

La classe QRemoteObjectHost fournit un point d'entrée vers un réseau QtRemoteObjects. Un réseau peut être aussi simple que deux nœuds, ou constituer un ensemble arbitrairement complexe de processus et de périphériques.

Les objets QRemoteObjectHost possèdent les mêmes capacités que les QRemoteObjectNode, mais ils peuvent également être connectés à des objets source sur le réseau et partager ces derniers.

Les nœuds peuvent se connecter directement les uns aux autres à l’aide de ` connectToNode`, ou utiliser ` QRemoteObjectRegistry ` pour simplifier les connexions.

L'objet « QRemoteObjectRegistry » est une réplique spéciale accessible à tous les nœuds qui se connectent à l'URL du registre. Il sait comment se connecter à chaque objet « QRemoteObjectSource » du réseau.

Voir également « QRemoteObjectNode » et « QRemoteObjectRegistryHost ».

Documentation sur les propriétés

hostUrl : QUrl

Cette propriété contient l'adresse hôte du nœud.

Il s'agit de l'adresse à laquelle résideront les objets sources gérés à distance par ce nœud.

Fonctions d'accès :

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

Signal de notification :

void hostUrlChanged()

Documentation des fonctions membres

QRemoteObjectHost::QRemoteObjectHost(QObject *parent = nullptr)

Crée un nouveau nœud QRemoteObjectHost (c'est-à-dire un nœud permettant d'exposer des objets Source sur le réseau QtRO) avec l'parent fournie. Ce constructeur est spécialement conçu pour prendre en charge QML à l'avenir, car il ne sera pas accessible tant que la méthode setHostUrl n'aura pas été appelée.

Voir également setHostUrl() et setRegistryUrl().

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

Crée un nouveau nœud `QRemoteObjectHost` (c'est-à-dire un nœud permettant d'exposer des objets `Source` sur le réseau QtRO) avec l'URL address et l'parent fournie. Cette surcharge est fournie pour faciliter la spécification d'un parent de type ` QObject ` sans avoir à fournir d'adresse de registre.

Voir également setHostUrl() et setRegistryUrl().

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

Crée un nouveau nœud QRemoteObjectHost (c'est-à-dire un nœud permettant d'exposer des objets Source sur le réseau QtRO) avec l'adresse address. S'il est défini, le paramètre registryAddress sera utilisé pour se connecter à l'QRemoteObjectRegistry à l'adresse fournie. Le paramètre ` allowedSchemas ` n’est nécessaire (et doit être défini sur ` AllowExternalRegistration`) que si le schéma de l’URL doit être utilisé comme schéma externe par le registre.

Voir également setHostUrl() et setRegistryUrl().

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

Renvoie l'adresse hôte de l'QRemoteObjectNode sous la forme d'un objet de type ` QUrl`. Si le nœud n'est pas un nœud hôte, renvoie un objet vide de type ` QUrl`.

Remarque : fonctiongetter pour la propriété hostUrl.

Voir aussi setHostUrl().

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

Définit l'adresse hostAddress pour un hôte QRemoteObjectNode.

Renvoie « true » si l'adresse de l'hôte est définie, sinon « false ».

Le paramètre « allowedSchemas » n’est nécessaire (et doit être défini sur « AllowExternalRegistration ») que si le schéma de l’URL doit être utilisé comme schéma externe par le registre.

Remarque : fonctionde définition pour la propriété hostUrl.

Voir également hostUrl().

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

Définit les options de socket pour les backends « QLocalServer » sur « options ».

Ce paramètre doit être défini avant que l’objet ` QRemoteObjectHost ` ne commence à écouter. Il n’a aucune incidence sur les objets ` QRemoteObjectHost ` déjà en écoute, ni sur les objets ` QRemoteObjectHost ` utilisant des backends différents de ` QLocalServer`. Les objets ` QRemoteObjectHost ` commencent à écouter lors de leur construction si l’argument `address` n’est pas vide ; sinon, ils commencent à écouter lorsque l’adresse est définie via ` setHostUrl()`.

Cette fonction a été introduite dans Qt 6.7.

Voir également setHostUrl() et QRemoteObjectHost().

© 2026 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.