Qt：QWebChannel

0、说明

QWebChannel的作用是将QObject展示给的HTML客户。

QWebChannel是连接C++应用和HTML/JS应用的桥梁。通过把一个QObject传入QWebChannel并在网页端使用qwebchannel.js，我们就可以方便、透明地访问该QObject的属性、方法和槽。在此期间，不需要人为传递控制和序列化信息，信号、属性就会自动传递到HTML用户端。

在HTML用户端，每个QObject都会生成一个对应的js object。这个js obj的各项行为可以认为是C++相关对象的镜像，可以直观地反映出来。

QWebChannel使得C++应用与HTML客户间的通话简单化，不管这个客户是在本地还是异地。唯一的限制是，HTML客户需要支持qwebchannel.js中所说的JS特性。只有这样，应用程序才能正常地与任何现代HTML浏览器或者运行时JS（如node.js）交互。

例子

Qt WebChannel Standalone Example

JavaScript API.

1、模块和加载项

Header	#include<QWebChannel>
qmake	QT += webchannel
Since	Qt 5.4
Inherits	QObject

2、属性

类型	属性	说明	相关方法	信号
bool	blockUpdates	设置为true时，QObject的变化与更新将会被阻塞，用户也不会知道这些变化	blockUpdates() setBlockUpdates(bool block)	blockUpdatesChanged(bool block)

3、构造

QWebChannel(QObject *parent = Q_NULLPTR)

用给定的parent构造一个QWebChannel对象。

一个QWebChannel只有在它连接到一个QWebChannelAbstractTransport时，才能对它进行各种操作。HTML客户同时也需要合理设置qwebchannel.js。

4、方法

返回值类型	方法	说明
bool	blockUpdates()	属性blockUpdate的getter
void	deregisterObject( QObject * object )	取消给定object和QWebChannel间的绑定 异地的客户将会受到一个destroyed信号
void	registerObject( QString id , QObject * object )	将一个object与QWebChannel进行绑定 object的属性、信号、方法会被传递给异地的客户。之后，一个有着指定id的object将被构建 需要注意的是：1、objects必须在所有客户初始化之前被绑定；2、该方法可以通过meta-system系统和QML进行调用
void	registerObjects( QHash<QString,QObject *> objects )	将一组objects与QWebChannel进行绑定。绑定完成后，每个object的id将被QHash中的每一项Key-Value指定。
QHash<QString,QObject *>	registerObjects()	返回已绑定的object和它的id的映射
void	setBlockUpdates( bool block )	属性blockUpdate的setter

5、信号

void

blockUpdatesChanged(bool block)

6、槽

void	connectTo( QWebChannelAbstractTransport * transport)	把当前QWebChannel连接到给定的transport对象 之后这个transport对象就维持了C++应用和HTML用户间的连接
void	disconnectFrom(QWebChannelAbstractTransport * transport)	取消当前QWebChannel和给定transport对象的连接