WebView QML Type
ウェブコンテンツを表示するためのコンポーネント。もっと見る...
| Import Statement: | import QtWebView |
プロパティ
- canGoBack : bool
- canGoForward : bool
- httpUserAgent : url
(since QtWebView 1.14) - loadProgress : int
- loading : bool
- settings : WebViewSettings
(since QtWebView 6.5) - title : string
- url : url
信号
- cookieAdded(string domain, string name)
- cookieRemoved(string domain, string name)
- loadingChanged(WebViewLoadRequest loadRequest)
方法
- void deleteAllCookies()
(since QtWebView 6.3) - void deleteCookie(string domain, string name)
(since QtWebView 6.3) - void goBack()
- void goForward()
- void loadHtml(string html, url baseUrl)
- void reload()
- void runJavaScript(string script, variant callback)
- void setCookie(string domain, string name, string value)
(since QtWebView 6.3) - void stop()
詳細説明
WebViewはウェブコンテンツを表示するためのコンポーネントで、利用可能なプラットフォーム上ではネイティブAPIを使用して実装されるため、アプリケーションの一部として完全なウェブブラウザスタックを含める必要は必ずしもありません。
すべてのプラットフォームでQt WebView モジュールを正しく機能させるには、QGuiApplication インスタンスを作成した直後にQtWebView::initialize() を呼び出す必要があります。
注意： プラットフォームの制限により、WebViewと他のQMLコンポーネントのオーバーラップはサポートされていません。
プロパティ Documentation
canGoBack : bool |
ウェブ履歴を遡ることが可能な場合、true を保持します。
canGoForward : bool |
現在ウェブ履歴を進むことが可能な場合はtrue を保持します。
httpUserAgent : url |
使用中のユーザーエージェント。
注意: WinRT では、このプロパティはアプリケーションのすべての WebView に影響します。
このプロパティは QtWebView 1.14 で導入されました。
loadProgress : int |
ウェブコンテンツの現在のロード進行状況を0から100までの整数で表します。
loading : bool |
WebView が現在新しいコンテンツのロード中であればtrue を、そうでなければfalse を保持します。
loadingChanged()も参照 。
settings : WebViewSettings |
title : string |
現在ロードされているウェブページのタイトル。
url : url |
現在ロードされているウェブページのURL。これを変更すると、新しいコンテンツがロードされます。
URLはそのまま使用されます。ユーザー入力に由来するURLは、QUrl::fromUserInput()で解析する必要があります。
注意: WebView は、Qt Resource システムを介したコンテンツのロードをサポートしていません。
シグナルの説明
このシグナルはクッキーが追加されたときに発せられます。
パラメータは追加されたクッキーのdomain とname に関する情報を提供します。
注意: QtWebEngine モジュールがバックエンドとして使われるとき、cookieAdded シグナルは、ウェブサイトによって追加されたものを含め、基礎となるQWebEngineCookieStore に追加されたすべてのクッキーに対して発せられます。その他の場合、cookieAdded シグナルはsetCookie()で明示的に追加されたクッキーに対してのみ発せられます。
注: 対応するハンドラはonCookieAdded です。
このシグナルはクッキーが削除されたときに発せられます。
パラメータは削除されたクッキーのdomain とname に関する情報を提供します。
注: 対応するハンドラはonCookieRemoved です。
loadingChanged(WebViewLoadRequest loadRequest) |
このシグナルはウェブ・コンテンツのロード状態が変化したときに送られます。このシグナルを扱うことで、例えばページのロードエラーに対応することができます。
loadRequest パラメータには、リクエストのurlとステータス、そして失敗したリクエストのエラーメッセージを含むerrorStringが格納されます。
注意: 対応するハンドラはonLoadingChanged です。
WebViewLoadRequestも参照ください 。
メソッドのドキュメント
|
すべてのクッキーを削除します。
このメソッドはQtWebView 6.3で導入されました。
指定されたdomain とname を持つクッキーを削除します。
クッキーが削除されるとcookieRemoved シグナルが発せられます。
このメソッドは QtWebView 6.3 で導入されました。
void goBack() |
ウェブ履歴を遡ります。
void goForward() |
ウェブ履歴を前方に移動します。
指定されたhtml コンテンツをウェブビューにロードします。
このメソッドは、URL 経由で HTML ページを参照するurl プロパティより低レベルの代替手段を提供します。
HTML ドキュメントで参照されるスタイルシートや画像などの外部オブジェクトは、baseUrl からの相対位置に配置する必要があります。例えば、html がベースURLであるhttp://www.example.com/documents/overview.html から取得される場合、相対URLであるdiagram.png で参照される画像はhttp://www.example.com/documents/diagram.png にあるべきです。
注意: WebView は Qt Resource システムからのコンテンツの読み込みをサポートしていません。
urlも参照してください 。
void reload() |
現在のurl をリロードします。
指定されたJavaScriptを実行します。callback 関数が指定されている場合、script の実行終了後に呼び出されます。
runJavaScript("document.title", function(result) { console.log(result); });指定されたdomain 、name 、value でクッキーを追加します。
クッキーが追加されるとcookieAdded シグナルが発せられます。
このメソッドは QtWebView 6.3 で導入されました。
void stop() |
現在のurl のロードを停止します。
© 2025 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.
