このページでは

QWebView Class

QWebView クラスは、Web コンテンツを表示するためのウィンドウを提供します。詳細...

ヘッダー: #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
void runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})
QWebViewSettings *settings() const
QString title() const
QUrl url() const

パブリックスロット

void deleteAllCookies()
void deleteCookie(const QString &domain, const QString &name)
void goBack()
void goForward()
void loadHtml(const QString &html, const QUrl &baseUrl = QUrl())
void reload()
void setCookie(const QString &domain, const QString &name, const QString &value)
void setHttpUserAgentString(const QString &httpUserAgent)
void setUrl(const QUrl &url)
void stop()

シグナル

void cookieAdded(const QString &domain, const QString &name)
void cookieRemoved(const QString &domain, const QString &name)
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

詳細な説明

Web ビューは、Web コンテンツを表示するためのウィンドウであり、利用可能なプラットフォームではネイティブ API を使用して実装されます。したがって、アプリケーションの一部として完全な Web ブラウザ スタックを組み込む必要は必ずしもありません。

setUrl() 関数を使用して、Web サイトをWeb ビューに読み込むことができます。

あるいは、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

Webコンテンツの現在の読み込み進捗状況。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 の設定オブジェクト。Web ビューの設定。

アクセス関数:

QWebViewSettings *settings() const

「WebViewSettings」も参照してください 。

title : QString

このプロパティは、現在読み込まれているWebページのタイトルを保持します。

HTMLの<title> 要素で定義されたページのタイトルです。

アクセス関数:

QString title() const

通知シグナル:

void titleChanged(const QString &title)

関連項目: ` titleChanged()`。

url : QUrl

このプロパティには、現在表示されているWebページのURLが格納されます。

このプロパティを設定すると、表示がクリアされ、そのURLが読み込まれます。デフォルトでは、このプロパティには空の無効なURLが格納されています。ユーザー入力に由来するURLは、QUrl::fromUserInput() を使用して解析する必要があります。

注: QWebView は 、Qtリソースシステムを介したコンテンツの読み込みには対応していません。

アクセス関数:

QUrl url() const
void setUrl(const QUrl &url)

通知シグナル:

void urlChanged(const QUrl &url)

関連項目: ` loadingChanged()`。

メンバ関数のドキュメント

bool QWebView::canGoBack() const

Web履歴で現在、前のページに戻ることが可能な場合、true を返します。

bool QWebView::canGoForward() const

Web履歴で現在、先へ進む操作が可能である場合、true を返します。

[signal] void QWebView::cookieAdded(const QString &domain, const QString &name)

このシグナルは、クッキーが追加されたときに発せられます。

パラメータには、追加されたクッキーのdomain およびname に関する情報が含まれます。

注: Qt WebEngine モジュールをバックエンドとして使用する場合 、ウェブサイトによって追加されたものを含め、基になるQWebEngineCookieStore に追加されたすべてのクッキーに対して、cookieAddedシグナルが発行されます。それ以外の場合は、cookieAddedシグナルはsetCookie()によって明示的に追加されたクッキーに対してのみ発行されます。

[signal] void QWebView::cookieRemoved(const QString &domain, const QString &name)

このシグナルは、クッキーが削除された際に発火します。パラメータには、削除されたクッキーのdomain およびname に関する情報が含まれます。

[slot] void QWebView::deleteAllCookies()

すべてのクッキーを削除します。

[slot] void QWebView::deleteCookie(const QString &domain, const QString &name)

指定されたdomain およびname を持つクッキーを削除します。

クッキーが削除されると、cookieRemoved() シグナルが発行されます。

[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` に対する通知 シグナルです。

[slot] void QWebView::loadHtml(const QString &html, const QUrl &baseUrl = QUrl())

指定されたhtml コンテンツをWebビューに読み込みます。

このメソッドは、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リソースシステムを介したコンテンツの読み込みには対応していません。

[signal] void QWebView::loadProgressChanged(int loadProgress)

このシグナルは、Webページの読み込み中に継続的に発火します。loadProgress パラメータは0から100までの値で、Webページの読み込みが進んだ割合(パーセンテージ)を示します。このシグナルの本来の用途は、ユーザーに進行状況バーを表示することです。

注:一部の バックエンドは、読み込み進捗の小数点以下の変化をサポートしておらず、読み込みの開始時と終了時にのみ、それぞれ値 0 および 100 でこのシグナルを発行します。

注: プロパティ `loadProgress` に対する通知 シグナルです。

loadingChangedも参照してください 。

[signal] void QWebView::loadingChanged(const QWebViewLoadingInfo &loadingInfo)

このシグナルは、Webコンテンツの読み込み状態が変化した際に発せられます。このシグナルを処理することで、たとえばページの読み込みエラーに対応することが可能になります。

loadingInfo パラメータには、リクエストのURLとステータス、およびリクエストが失敗した場合のエラーメッセージを含むerrorStringが格納されます。

注: プロパティ `loading` に対するNotifier シグナルです。

関連項目: loadProgressChanged およびQWebViewLoadingInfo 。

[slot] void QWebView::reload()

現在のurl を再読み込みします。

void QWebView::runJavaScript(const QString &script, const std::function<void (const QVariant &)> &resultCallback = {})

指定されたJavaScriptを実行します。resultCallback 関数が指定されている場合、script の実行が完了した後にその関数が呼び出されます。

view.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

[slot] void QWebView::setCookie(const QString &domain, const QString &name, const QString &value)

指定されたdomain 、name 、value を含むクッキーを追加します。クッキーが追加されると、cookieAdded()シグナルが発火します。

[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.