QWebChannel Class
QObject를 원격 HTML 클라이언트에 노출합니다. 더 보기...
| Header: | #include <QWebChannel> |
| qmake: | QT += webchannel |
| Inherits: | QObject |
속성
- blockUpdates : bool
- propertyUpdateInterval : int
공개 함수
| QWebChannel(QObject *parent = nullptr) | |
| virtual | ~QWebChannel() |
| QBindable<bool> | bindableBlockUpdates() |
| QBindable<int> | bindablePropertyUpdateInterval() |
| bool | blockUpdates() const |
| void | deregisterObject(QObject *object) |
| int | propertyUpdateInterval() const |
| void | registerObject(const QString &id, QObject *object) |
| void | registerObjects(const QHash<QString, QObject *> &objects) |
| QHash<QString, QObject *> | registeredObjects() const |
| void | setBlockUpdates(bool block) |
| void | setPropertyUpdateInterval(int ms) |
공개 슬롯
| void | connectTo(QWebChannelAbstractTransport *transport) |
| void | disconnectFrom(QWebChannelAbstractTransport *transport) |
신호
| void | blockUpdatesChanged(bool block) |
상세 설명
QWebChannel은 C++ 애플리케이션과 HTML/JavaScript 애플리케이션 간의 간극을 메워줍니다. ` QObject `에서 파생된 객체를 QWebChannel에 게시하고 HTML 측에서 ` qwebchannel.js `를 사용하면, ` QObject`의 속성, 공개 슬롯 및 메서드에 투명하게 접근할 수 있습니다. 수동으로 메시지를 전달하거나 데이터를 직렬화할 필요가 없으며, C++ 측에서 발생하는 속성 업데이트 및 시그널 발신은 원격에서 실행될 수 있는 HTML 클라이언트로 자동으로 전송됩니다. 클라이언트 측에서는 공개된 모든 C++ ` QObject`에 대해 JavaScript 객체가 생성됩니다. 이 객체는 C++ 객체의 API를 그대로 반영하므로 직관적으로 사용할 수 있습니다.
QWebChannel은 QFuture 을 투명하게 지원합니다. 클라이언트가 QFuture 을 반환하는 메서드를 호출하면, QWebChannel은 QFuture 이 완료된 후에만 QFuture 결과를 포함한 응답을 보냅니다.
JSON과 QJsonValue 간의 사용자 정의 변환은 QMetaType::registerConverter()을 사용하여 변환기를 정의함으로써 지원됩니다. QJsonValue 에서 구체적인 유형으로의 사용자 정의 변환기는 QJsonValue 가 예상된 형식과 일치하지 않을 경우 실패해야 합니다. 그렇지 않으면 QWebChannel이 기본 변환 메커니즘으로 대체할 수 없습니다. 사용자 정의 변환기는 JavaScript 측에서도 사용할 수 있습니다.
C++ QWebChannel API를 사용하면 로컬 또는 원격 컴퓨터에서 실행되는 모든 HTML 클라이언트와 통신할 수 있습니다. 유일한 제한 사항은 HTML 클라이언트가 qwebchannel.js 에서 사용하는 JavaScript 기능을 지원해야 한다는 점입니다. 따라서 기본적으로 모든 최신 HTML 브라우저나 node.js와 같은 독립형 JavaScript 런타임과 상호 작용할 수 있습니다.
또한 선언형 WebChannel API 도 존재합니다.
Qt WebChannel 독립 실행형 예제, JavaScript API 및 QMetaType::registerConverter()도 참조하십시오 .
속성 문서
[bindable] blockUpdates : bool
참고: 이 속성은 ‘ QProperty ’ 바인딩을 지원합니다.
이 속성을 ` true`로 설정하면 업데이트가 차단되며, 원격 클라이언트에는 속성 변경 사항이 알림되지 않습니다.
변경 사항은 기록되며, 이 속성을 false 로 설정하여 업데이트 차단을 해제하면 클라이언트에 전송됩니다. 기본적으로 업데이트는 차단되지 않습니다.
액세스 함수:
| bool | blockUpdates() const |
| void | setBlockUpdates(bool block) |
알림 신호:
| void | blockUpdatesChanged(bool block) |
[bindable] propertyUpdateInterval : int
참고: 이 속성은 QProperty 바인딩을 지원합니다.
이 속성은 속성 업데이트 간격을 나타냅니다.
이 간격은 양수 값으로 설정하여 밀리초 단위의 다른 간격으로 변경할 수 있습니다. 속성 업데이트는 일괄 처리되어 해당 간격이 만료된 후 전송됩니다. 0으로 설정된 경우, 단일 이벤트 루프 실행 내에서 발생하는 업데이트는 일괄 처리되어 다음 실행 시 전송됩니다. 음수인 경우, 업데이트는 즉시 전송됩니다. 기본값은 50밀리초입니다.
액세스 함수:
| int | propertyUpdateInterval() const |
| void | setPropertyUpdateInterval(int ms) |
멤버 함수 설명서
[explicit] QWebChannel::QWebChannel(QObject *parent = nullptr)
지정된 ` parent`을 사용하여 `QWebChannel` 객체를 생성합니다.
QWebChannel은 QWebChannelAbstractTransport 에 연결해야만 완전히 작동한다는 점에 유의하십시오. 또한 HTML 클라이언트도 qwebchannel.js를 사용하여 적절히 설정되어야 합니다.
[virtual noexcept] QWebChannel::~QWebChannel()
QWebChannel 를 삭제합니다.
[slot] void QWebChannel::connectTo(QWebChannelAbstractTransport *transport)
QWebChannel 를 지정된 transport 객체에 연결합니다.
그러면 이 전송 객체가 C++ 애플리케이션과 원격 HTML 클라이언트 간의 통신을 처리합니다.
QWebChannelAbstractTransport 및 QWebChannel::disconnectFrom()도 참조하십시오 .
[invokable] void QWebChannel::deregisterObject(QObject *object)
지정된 ` object `를 ` QWebChannel`에서 등록 해제합니다.
원격 클라이언트는 지정된 객체에 대한 destroyed 신호를 수신합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. ` Q_INVOKABLE`을 참조하십시오.
QWebChannel::registerObjects(), QWebChannel::registerObject(), QWebChannel::registeredObjects()도 참조하십시오 .
[slot] void QWebChannel::disconnectFrom(QWebChannelAbstractTransport *transport)
QWebChannel 를 transport 객체에서 분리합니다.
QWebChannel::connectTo()도 참조하십시오 .
[invokable] void QWebChannel::registerObject(const QString &id, QObject *object)
QWebChannel 에 단일 객체를 등록합니다.
object 의 속성, 신호 및 공개 메서드는 원격 클라이언트에 공개됩니다. 그러면 해당 클라이언트 측에서 식별자가 id 인 객체가 생성됩니다.
BINDABLE 에 속하지만 NOTIFY 신호를 갖지 않는 속성의 경우, 클라이언트 측에서 속성 업데이트는 정상적으로 이루어지지만 변경 알림을 위한 콜백을 등록할 수 있는 메커니즘은 제공되지 않습니다.
참고: 현재의제한 사항으로 , 객체는 클라이언트가 초기화되기 전에 등록되어야 합니다.
참고: 이 함수는 메타 객체 시스템과 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()도 참조하십시오 .
© 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.