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 [read-only]

ウェブ履歴を遡ることが可能な場合、true を保持します。

canGoForward : bool [read-only]

現在ウェブ履歴を進むことが可能な場合はtrue を保持します。

httpUserAgent : url [since QtWebView 1.14]

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

注意: WinRT では、このプロパティはアプリケーションのすべての WebView に影響します。

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

loadProgress : int [read-only]

ウェブコンテンツの現在のロード進行状況を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 （）で解析する必要がある。

注意: WebView は、Qt Resource システムによるコンテンツの読み込みをサポートしていません。

シグナルの説明

cookieAdded(string domain, string name)

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

パラメータは追加されたクッキーのdomain とname に関する情報を提供します。

注意: QtWebEngine モジュールがバックエンドとして使われるとき、cookieAdded シグナルは、ウェブサイトによって追加されたものも含めて、基礎となるQWebEngineCookieStore に追加されたすべてのクッキーに対して発せられます。その他の場合、cookieAdded シグナルはsetCookie()で明示的に追加されたクッキーに対してのみ発せられます。

注: 対応するハンドラはonCookieAdded です。

cookieRemoved(string domain, string name)

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

パラメータは削除されたクッキーのdomain とname に関する情報を提供します。

注: 対応するハンドラはonCookieRemoved です。

loadingChanged(WebViewLoadRequest loadRequest)

このシグナルはウェブ・コンテンツのロード状態が変化したときに送られます。このシグナルを扱うことで、例えばページのロードエラーに対応することができます。

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

注意: 対応するハンドラはonLoadingChanged です。

WebViewLoadRequestも参照ください。

メソッド・ドキュメント

[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 コンテンツをウェブビューにロードします。

このメソッドは、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 をリロードします。

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 のロードを停止します。

本書に含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。