QWebView Class
QWebViewクラスは、ウェブコンテンツを表示するためのウィンドウを提供します。詳細...
| ヘッダー | #include <QWebView> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebView)target_link_libraries(mytarget PRIVATE Qt6::WebView) |
| qmake: | QT += webview |
| 以来: | Qt 6.11 |
| 継承: | QWindow |
プロパティ
|
パブリック機能
| bool | canGoBack() const |
| bool | canGoForward() const |
| QString | httpUserAgentString() const |
| bool | isLoading() const |
| int | loadProgress() const |
| QWebViewSettings * | settings() const |
| QString | title() const |
| QUrl | url() const |
パブリックスロット
| void | deleteAllCookies() |
| void | goBack() |
| void | goForward() |
| void | loadHtml(const QString &html, const QUrl &baseUrl = QUrl()) |
| void | reload() |
| void | setHttpUserAgentString(const QString &httpUserAgent) |
| void | setUrl(const QUrl &url) |
| void | stop() |
シグナル
| void | httpUserAgentStringChanged(const QString &userAgent) |
| void | loadProgressChanged(int loadProgress) |
| void | loadingChanged(const QWebViewLoadingInfo &loadingInfo) |
| void | titleChanged(const QString &title) |
| void | urlChanged(const QUrl &url) |
再実装された保護された関数
| virtual bool | event(QEvent *e) override |
詳細説明
ウェブビューは、ウェブコンテンツを表示するためのウィンドウで、利用可能なプラットフォーム上でネイティブAPIを使用して実装されます。したがって、アプリケーションの一部として完全なウェブ・ブラウザ・スタックを含める必要は必ずしもありません。
ウェブサイトは setUrl() 関数でウェブビューに読み込むことができます。
また、HTML コンテンツがすぐに利用できる場合は、代わりに setHtml() を使用することもできます。
loadingChanged() シグナルは、ビューのロードが開始されたときと、ビューが完全にロードされたときに発行されます。その引数である QWebViewLoadRequest オブジェクトは、ロードが成功したか失敗したかを示します。
HTML ドキュメントのタイトルには、title() プロパティでアクセスできます。
プロパティの説明
httpUserAgentString : QString
このプロパティは、使用中のユーザ・エージェントを保持する。ブラウザを識別するためにHTTPで送信されるユーザエージェント文字列。
アクセス関数:
| QString | httpUserAgentString() const |
| void | setHttpUserAgentString(const QString &httpUserAgent) |
ノーティファイアシグナル:
| void | httpUserAgentStringChanged(const QString &userAgent) |
[read-only] loadProgress : int
ウェブコンテンツの現在のロード進行状況を、0から100までの整数で表します。
アクセス関数:
| int | loadProgress() const |
通知シグナル:
| void | loadProgressChanged(int loadProgress) |
[read-only] loading : bool
WebView が現在新しいコンテンツのロード中であればtrue を、そうでなければfalse を保持する。
アクセス関数:
| bool | isLoading() const |
通知シグナル:
| void | loadingChanged(const QWebViewLoadingInfo &loadingInfo) |
[read-only] settings : QWebViewSettings* const
QWebView の設定オブジェクト。 ウェブビューの設定。
アクセス関数:
| QWebViewSettings * | settings() const |
WebViewSettingsも参照してください 。
title : QString
このプロパティは、現在ロードされているウェブページのタイトルを保持する。
HTML<title> 要素によって定義されるページのタイトル。
アクセス関数
| QString | title() const |
ノーティファイア・シグナル:
| void | titleChanged(const QString &title) |
titleChanged()も参照 。
url : QUrl
このプロパティは、現在表示されているウェブページの URL を保持します。
このプロパティを設定すると、ビューがクリアされ、URLがロードされます。デフォルトでは、このプロパティには空の無効な URL が格納されます。ユーザー入力に由来する URL は、QUrl::fromUserInput() で解析する必要があります。
注意: QWebView は、Qt Resource システムによるコンテンツのロードをサポートしていません。
アクセス関数
| QUrl | url() const |
| void | setUrl(const QUrl &url) |
Notifier シグナル:
| void | urlChanged(const QUrl &url) |
loadingChanged()も参照してください 。
メンバ関数のドキュメント
bool QWebView::canGoBack() const
ウェブ履歴を遡ることが可能であればtrue を返す。
bool QWebView::canGoForward() const
ウェブ履歴を前方に移動できる場合はtrue を返す。
[slot] void QWebView::deleteAllCookies()
すべてのクッキーを削除する。
[override virtual protected] bool QWebView::event(QEvent *e)
再インプリメント:QWindow::event(QEvent *ev).
[slot] void QWebView::goBack()
ウェブ履歴を遡ります。
[slot] void QWebView::goForward()
ウェブ履歴をナビゲートします。
[signal] void QWebView::httpUserAgentStringChanged(const QString &userAgent)
このシグナルは、ビューのuserAgent が変更されるたびに発行されます。
注意: httpUserAgentString プロパティ用のノーティファイアシグナルです。
httpUserAgent()も参照ください 。
[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
指定されたhtml コンテンツをウェブ・ビューにロードする。
このメソッドは、URL 経由で HTML ページを参照するurl プロパティに代わる低レベルの方法を提供します。
HTML ドキュメントで参照されるスタイルシートや画像などの外部オブジェクトは、baseUrl からの相対位置に配置する必要があります。た と えば、html がベース URL であるhttp://www.example.com/documents/overview.html から取得される場合、相対 URLdiagram.png で参照される画像はhttp://www.example.com/documents/diagram.png にあるべきです。
注意: QWebView は、Qt Resource システムによるコンテンツの読み込みをサポートしていません。
[signal] void QWebView::loadProgressChanged(int loadProgress)
このシグナルは、ウェブページがロードされている間、継続的に発せられます。loadProgress パラメータは 0 から 100 の間の値で、ウェブページの何パーセントが読み込まれたかを示します。このシグナルの使用目的は、ユーザーにプログレスバーを表示することです。
注意: バックエンドによっては、ロードの進行状況の小数の変更をサポートしておらず、ロードの開始時と終了時にのみ、それぞれ 0 と 100 の値でこのシグナルを発信します。
注意: loadProgress プロパティのノーティファイアシグナル。
loadingChangedも参照 。
[signal] void QWebView::loadingChanged(const QWebViewLoadingInfo &loadingInfo)
このシグナルは、ウェブコンテンツのロード状態が変化したときに発行されます。このシグナルを処理することで、たとえばページの読み込みエラーに対応することができます。
loadingInfo パラメータには、リクエストのurlとステータス、および失敗したリクエストのエラーメッセージを含むerrorStringが格納されます。
注: loading プロパティに対するノーティファイアシグナル。
loadProgressChanged およびQWebViewLoadingInfoも参照してください 。
[slot] void QWebView::reload()
現在のurl をリロードする。
[slot] void QWebView::stop()
現在のurl のロードを停止する。
[signal] void QWebView::titleChanged(const QString &title)
このシグナルは、ビューのtitle が変更されるたびに発行されます。
注意: title プロパティのノーティファイアシグナルです。
title()も参照してください 。
[signal] void QWebView::urlChanged(const QUrl &url)
このシグナルは、ビューのurl が変更されるたびに発行されます。
注意: url プロパティのノーティファイアシグナルです。
url()も参照してください 。
© 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.