このページでは

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.