WebView QML Type

Webコンテンツを表示するためのコンポーネント。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• 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)
• httpUserAgentChanged(string userAgent)
• loadProgressChanged(int loadProgress)
• loadingChanged(WebViewLoadRequest loadRequest)
• titleChanged(string title)
• urlChanged(url url)

方法

• 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は、Webコンテンツを表示するためのコンポーネントであり、利用可能なプラットフォームではネイティブAPIを使用して実装されるため、アプリケーションの一部として完全なWebブラウザスタックを含める必要は必ずしもありません。

Qt WebView モジュールがすべてのプラットフォームで正しく機能するようにするには、QGuiApplication インスタンスの作成直後にQtWebView::initialize()を呼び出す必要があります。

プロパティのドキュメント

canGoBack : bool [read-only]

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

canGoForward : bool [read-only]

Web履歴で現在、前へ移動できる場合は、true を保持します。

httpUserAgent : url [since QtWebView 1.14]

使用中のユーザーエージェント。

このプロパティは、QtWebView 1.14で導入されました。

loadProgress : int [read-only]

Webコンテンツの現在の読み込み進捗状況。0から100までの整数で表されます。

loading : bool [read-only]

WebView が現在新しいコンテンツを読み込んでいる場合はtrue を、それ以外の場合はfalse を保持します。

loadingChanged()も参照してください 。

settings : WebViewSettings [read-only, since QtWebView 6.5]

WebView の設定オブジェクト。

このプロパティは QtWebView 6.5 で導入されました。

WebViewSettingsも参照してください 。

title : string [read-only]

現在読み込まれているウェブページのタイトル。

url : url

現在読み込まれているウェブページのURL。これを変更すると、新しいコンテンツの読み込みが開始されます。

URLはそのまま使用されます。ユーザー入力に由来するURLは、QUrl::fromUserInput() を使用して解析する必要があります。

シグナルのドキュメント

cookieAdded(string domain, string name)

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

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

cookieRemoved(string domain, string name)

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

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

httpUserAgentChanged(string userAgent)

このシグナルは、ビューのuserAgent が変更されるたびに発火します。

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

loadProgressChanged(int loadProgress)

このシグナルは、Webページの読み込み中に継続的に発信されます。loadProgress パラメータは0から100までの値であり、Webページの読み込み進捗率（パーセント）を示します。このシグナルの主な用途は、ユーザーに進行状況バーを表示することです。

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

loadingChanged(WebViewLoadRequest loadRequest)

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

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

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

titleChanged(string title)

このシグナルは、ビューのtitle が変更されるたびに発生します。

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

urlChanged(url url)

このシグナルは、ビューのurl が変更されるたびに発火します。

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

メソッドのドキュメント

[since QtWebView 6.3] void deleteAllCookies()

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

このメソッドは、QtWebView 6.3 で導入されました。

[since QtWebView 6.3] void deleteCookie(string domain, string name)

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

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

このメソッドは QtWebView 6.3 で導入されました。

void goBack()

ウェブの閲覧履歴をさかのぼります。

void goForward()

ウェブ履歴を前へ移動します。

void loadHtml(string html, url baseUrl)

指定された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 に存在する必要があります。

urlも参照してください 。

void reload()

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

void runJavaScript(string script, variant callback)

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

runJavaScript("document.title", function(result) { console.log(result); });

[since QtWebView 6.3] void setCookie(string domain, string name, string value)

指定されたdomain 、name 、value を含むクッキーを追加します。

クッキーが追加されると、cookieAdded シグナルが発火します。

このメソッドは、QtWebView 6.3で導入されました。

void stop()

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