Класс QWebChannel
Предоставляет доступ к QObjects удалённым HTML-клиентам. Подробнее...
| Заголовок: | #include <QWebChannel> |
| qmake: | QT += webchannel |
| С версии: | Qt 5.4 |
| Наследует: | QObject |
Свойства
- blockUpdates : bool
- 1 свойство унаследовано от QObject
Открытые функции
| QWebChannel(QObject *parent = Q_NULLPTR) | |
| ~QWebChannel() | |
| bool | blockUpdates() const |
| void | deregisterObject(QObject *object) |
| void | registerObject(const QString &id, QObject *object) |
| void | registerObjects(const QHash<QString, QObject *> &objects) |
| QHash<QString, QObject *> | registeredObjects() const |
| void | setBlockUpdates(bool block) |
- 32 открытые функции унаследованы от QObject
Открытые слоты
| void | connectTo(QWebChannelAbstractTransport *transport) |
| void | disconnectFrom(QWebChannelAbstractTransport *transport) |
- 1 открытый слот унаследован от QObject
Сигналы
| void | blockUpdatesChanged(bool block) |
- 2 сигнала унаследованы от QObject
Дополнительные наследуемые члены
Подробное описание
Предоставляет доступ к QObjects удалённым HTML-клиентам.
Класс QWebChannel заполняет пробел между приложениями на C++ и HTML/JavaScript приложениями. Публикуя объект, производный от QObject, в QWebChannel и используя qwebchannel.js со стороны HTML, можно прозрачно обращаться к свойствам и открытым слотам и методам QObject. Не требуется ручное передача сообщений и сериализация данных, обновления свойств и отправка сигналов со стороны C++ автоматически передаются потенциально удалённым HTML-клиентам. Со стороны клиента будет создан JavaScript-объект для любого опубликованного C++ QObject. Он отражает API C++-объекта и поэтому интуитивно понятен в использовании.
API QWebChannel на C++ позволяет общаться с любым HTML-клиентом, который может работать на локальном или даже удалённом компьютере. Единственное ограничение состоит в том, что HTML-клиент поддерживает JavaScript-функции, используемые qwebchannel.js. Таким образом, можно взаимодействовать практически с любым современным HTML-браузером или автономным JavaScript-интерпретатором, таким как node.js.
Также существует декларативный API WebChannel.
См. также Пример Qt WebChannel Standalone и JavaScript API.
Документация по свойствам
blockUpdates : bool
Если установлено в true, обновления блокируются, и удалённые клиенты не будут уведомлены об изменениях свойств.
Изменения записываются и отправляются клиентам, как только обновления снова разблокируются, установив это свойство в false. По умолчанию, обновления не заблокированы.
Функции доступа:
| bool | blockUpdates() const |
| void | setBlockUpdates(bool block) |
Сигнал уведомителя:
| void | blockUpdatesChanged(bool block) |
Документация по членам-функциям
QWebChannel::QWebChannel(QObject *parent = Q_NULLPTR)
Конструктор объекта QWebChannel с заданным parent.
Обратите внимание, что QWebChannel полностью готов к работе только после подключения к QWebChannelAbstractTransport. HTML-клиенты также должны быть должным образом настроены, используя qwebchannel.js.
QWebChannel::~QWebChannel()
Удаляет QWebChannel.
[slot] void QWebChannel::connectTo(QWebChannelAbstractTransport *transport)
Подключает QWebChannel к заданному объекту transport.
Объект transport обрабатывает общение между приложением C++ и удалённым HTML-клиентом.
См. также QWebChannelAbstractTransport и QWebChannel::disconnectFrom().
void QWebChannel::deregisterObject(QObject *object)
Отменяет регистрацию заданного объекта object из QWebChannel.
Удалённые клиенты получат сигнал destroyed для данного объекта.
См. также QWebChannel::registerObjects(), QWebChannel::registerObject() и QWebChannel::registeredObjects().
[slot] void QWebChannel::disconnectFrom(QWebChannelAbstractTransport *transport)
Отключает QWebChannel от объекта transport.
См. также QWebChannel::connectTo().
void QWebChannel::registerObject(const QString &id, QObject *object)
Регистрирует отдельный объект в QWebChannel.
Свойства, сигналы и открытые методы объекта object публикуются для удалённых клиентов. Там же создаётся объект с идентификатором id.
Примечание: В настоящее время существует ограничение, что объекты должны быть зарегистрированы до инициализации любого клиента.
См. также 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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qwebchannel.html