QRemoteObjectHost Class
Qt Remote Objects 网络上的一个（主机）节点。更多内容...
| 标题： | #include <QRemoteObjectHost> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS RemoteObjects) target_link_libraries(mytarget PRIVATE Qt6::RemoteObjects) |
| qmake： | QT += remoteobjects |
| 在 QML 中： | Host |
| 继承自： | QRemoteObjectHostBase |
属性
- hostUrl : QUrl
公共函数
| QRemoteObjectHost(QObject *parent = nullptr) | |
| QRemoteObjectHost(const QUrl &address, QObject *parent) | |
| QRemoteObjectHost(const QUrl &address, const QUrl ®istryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr) |
重新实现的公共函数
| virtual QUrl | hostUrl() const override |
| virtual bool | setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override |
信号
| void | hostUrlChanged() |
静态公共成员
(since 6.7) void | setLocalServerOptions(QLocalServer::SocketOptions options) |
详细说明
QRemoteObjectHost 类为QtRemoteObjects 网络提供了一个入口点。一个网络可以简单到只有两个节点，也可以是任意复杂的进程和设备集合。
QRemoteObjectHost 具有与 QRemoteObjectNode 相同的功能，但它们还可以连接到网络，并在网络上共享源对象。
节点可以使用connectToNode 直接相互连接，也可以使用QRemoteObjectRegistry 来简化连接。
QRemoteObjectRegistry 是一个特殊的副本，可供连接到注册表 URL 的每个节点使用。它知道如何连接到网络上的每个 QRemoteObjectSource 对象。
另请参阅 QRemoteObjectNode 和QRemoteObjectRegistryHost 。
属性文档
hostUrl : QUrl
该属性存储节点的宿主地址。
这是由该节点远程调用的源对象所驻留的地址。
访问函数：
| virtual QUrl | hostUrl() const override |
| virtual bool | setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly) override |
通知器信号：
| void | hostUrlChanged() |
成员函数文档
QRemoteObjectHost::QRemoteObjectHost(QObject *parent = nullptr)
使用给定的parent 构建一个新的QRemoteObjectHost节点（即一个支持在QtRO网络上暴露Source对象的节点）。该构造函数旨在专门为未来支持QML而设计，因为在调用setHostUrl 之前，该节点无法被连接。
另请参阅 setHostUrl() 和setRegistryUrl()。
QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, QObject *parent)
创建一个新的 QRemoteObjectHost 节点（即一个支持在 QtRO 网络上暴露源对象的节点），其 URL 为address ，并使用给定的parent 。提供此重载是为了方便指定QObject 父节点，而无需提供注册表地址。
另请参阅 setHostUrl() 和setRegistryUrl()。
QRemoteObjectHost::QRemoteObjectHost(const QUrl &address, const QUrl ®istryAddress = QUrl(), QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly, QObject *parent = nullptr)
创建一个新的 QRemoteObjectHost 节点（即一个支持在 QtRO 网络上暴露源对象的节点），其地址为address 。如果设置了该参数，将使用registryAddress 连接到指定地址处的QRemoteObjectRegistry 。 仅当注册表需将该 URL 的架构用作外部架构时，才需要设置allowedSchemas 参数（且应将其设为AllowExternalRegistration ）。
另请参阅 setHostUrl() 和setRegistryUrl()。
[override virtual] QUrl QRemoteObjectHost::hostUrl() const
返回QRemoteObjectNode 的主机地址，格式为QUrl 。如果该Node不是Host节点，则返回一个空的QUrl 。
注意： 这是属性 hostUrl 的获取 函数。
另请参阅 setHostUrl()。
[override virtual] bool QRemoteObjectHost::setHostUrl(const QUrl &hostAddress, QRemoteObjectHostBase::AllowedSchemas allowedSchemas = BuiltInSchemasOnly)
设置主机QRemoteObjectNode 的hostAddress 。
如果已设置主机地址，则返回true ；否则返回false 。
仅当注册表需将该 URL 的架构用作外部架构时，才需要allowedSchemas 参数（且应将其设置为AllowExternalRegistration ）。
注意： 属性hostUrl 的设置 函数。
另请参阅 hostUrl()。
[static, since 6.7] void QRemoteObjectHost::setLocalServerOptions(QLocalServer::SocketOptions options)
将QLocalServer 后端的套接字选项设置为options 。
必须在QRemoteObjectHost 对象开始监听之前设置此选项。对于已经处于监听状态的QRemoteObjectHost 对象，或者使用与QLocalServer 不同的后端的QRemoteObjectHost 对象，此设置不会产生影响。QRemoteObjectHost 对象在构造时若address参数不为空，则开始监听；否则，当通过setHostUrl()设置address时才开始监听。
该函数在 Qt 6.7 中引入。
另请参阅 setHostUrl() 和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.
