Spec-Zone.ru › Qt 5.6

Класс 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)
  • 31 открытая функция унаследована от QObject

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

void connectTo(QWebChannelAbstractTransport *transport)
void disconnectFrom(QWebChannelAbstractTransport *transport)
  • 1 открытый слот унаследован от QObject

Сигналы

void blockUpdatesChanged(bool block)
  • 2 сигнала унаследованы от QObject

Дополнительные унаследованные члены

  • 11 статических открытых членов унаследованы от QObject
  • 9 защищённых функций унаследованы от QObject

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

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

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

API C++ QWebChannel позволяет взаимодействовать с любым 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.

Объект транспортного средства затем обрабатывает связь между приложением на 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/archives/qt-5.6/qwebchannel.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API