Класс QWebChannel

Предоставляет QObjects удалённым HTML-клиентам. Подробнее...

Этот класс был представлен в Qt 5.4.

• Список всех членов, включая унаследованные

Свойства

• blockUpdates : bool

Открытые функции

Открытые слоты

Сигналы

Подробное описание

Класс QWebChannel устраняет разрыв между приложениями на C++ и HTML/JavaScript-приложениями. Публикуя объект, производный от QObject, в QWebChannel и используя qwebchannel.js на стороне HTML, можно прозрачно обращаться к свойствам и открытым слотам и методам QObject. Не требуется ручное передача сообщений и сериализация данных, обновления свойств и эмиссия сигналов на стороне C++ автоматически передаются потенциально удалённым HTML-клиентам. На стороне клиента для каждого опубликованного C++ QObject будет создан JavaScript-объект. Он отображает API объекта C++, и поэтому его интуитивно удобно использовать.

API QWebChannel на C++ позволяет общаться с любым HTML-клиентом, который может работать на локальном или даже удалённом компьютере. Единственное ограничение состоит в том, что HTML-клиент поддерживает JavaScript-функции, используемые в qwebchannel.js. Таким образом, можно взаимодействовать практически с любым современным HTML-браузером или автономным JavaScript-런타임, таким как node.js.

Также существует декларативный API WebChannel.

См. также Пример Qt WebChannel Standalone и API JavaScript.

Документация функций-членов

QWebChannel::QWebChannel(QObject *parent = Q_NULLPTR)

Конструирует объект QWebChannel с заданным parent.

Обратите внимание, что QWebChannel полностью функционален только после подключения к QWebChannelAbstractTransport. HTML-клиенты также должны быть должным образом настроены с помощью qwebchannel.js.

[slot] void QWebChannel::connectTo(QWebChannelAbstractTransport *transport)

Подключает QWebChannel к заданному объекту transport.

Объект транспортного средства затем обрабатывает общение между приложением на C++ и удалённым HTML-клиентом.

См. также QWebChannelAbstractTransport и QWebChannel::disconnectFrom().

[slot] void QWebChannel::disconnectFrom(QWebChannelAbstractTransport *transport)

Отключает QWebChannel от объекта transport.

См. также QWebChannel::connectTo().

[virtual] QWebChannel::~QWebChannel()

Уничтожает QWebChannel.

void QWebChannel::deregisterObject(QObject *object)

Дерегистрирует заданный объект object из QWebChannel.

Удалённые клиенты получат сигнал destroyed для данного объекта.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

См. также QWebChannel::registerObjects(), QWebChannel::registerObject() и QWebChannel::registeredObjects().

void QWebChannel::registerObject(const QString &id, QObject *object)

Регистрирует отдельный объект в QWebChannel.

Свойства, сигналы и открытые методы объекта object публикуются для удалённых клиентов. Там затем создаётся объект с идентификатором id.

Примечание: Текущее ограничение состоит в том, что объекты должны быть зарегистрированы до инициализации любого клиента.

Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.

См. также QWebChannel::registerObjects(), QWebChannel::deregisterObject() и QWebChannel::registeredObjects().

void QWebChannel::registerObjects(const QHash<QString, QObject *> &objects)

Регистрирует группу объектов в QWebChannel.

Свойства, сигналы и открытые вызываемые методы объектов публикуются для удалённых клиентов. Там затем создаётся объект с идентификатором, используемым в качестве ключа в карте objects.

Примечание: Текущее ограничение состоит в том, что объекты должны быть зарегистрированы до инициализации любого клиента.

См. также QWebChannel::registerObject(), QWebChannel::deregisterObject() и QWebChannel::registeredObjects().

QHash<QString, QObject *> QWebChannel::registeredObjects() const

Возвращает карту зарегистрированных объектов, опубликованных для удалённых клиентов.

См. также QWebChannel::registerObjects(), QWebChannel::registerObject() и QWebChannel::deregisterObject().