WebEngineView QML Type

WebEngineView は、QML アプリケーション内で Web コンテンツをレンダリングします。詳細...

Import Statement: import QtWebEngine
Since: QtWebEngine 1.0
Inherits:

Item

プロパティ

シグナル

メソッド

  • void acceptAsNewWindow(QWebEngineNewWindowRequest *request) (since QtWebEngine 2.0)
  • WebEngineAction action(WebAction action)
  • webEngineFrame findFrameByName(string name) (since QtWebEngine 6.8)
  • void findText(string subString) (since QtWebEngine 1.1)
  • void findText(string subString, FindFlags options) (since QtWebEngine 1.1)
  • void findText(string subString, FindFlags options, variant resultCallback) (since QtWebEngine 1.1)
  • void fullScreenCancelled() (since QtWebEngine 1.1)
  • void goBack()
  • void goBackOrForward(int offset) (since QtWebEngine 1.1)
  • void goForward()
  • void loadHtml(string html, url baseUrl)
  • void printToPdf(const string filePath, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation) (since QtWebEngine 1.3)
  • void printToPdf(variant resultCallback, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation) (since QtWebEngine 1.3)
  • void reload()
  • void reloadAndBypassCache() (since QtWebEngine 1.1)
  • void replaceMisspelledWord(const QString &replacement) (since QtWebEngine 1.3)
  • void runJavaScript(string script, variant callback)
  • void runJavaScript(string script, int worldId, variant callback)
  • void save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format) (since QtWebEngine 6.6)
  • void setActiveFocusOnPress(bool arg) (since QtWebEngine 1.2)
  • void stop()
  • void triggerWebAction(WebAction action) (since QtWebEngine 1.2)

詳細説明

WebEngineView は QML アプリケーションが動的な Web コンテンツの領域を表示するためのものです。WebEngineViewはTabViewのような他のQML型と画面を共有したり、QMLアプリケーション内で指定された画面いっぱいに表示したりすることができます。

ウェブエンジンの初期化

ウェブエンジンビューを描画するためには、アプリケーションのメインソースファイルでQtWebEngineQuick::initialize を使ってウェブエンジンを初期化する必要があります:

int main(int argc, char *argv[])
{
    QCoreApplication::setAttribute(Qt::AA_ShareOpenGLContexts);
    QtWebEngineQuick::initialize();
    QGuiApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

ウェブページの読み込み

アプリケーションは、url プロパティまたはloadHtml メソッドを使用して WebEngineView にページをロードし、ビューのセッション履歴内を移動できます。URL のロードには常に GET メソッドが使用されます。

履歴はhistory プロパティが保持するWebEngineHistory データモデルで表されます。

次のサンプルQMLアプリケーションでは、url プロパティを使用してWebページをロードしています:

import QtQuick
import QtQuick.Window
import QtWebEngine

Window {
    width: 1024
    height: 750
    visible: true
    WebEngineView {
        anchors.fill: parent
        url: "https://www.qt.io"
    }
}

loading プロパティは、HTMLページが現在ロード中かどうかを保持します。loadingChanged() シグナルは、ページのロードが開始、終了、または失敗したときに発せられます。

HTML ページのタイトルには、title プロパティでアクセスできます。さらに、ウェブ・ページはアイコンを指定することができ、icon プロパティを使用してアクセスできます。zoomFactor プロパティを使用すると、Web ページの内容を倍率でズームできます。

Web ページの読み込み中に証明書エラーが発生すると、certificateError() シグナルが発行されます。証明書エラーは、WebEngineCertificateError タイプのメソッドを使用して処理されます。

インタラクション

デフォルトでは、異なるページへのリンクは同じ WebEngineView オブジェクト内にロードされますが、Web サイトから新しいタブ、ウィンドウ、またはダイアログとして開くように要求されることがあります。newWindowRequested() シグナルは、別の Web エンジンビューでページをロードする要求が発行されたときに発行されます。NewViewDestination プロパティは、新しいビューを開く方法を記述します。さらに、WebEngineNewWindowRequest ユーティリティ・タイプを使用して、Web ページを別の Web エンジン・ビューにロードできます。

findText() メソッドを使用すると、FindFlags で説明されているオプションを使用して、Web ページ上の文字列を検索できます。

setActiveFocusOnPress() メソッドを使用すると、プレス時にフォーカスが当たらない UI 要素を作成できます。これはハイブリッドUIで便利です。

focusOnNavigationEnabled 設定を使用すると、ナビゲーション操作(ページのロードやリロード、履歴のナビゲートなど)が発生したときに、ビューが自動的にフォーカスを受け取るようにすることができます。

linkHovered() シグナルは、マウスポインタがリンクの上を通過したときに発せられ、mouseover DOM イベントに対応します。

コンテンツの選択や編集などのアクションは、triggerWebAction() メソッドを使ってウェブページ上で実行できます。利用可能なアクションは、WebAction プロパティによって記述されます。

backgroundColorChanged() シグナルは、Web ページの背景色が変更されたときに発信されます。

ユーザースクリプト

ページの読み込み中、さまざまな場所で JavaScript エンジンにユーザースクリプトと呼ばれるスクリプトを注入できます。ウェブエンジン・ビューにアタッチされたスクリプト・オブジェクトは、userScripts プロパティによって保持され、WebEngineScript タイプを使用して注入されます。スクリプトは、ロードされたサイトの一部である他のスクリプトと同じワールドでrunJavaScript() メソッドを使用して実行することもできます。

webChannel プロパティを使用すると、WebChannel インスタンスをレンダリングしているページの JavaScript コンテキストにqt.webChannelTransport として公開できます。

フルスクリーンモード

ウェブページは、JavaScript API を通じてフルスクリーンモードでの読み込みを要求できます。ウェブページがリクエストを発行すると、fullScreenRequested() シグナルが発行されます。FullScreenRequest ユーティリティ型を使用して、フルスクリーン要求を切り替えることができます。fullScreenCancelled メソッドを使用すると、ウィンドウ システムがアプリケーションをフルスクリーンモードから強制的に離脱させるときに、ブラウザ エンジンに通知できます。

プロファイル

WebEngineProfile タイプを使用することで、Web エンジンのビューを互いに分離できます。プロファイルには、設定、スクリプト、およびプロファイルに属するすべてのビューで共有される訪問済みリンクのリストが含まれます。例えば、プライベートブラウジングモード専用のプロファイルを作成することができます。ビューの現在のプロファイルはprofile プロパティで保持され、現在の設定はsettings プロパティで保持されます。設定は、WebEngineSettings タイプを使用して指定します。

プラットフォーム機能

ウェブページは、ジオロケーションやオーディオ/ビデオキャプチャデバイスなどのプラットフォーム機能へのアクセスを要求することができます。permissionRequested() シグナルは、ウェブページがリソースの利用を要求したときに発せられます。サポートされるプラットフォーム機能は、QWebEnginePermission::Feature プロパティによって記述されます。

OpenGL サーフェスへのレンダリング

QQuickRenderControl を使用して Qt Quick ユーザー インターフェイスを OpenGL サーフェスにレンダリングすると、WebEngineView タイプが正しくレンダリングされません。ウェブエンジンビューは、QtWebEngineQuick::initialize によって作成されたグローバルな OpenGL コンテキストを使用しようとしますが、QQuickRenderControl コンテキストと共有するためにそのコンテキストにアクセスするためのパブリック API がありません。

ウェブエンジン・ビューを正しくレンダリングするには、QQuickRenderControl と共有される新しいオフスクリーン・コンテキストを手動で作成し、initialize() を呼び出すのではなく、非公開関数qt_gl_set_global_share_context() を呼び出すことが可能です。グローバル・コンテキストを設定した後にinitialize() を呼び出すと、何もしません。

プロパティ・ドキュメンテーション

ErrorDomain : enumeration

さまざまな高レベルのエラータイプについて説明します:

定数説明
WebEngineView.NoErrorDomain
WebEngineView.InternalErrorDomainQt WebEngine によるコンテンツの解釈に失敗しました。
WebEngineView.ConnectionErrorDomainネットワーク接続の不具合によるエラー。
WebEngineView.CertificateErrorDomainSSL/TLS 証明書に関するエラー。
WebEngineView.HttpErrorDomainHTTP 接続に関するエラー。
WebEngineView.FtpErrorDomainFTP 接続に関するエラー。
WebEngineView.DnsErrorDomainDNS 接続に関するエラー。

FindFlags : enumeration

findText() 関数で使用可能なオプションについて説明します。オプションは、以下のリストから OR で組み合わせることができます:

定数説明
WebEngineView.FindBackward前方ではなく後方を検索します。
WebEngineView.FindFlagsFindCaseSensitively デフォルトでは、findText() は大文字と小文字を区別せずに動作します。このオプションを指定すると、大文字小文字を区別して検索を行います。

findText()も参照


JavaScriptConsoleMessageLevel : enumeration

JavaScript のコンソール・メッセージの重大度を示します:

定数説明
WebEngineView.InfoMessageLevelメッセージは純粋に参考情報であり、無視しても問題ありません。
WebEngineView.WarningMessageLevelメッセージは注意が必要な問題があることを示しています。
WebEngineView.ErrorMessageLevelMessage はエラーが発生したことを示します。

LifecycleState : enumeration [since QtWebEngine 1.10]

この列挙型は、ページのライフサイクル状態を記述します:

定数説明
WebEngineView.LifecycleState.Active通常状態。
WebEngineView.LifecycleState.FrozenほとんどのHTMLタスクソースが中断される、CPU使用率が低い状態。
WebEngineView.LifecycleState.Discarded閲覧コンテキスト全体が破棄される、リソース使用率が非常に低い状態。

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

lifecycleStatePage Lifecycle APIWebEngine Lifecycle Exampleも参照してください


LoadStatus : enumeration

ページのロード状態を反映します:

定数説明
WebEngineView.LoadStartedStatusページの読み込み中。
WebEngineView.LoadStoppedStatusページの読み込みは、stop ()メソッド、または Chromium のローダーコードやネットワークスタックによって停止されました。
WebEngineView.LoadSucceededStatusページは正常にロードされ、現在はロードされていません。
WebEngineView.LoadFailedStatusページの読み込みに失敗し、現在読み込み中ではありません。

PrintedPageOrientation : enumeration [since QtWebEngine 1.3]

WebEngineView の内容から作成される PDF 文書の向きを記述します。列挙値はQPageLayout::Orientation からマップされ、 と一致しなければならない。

定数説明
WebEngineView.Portraitドキュメントは縦向きで作成されます。
WebEngineView.Landscapeドキュメントは横向きで作成されます。

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

WebEngineView::printToPdf()も参照してください


PrintedPageSizeId : enumeration [since QtWebEngine 1.3]

この列挙型は、Postscript PPD 標準で定義されている、利用可能なページサイズを列挙します。

列挙値はQPageSize::PageSizeId からマッピングされ、 と一致しなければなりません。これらはQPagedPaintDeviceQPrinter にも重複している。

定義されているサイズは以下のとおりです:

定数説明
WebEngineView.A0841 x 1189 mm
WebEngineView.A1594 x 841 mm
WebEngineView.A2420 x 594 mm
WebEngineView.A3297 x 420 mm
WebEngineView.A4210 x 297 mm、8.26 x 11.69インチ
WebEngineView.A5148 x 210 mm
WebEngineView.A6105 x 148 mm
WebEngineView.A774 x 105 mm
WebEngineView.A852 x 74 mm
WebEngineView.A937 x 52 mm
WebEngineView.B01000 x 1414 mm
WebEngineView.B1707 x 1000 mm
WebEngineView.B2500 x 707 mm
WebEngineView.B3353 x 500 mm
WebEngineView.B4250 x 353 mm
WebEngineView.B5176 x 250 mm、6.93 x 9.84インチ
WebEngineView.B6125 x 176 mm
WebEngineView.B788 x 125 mm
WebEngineView.B862 x 88 mm
WebEngineView.B944 x 62 mm
WebEngineView.B1031 x 44 mm
WebEngineView.C5E163 x 229 mm
WebEngineView.Comm10E105 x 241 mm、米国共通10封筒
WebEngineView.DLE110 x 220 mm
WebEngineView.Executive7.5 x 10インチ、190.5 x 254 mm
WebEngineView.Folio210 x 330 mm
WebEngineView.Ledger431.8 x 279.4 mm
WebEngineView.Legal8.5 x 14インチ、215.9 x 355.6 mm
WebEngineView.Letter8.5 x 11インチ、215.9 x 279.4 mm
WebEngineView.Tabloid279.4 x 431.8 mm
WebEngineView.Custom不明、またはユーザー定義サイズ。
WebEngineView.A10
WebEngineView.A3Extra
WebEngineView.A4Extra
WebEngineView.A4Plus
WebEngineView.A4Small
WebEngineView.A5Extra
WebEngineView.B5Extra
WebEngineView.JisB0
WebEngineView.JisB1
WebEngineView.JisB2
WebEngineView.JisB3
WebEngineView.JisB4
WebEngineView.JisB5
WebEngineView.JisB6
WebEngineView.JisB7
WebEngineView.JisB8
WebEngineView.JisB9
WebEngineView.JisB10
WebEngineView.AnsiA=Letter
WebEngineView.AnsiB=Ledger
WebEngineView.AnsiC
WebEngineView.AnsiD
WebEngineView.AnsiE
WebEngineView.LegalExtra
WebEngineView.LetterExtra
WebEngineView.LetterPlus
WebEngineView.LetterSmall
WebEngineView.TabloidExtra
WebEngineView.ArchA
WebEngineView.ArchB
WebEngineView.ArchC
WebEngineView.ArchD
WebEngineView.ArchE
WebEngineView.Imperial7x9
WebEngineView.Imperial8x10
WebEngineView.Imperial9x11
WebEngineView.Imperial9x12
WebEngineView.Imperial10x11
WebEngineView.Imperial10x13
WebEngineView.Imperial10x14
WebEngineView.Imperial12x11
WebEngineView.Imperial15x11
WebEngineView.ExecutiveStandard
WebEngineView.Note
WebEngineView.Quarto
WebEngineView.Statement
WebEngineView.SuperA
WebEngineView.SuperB
WebEngineView.Postcard
WebEngineView.DoublePostcard
WebEngineView.Prc16K
WebEngineView.Prc32K
WebEngineView.Prc32KBig
WebEngineView.FanFoldUS
WebEngineView.FanFoldGerman
WebEngineView.FanFoldGermanLegal
WebEngineView.EnvelopeB4
WebEngineView.EnvelopeB5
WebEngineView.EnvelopeB6
WebEngineView.EnvelopeC0
WebEngineView.EnvelopeC1
WebEngineView.EnvelopeC2
WebEngineView.EnvelopeC3
WebEngineView.EnvelopeC4
WebEngineView.EnvelopeC5=C5E
WebEngineView.EnvelopeC6
WebEngineView.EnvelopeC65
WebEngineView.EnvelopeC7
WebEngineView.EnvelopeDL=DLE
WebEngineView.Envelope9
WebEngineView.Envelope10=Comm10E
WebEngineView.Envelope11
WebEngineView.Envelope12
WebEngineView.Envelope14
WebEngineView.EnvelopeMonarch
WebEngineView.EnvelopePersonal
WebEngineView.EnvelopeChou3
WebEngineView.EnvelopeChou4
WebEngineView.EnvelopeInvite
WebEngineView.EnvelopeItalian
WebEngineView.EnvelopeKaku2
WebEngineView.EnvelopeKaku3
WebEngineView.EnvelopePrc1
WebEngineView.EnvelopePrc2
WebEngineView.EnvelopePrc3
WebEngineView.EnvelopePrc4
WebEngineView.EnvelopePrc5
WebEngineView.EnvelopePrc6
WebEngineView.EnvelopePrc7
WebEngineView.EnvelopePrc8
WebEngineView.EnvelopePrc9
WebEngineView.EnvelopePrc10
WebEngineView.EnvelopeYou4
WebEngineView.LastPageSize=EnvelopeYou4

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

WebEngineView::printToPdf()も参照してください


RenderProcessTerminationStatus : enumeration [since QtWebEngine 1.2]

レンダリングプロセスが終了したステータスを記述します:

定数説明
WebEngineView.NormalTerminationStatusレンダリングプロセスが正常に終了した。
WebEngineView.AbnormalTerminationStatusレンダープロセスは、ゼロ以外の終了ステータスで終了しました。
WebEngineView.CrashedTerminationStatusレンダープロセスは、セグメンテーションフォールトなどでクラッシュした。
WebEngineView.KilledTerminationStatusレンダープロセスがSIGKILL やタスクマネージャの kill などで強制終了した。

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


WebAction : enumeration [since QtWebEngine 1.2]

Web ページで実行できるアクションのタイプを記述します:

定数説明
WebEngineView.NoWebActionアクションは発生しません。
WebEngineView.Backナビゲートされたリンクの履歴を戻る。
WebEngineView.Forwardナビゲートしたリンクの履歴を進む。
WebEngineView.Stop現在のページの読み込みを停止する。
WebEngineView.Reload現在のページを再読み込みします。
WebEngineView.ReloadAndBypassCache現在のページを再読み込みするが、ローカルキャッシュは使用しない。
WebEngineView.Cut現在選択されているコンテンツをクリップボードにカットする。
WebEngineView.Copy現在選択されているコンテンツをクリップボードにコピーする。
WebEngineView.Pasteクリップボードの内容を貼り付ける。
WebEngineView.Undo最後の編集操作を取り消す。
WebEngineView.Redo最後の編集操作をやり直す。
WebEngineView.SelectAllすべてのコンテンツを選択する。このアクションはページのコンテンツがフォーカスされているときのみ有効です。フォーカスはJavaScriptのwindow.focus() コールで強制することもできますし、focusOnNavigationEnabled 設定を有効にして自動的にフォーカスを得ることもできます。
WebEngineView.PasteAndMatchStyle現在のスタイルでクリップボードからコンテンツを貼り付ける。
WebEngineView.OpenLinkInThisWindow現在のリンクを現在のウィンドウで開きます。(Qt 5.6 で追加)
WebEngineView.OpenLinkInNewWindow現在のリンクを新しいウィンドウで開きます。newWindowRequested() シグナルのハンドラが必要です。(Qt 5.6 で追加)
WebEngineView.OpenLinkInNewTab現在のリンクを新しいタブで開きます。newWindowRequested() シグナルのハンドラが必要です。(Qt 5.6 で追加)
WebEngineView.CopyLinkToClipboard現在のリンクをクリップボードにコピーします。(Qt 5.6 で追加)
WebEngineView.CopyImageToClipboardクリックした画像をクリップボードにコピー。(Qt 5.6で追加)。
WebEngineView.CopyImageUrlToClipboardクリックした画像の URL をクリップボードにコピー。(Qt 5.6で追加)。
WebEngineView.CopyMediaUrlToClipboardホバーされたオーディオやビデオの URL をクリップボードにコピー。(Qt 5.6で追加)。
WebEngineView.ToggleMediaControlsホバーされたオーディオまたはビデオ要素のコントロールの表示/非表示を切り替えます。(Qt 5.6で追加)。
WebEngineView.ToggleMediaLoopホバリングされたオーディオまたはビデオが完了時にループするかどうかをトグル。(Qt 5.6 で追加)。
WebEngineView.ToggleMediaPlayPauseホバーされたオーディオまたはビデオ要素の再生/一時停止状態をトグルします。(Qt 5.6 で追加)。
WebEngineView.ToggleMediaMuteホバーされたオーディオまたはビデオ要素のミュートまたはミュート解除。(Qt 5.6 で追加)。
WebEngineView.DownloadLinkToDisk現在のリンクをディスクにダウンロードします。ダウンロードアクションを実装するには、WebEngineProfile.downloadRequested 信号に接続します。(Qt 5.6 で追加)
WebEngineView.DownloadImageToDiskハイライトされた画像をディスクにダウンロードします。(Qt 5.6 で追加)
WebEngineView.DownloadMediaToDiskホバリングされたオーディオやビデオをディスクにダウンロード。(Qt 5.6 で追加)
WebEngineView.InspectElement付属の Web インスペクタをトリガーして、ハイライトされた要素を検査。(Qt 5.6 で追加)
WebEngineView.ExitFullScreenフルスクリーンモードを終了。(Qt 5.6 で追加)
WebEngineView.SavePage現在のウェブページをディスクに保存します。(Qt 5.7 で追加)
WebEngineView.ViewSource現在のページのソースを新しいタブで表示します。newWindowRequested() シグナルのハンドラが必要です。(Qt 5.8 で追加)
WebEngineView.ToggleBold選択範囲やカーソル位置の太字を切り替えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.ToggleItalic選択範囲またはカーソル位置の斜体を切り替えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.ToggleUnderline選択範囲またはカーソル位置の下線を切り替えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.ToggleStrikethrough選択範囲またはカーソル位置の下線を切り替えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.AlignLeft選択範囲またはカーソルを含む行を左に揃えます。contenteditable="true" が必要です。(Qt 5.10 で追加)。
WebEngineView.AlignCenter選択範囲またはカーソルを含む行を中央に揃えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.AlignRight選択範囲またはカーソルを含む行を右に揃えます。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.AlignJustified選択範囲またはカーソルを含む行を、各行の幅が等しくなるように伸ばします。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.Indent選択範囲やカーソルを含む行をインデントします。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.Outdent選択範囲またはカーソルを含む行をアウトデントします。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.InsertOrderedList現在のカーソル位置に順序付きリストを挿入し、現在の選択範囲を削除します。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.InsertUnorderedList現在のカーソル位置に順序なしリストを挿入し、現在の選択範囲を削除します。contenteditable="true" が必要です。(Qt 5.10 で追加)
WebEngineView.ChangeTextDirectionLTRフォーカスされている入力要素のテキストの方向を左から右に変更します。(Qt 6.6 で追加)
WebEngineView.ChangeTextDirectionRTLフォーカスされている input 要素のテキストの方向を右から左に変更します。(Qt 6.6 で追加)。

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


activeFocusOnPress : bool [since QtWebEngine 1.2]

ビューが押されたときにアクティブフォーカスを得るかどうかを指定します。デフォルト値はtrue です。

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


audioMuted : bool [since QtWebEngine 1.3]

現在のページのオーディオがミュートされているかどうかの状態。

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

recentlyAudibleも参照してください


backgroundColor : color [since QtWebEngine 1.2]

WebEngineView ドキュメントの本文の後ろにある背景の色を変更します。"transparent" 、または半透明の色に設定することで、ドキュメントを透かして見たり、ハイブリッドアプリのウェブコンテンツに合わせて、読み込み中に表示される可能性のある白いフラッシュを防ぐことができます。

デフォルト値は白です。

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


canGoBack : bool [read-only]

以前のセッション履歴エントリがある場合はtrue を返し、そうでない場合はfalse を返します。


canGoForward : bool [read-only]

後続のセッション履歴エントリがある場合はtrue を、それ以外の場合はfalse を返します。


contentsSize : size [read-only, since QtWebEngine 1.3]

ページコンテンツのサイズ。

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


devToolsId : WebEngineView [read-only, since QtWebEngine 6.6]

このページに関連付けられている開発者ツールホストの ID。

リモートデバッグが有効になっている場合 (Qt WebEngine Developer Tools を参照)、この id を使用して開発者ツールのウェブソケットに接続する URL を作成できます:ws://localhost:<debugggin-port>/devtools/page/<id>) 。この Web ソケットは、DevTools プロトコルを使用してページと対話するために使用できます。

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


devToolsView : WebEngineView [since QtWebEngine 1.7]

このプロパティは、QtWebEngine 6.6で導入されました。このプロパティを新しいビューに設定すると、そのビューは開発者ツールのある内部 URL に移動し、このビューにバインドされます。

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

inspectedViewも参照してください


history : WebEngineHistory [read-only, since QtWebEngine 1.1]

現在のビューのナビゲーション履歴。

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

WebEngineHistory参照して ください。


icon : url [read-only]

ファビコンまたはショートカットアイコンとしても知られている、現在表示されている Web サイトアイコンにアクセスするための内部 URL。この読み取り専用URLは、モバイルブラウザアプリケーション内で、デバイスのホーム画面上にブックマークされたページを表すために使用される画像に対応します。

次のスニペットは、icon プロパティを使用して、Image コンポーネントを構築します:

Image {
    id: appIcon
    sourceSize: Qt.size(32, 32)
    source: webView.icon != "" ? webView.icon : "fallbackFavicon.png";
    // ...
}

Image::sourceSize プロパティを指定すると、Qt WebEngine のファビコン・プロバイダに要求されたサイズが通知され、アイコンのサイズが変更されます。Image::sourceSize プロパティが指定されていない場合、プロバイダは利用可能な最大の解像度でアイコンを提供します。


inspectedView : WebEngineView [since QtWebEngine 1.7]

このビューが現在表示しているビュー。このプロパティを設定すると、ビューセットの開発者ツールを持つ内部URLに移動します。

デベロッパーツールが表示されていない場合は、このプロパティを設定しないことをお勧めします。そうしないと、インスペクションされたWebEngineView にデバッグ情報が表示される可能性があります。

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

devToolsViewも参照してください


isFullScreen : bool [read-only, since QtWebEngine 1.1]

ウェブビューがフルスクリーンモードであればtrue を返し、そうでなければfalse を返します。

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

fullScreenRequested() およびfullScreenCancelled()も参照して ください。


lifecycleState : LifecycleState [since QtWebEngine 1.10]

ページの現在のライフサイクル状態。

セッターによって以下の制限が強制されます:

  • 可視ページはActive の状態を維持しなければなりません。
  • ページがdevToolsView によって検査されている場合、両方のページはActive 状態のままでなければなりません。
  • Discarded 状態のページはActive 状態にのみ遷移できる。これはページの再読み込みを引き起こす。

これらはライフサイクル状態に関する唯一のハード制限ですが、推奨されるソフト制限についてはrecommendedState も参照してください。

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

recommendedStatePage Lifecycle APIWebEngine Lifecycle Exampleも参照して ください。


loadProgress : int [read-only]

読み込まれたページのデータ量を、0 から100 までの整数パーセンテージで表します。


loading : bool [read-only]

HTML ページが現在読み込まれている場合はtrue を、そうでない場合はfalse を返します。


mainFrame : webEngineFrame [read-only, since QtWebEngine 6.8]

ページのメイン、トップレベルのフレーム。このページの他のすべてのフレームは、メインフレームの子としてアクセスできます。

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


profile : WebEngineProfile [since QtWebEngine 1.1]

ビューに使用されている現在のプロファイル。

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

WebEngineProfileも参照してください


recentlyAudible : bool [read-only, since QtWebEngine 1.3]

現在のページの可聴状態(オーディオが最近再生されたか、されていないか)を返します。

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

audioMuted およびrecentlyAudibleChanged参照して ください。


recommendedState : LifecycleState [read-only, since QtWebEngine 1.10]

ページのライフサイクル状態の推奨限界値。

ライフサイクル状態を推奨状態よりも低いリソース使用量に設定すると、バックグラウンドのオーディオ再生が停止したり、HTML フォームの入力が失われるなどの副作用が発生する可能性があります。しかし、ライフサイクル状態をより高いリソース状態に設定することは、完全に安全です。

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

lifecycleStatePage Lifecycle APIWebEngine Lifecycle Exampleも参照してください


renderProcessPid : qint64 [read-only, since QtWebEngine 1.11]

現在のページのメインフレームに割り当てられているレンダリングプロセスのプロセス ID(PID)を返します。

まだ利用可能なレンダープロセスがない場合は、0 が返されます。

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

renderProcessPidChangedも参照してください


scrollPosition : point [read-only, since QtWebEngine 1.3]

ページコンテンツのスクロール位置。

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


settings : WebEngineSettings [read-only, since QtWebEngine 1.1]

このビューで使用される設定。

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

WebEngineSettingsも参照してください


title : string [read-only]

現在表示されている HTML ページのタイトル。これは、<title> タグの内容を反映した読み取り専用の値です。


touchHandleDelegate : Component [since QtWebEngine 6.4]

touchHandleDelegate は、タッチ選択ハンドリングが必要なときにビューによってインスタンス化されるビジュアルタッチハンドルを定義するテンプレートを提供します。

ハンドルの位置、不透明度、可視性は自動的に更新されます。デリゲートはQMLアイテムまたはそれを継承するQMLタイプでなければなりません。

注意: QMLアイテムが設定されていない場合、デフォルトのタッチハンドルが表示されます。

以下のコードではカスタムタッチハンドルデリゲートを使用しています:

WebEngineView {
// ...
    touchHandleDelegate: Rectangle {
        color: "red"
    }
    // ...
}

タッチハンドルは動的に切り替えることもできます:

 Component {
    id: circleTouchHandle
    Rectangle {
        color: "blue"
        radius: 50
    }
}
function showDefaultHandle(isDefault) {
    if (isDefault)
        webEngineView.touchHandleDelegate = circleTouchHandle
    else
        webEngineView.touchHandleDelegate = null
}

注意: デリゲートが設定されていない場合、Chromiumのデフォルトのタッチハンドルが表示されます。

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


url : url

現在表示されている HTML ページの場所。この書き込み可能なプロパティは、ウェブビューにページをロードするためのメインインターフェイスを提供します。window.location DOMプロパティと同じ働きをします。

loadHtml()も参照


userScripts : WebEngineScriptCollection [read-only, since QtWebEngine 1.1]

ビューに関連付けられたユーザースクリプトのコレクション。

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

WebEngineScriptCollection参照して ください。


webChannel : QQmlWebChannel [since QtWebEngine 1.1]

このビューが使用するウェブチャネルのインスタンス。このチャネルは、自動的に Chromium IPC を介した内部QtWebEngine トランスポートメカニズムを使用し、レンダリングしているページの javascript コンテキストでqt.webChannelTransport として公開されます。このトランスポートオブジェクトは、Qt WebChannel JavaScript API を使用してQWebChannel の JavaScript 対応部分をインスタンス化するときに使用されます。

注意: ビューは、割り当てられた webChannel オブジェクトの所有権を持ちません。

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


webChannelWorld : int [since QtWebEngine 1.3]

このビューが使用する Web チャネルインスタンスがインストールされている JavaScript のワールド。world は0 から256 の間の数字でなければなりません。

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


zoomFactor : real [since QtWebEngine 1.1]

ビューのズーム係数。有効な値は0.25 から5.0 の範囲です。デフォルトの係数は1.0 です。

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


シグナルの説明

[since QtWebEngine 1.2] activeFocusOnPressChanged(bool activeFocusOnPress)

このシグナルは、activeFocusOnPress の値が変化した時に発行されます。このシグナルは、ビューが押されたときにアクティブフォーカスを得るかどうかを指定します。

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

このシグナルは QtWebEngine 1.2 で導入されました。

activeFocusOnPresssetActiveFocusOnPress()も参照してください


[since QtWebEngine 1.3] audioMutedChanged(bool muted)

このシグナルは、muted の値が変更されたときに発行されます。値はaudioMuted プロパティで指定します。

: 特定の HTML5 audio / video 要素がミュートされることと混同しないでください。

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

このシグナルは QtWebEngine 1.3 で導入されました。

audioMuted およびrecentlyAudibleChangedも参照して ください。


[since QtWebEngine 1.4] authenticationDialogRequested(AuthenticationDialogRequest request)

このシグナルは、認証ダイアログが要求されたときに発行されます。

request は、AuthenticationDialogRequest タイプのメソッドを使用して処理できます。

注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。その後に必ずAuthenticationDialogRequest::dialogAccept() またはAuthenticationDialogRequest::dialogReject() をコールしてください。

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

このシグナルは QtWebEngine 1.4 で導入されました。


[since QtWebEngine 1.2] backgroundColorChanged()

このシグナルは、Webエンジンのビューの背景色が変更されたときに発行されます。

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

このシグナルは QtWebEngine 1.2 で導入されました。


[since QtWebEngine 1.1] certificateError(WebEngineCertificateError error)

このシグナルは、リクエストのロード中に無効な証明書エラーerror が発生したときに発行されます。

証明書エラーは、WebEngineCertificateError 型のメソッドを使用して処理できます。

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

このシグナルは QtWebEngine 1.1 で導入されました。


[since QtWebEngine 1.4] colorDialogRequested(ColorDialogRequest request)

このシグナルは、カラーピッカーダイアログが要求されたときに発せられます。

request は、ColorDialogRequest タイプのメソッドを使用して処理できます。

注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。その後に必ずColorDialogRequest::dialogAccept() かColorDialogRequest::dialogReject() をコールしてください。

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

このシグナルは QtWebEngine 1.4 で導入されました。


[since QtWebEngine 1.4] contextMenuRequested(ContextMenuRequest request)

このシグナルはコンテキストメニューが要求されたときに発せられます。

request は、ContextMenuRequest タイプのプロパティを使用して処理できます。

注意: デフォルトのコンテキストメニューが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。

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

このシグナルは QtWebEngine 1.4 で導入されました。


[since QtWebEngine 1.4] fileDialogRequested(FileDialogRequest request)

このシグナルは、ファイルピッカーダイアログが要求されたときに発せられます。

request は、FileDialogRequest タイプのメソッドを使用して処理できます。

注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。その後に必ずFileDialogRequest::dialogAccept() またはFileDialogRequest::dialogReject() をコールしてください。

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

このシグナルは QtWebEngine 1.4 で導入されました。


[since QtWebEngine 1.10] findTextFinished(FindTextResult result)

このシグナルは、ページ上の文字列検索が完了したときに発行されます。result は文字列検索の結果です。

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

このシグナルは QtWebEngine 1.10 で導入されました。

findText() およびFindTextResultも参照してください


[since QtWebEngine 1.1] fullScreenRequested(FullScreenRequest request)

このシグナルは、ウェブページが JavaScript API を通してフルスクリーンモード用のrequest を発行したときに発せられます。

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

このシグナルは QtWebEngine 1.1 で導入されました。

isFullScreenも参照してください


[since QtWebEngine 1.7] geometryChangeRequested(rect geometry, rect frameGeometry)

このシグナルは、ドキュメントがページの位置とサイズをframeGeometry に変更したいときに発行されます。

frameGeometry はフレームのマージンを含みますが、geometry はフレームのマージンを除きます。

注意: QML Windowのジオメトリ関連のプロパティはウィンドウの装飾を除いたサイズを期待します。このシグナルを正しく扱うにはgeometry を使用する必要があります。

onGeometryChangeRequested: {
    window.x = geometry.x
    window.y = geometry.y
    window.width = geometry.width
    window.height = geometry.height
}

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

このシグナルは QtWebEngine 1.7 で導入されました。


javaScriptConsoleMessage(JavaScriptConsoleMessageLevel level, string message, int lineNumber, string sourceID)

このシグナルは、JavaScriptプログラムがWebブラウザのコンソールにmessage

例えば、評価エラーの場合、ソース URL はlineNumber と同様にsourceID で提供されるかもしれません。

level は、メッセージのトリガーとなったイベントの重大度、つまりエラーによってトリガーされたのか、それほど重大でないイベントによってトリガーされたのかを示します。

ハンドラが指定されない場合、ビューはメッセージをjs logging category に記録します。

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

Console Loggingも参照してください


[since QtWebEngine 1.4] javaScriptDialogRequested(JavaScriptDialogRequest request)

このシグナルはJavaScriptのダイアログが要求されたときに発せられます。

requestJavaScriptDialogRequest タイプのメソッドで処理できます。

注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。その後に必ずJavaScriptDialogRequest::dialogAccept() かJavaScriptDialogRequest::dialogReject() をコールしてください。

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

このシグナルは QtWebEngine 1.4 で導入されました。


linkHovered(url hoveredUrl)

マウス駆動インターフェースでは、このシグナルはマウスポインタがリンクの上を通過したときに発せられます。mouseover DOM イベントに対応します。このイベントは、preventDefault() でキャンセルされなかったmouseover イベントに対して、タッチインタフェースでも発生する可能性があります。hoveredUrl はリンクの位置を提供します。

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


loadingChanged(WebEngineLoadingInfo loadingInfo)

このシグナルは、ページのロードが開始、終了、または失敗したときに発せられます。

このシグナルをonLoadingChanged で処理する場合、loadingInfo で指定されたWebEngineLoadingInfo で、さまざまな読み取り専用パラメータが利用できる。

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

loadingLoadStatusErrorDomainも参照のこと


このシグナルは、ナビゲーション・リクエストrequest が発行されたときに発せられる。

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


[since QtWebEngine 2.0] newWindowRequested(WebEngineNewWindowRequest request)

このシグナルは、request が発行され、別のウェブエンジン・ビューにページがロードされたときに発行されます。これは、現在のページがwindow.open への JavaScript 呼び出しによって明示的に要求したため、またはユーザーが Shift、Ctrl、または新しいウィンドウでページを開くトリガーとなる組み込みの組み合わせを押しながらリンクをクリックしたためです。

このシグナルは、デスティネーション・ビューでacceptAsNewWindow ()を呼び出すことで処理される。このシグナルが処理されない場合、要求されたロードは失敗します。

実装例です:

QtObject {
    id: windowParent
    // Create the initial browsing windows and open the startup page.
    Component.onCompleted: {
        var firstWindow = windowComponent.createObject(windowParent);
        firstWindow.webView.loadHtml('<input type="button" value="Click!" onclick="window.open(&quot;http://qt.io&quot;)">');
    }

    property Component windowComponent: Window {
        // Destroy on close to release the Window's QML resources.
        // Because it was created with a parent, it won't be garbage-collected.
        onClosing: destroy()
        visible: true

        property WebEngineView webView: webView_
        WebEngineView {
            id: webView_
            anchors.fill: parent

            // Handle the signal. Dynamically create the window and
            // use its WebEngineView as the destination of our request.
            onNewWindowRequested: function(request) {
                var newWindow = windowComponent.createObject(windowParent);
                newWindow.webView.acceptAsNewWindow(request);
            }
        }
    }
}

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

このシグナルは QtWebEngine 2.0 で導入されました。

WebEngineNewWindowRequest およびWebEngine Quick Nano Browserも参照してください


[since QtWebEngine 1.5] pdfPrintingFinished(string filePath, bool success)

このシグナルは、ウェブページのPDFファイルへの印刷が終了したときに発行されます。filePath には、ファイルの作成が要求されたパスが格納され、success には、ファイルの作成に成功した場合はtrue が、そうでない場合はfalse が格納されます。

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

このシグナルは QtWebEngine 1.5 で導入されました。

printToPdf()も参照してください


[since QtWebEngine 6.8] permissionRequested(webEnginePermission permission)

このシグナルは、Webサイトがパーミッション要求(例:ジオロケーションアクセス、通知の送信許可)を発行したときに発行されます。permission 、要求しているURLとWebEnginePermission.PermissionType 、パーミッションの許可・不許可を問い合わせることができます。

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

このシグナルは QtWebEngine 6.8 で導入されました。


[since QtWebEngine 1.8] printRequested()

このシグナルは、メインフレーム上でJavaScriptwindow.print() メソッドが呼び出されたとき、またはユーザーがPDFビューアープラグインの印刷ボタンを押したときに発せられます。通常、シグナルハンドラは単純にprintToPdf() を呼び出すことができます。

QtWebEngine 6.8以降、このシグナルは、印刷を要求するどのフレームに対しても発せられるのではなく、メインフレームに対してのみ発せられるようになりました。

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

このシグナルは QtWebEngine 1.8 で導入されました。

printToPdfも参照してください


[since QtWebEngine 6.8] printRequestedByFrame(webEngineFrame frame)

このシグナルは、JavaScript のwindow.print() メソッドがframe で呼び出されたときに出力されます。フレームがメインフレームの場合、代わりにprintRequested が発行されます。

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

このシグナルは QtWebEngine 6.8 で導入されました。

printRequestedも参照してください


[since QtWebEngine 1.3] recentlyAudibleChanged(bool recentlyAudible)

このシグナルは、recentlyAudible で指定されたページの可聴状態が、オーディオの再生や停止によって変更されたときに発行されます。

注: このシグナルは、audioMuted プロパティが変更されたときにも発行されます。また、オーディオが一時停止された場合、このシグナルは、オーディオが一時停止された瞬間から約2秒遅れて発信されます。

ウェブページに2つの動画が含まれ、それが順番に開始される場合、このシグナルは、最初の動画が音を発生するときに1回だけ発せられます。両方の動画が停止した後、最後に音が発生した時点で信号が発せられる。つまり、音声ストリームの数に関係なく、ウェブページ内で何らかの音が発生したときも、すべてが完全に無音になったときも、この信号が発せられることになります。

また、信号のスプリアスも発生する可能性があります。例えば、サウンドが停止すると、このシグナルはまずtrue という値で発せられ、次にfalse という値で発せられます。さらに、オーディオの再生が始まると、このシグナルはtrue という値で2回発せられます。

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

このシグナルは QtWebEngine 1.3 で導入されました。

recentlyAudibleも参照してください


[since QtWebEngine 1.7] registerProtocolHandlerRequested(RegisterProtocolHandlerRequest request)

このシグナルは、ウェブページがregisterProtocolHandler request を発行してカスタムプロトコルを登録しようとしたときに発行されます。

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

このシグナルは QtWebEngine 1.7 で導入されました。

RegisterProtocolHandlerRequestも参照してください


[since QtWebEngine 1.11] renderProcessPidChanged(qint64 pid)

レンダリングプロセスがまだない場合、0 が返されます。このシグナルは、ページの基礎となるレンダリングプロセスのpid (プロセス ID) が変更されたときに発行されます。

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

このシグナルは QtWebEngine 1.11 で導入されました。

renderProcessPidも参照してください


[since QtWebEngine 1.2] renderProcessTerminated(RenderProcessTerminationStatus terminationStatus, int exitCode)

このシグナルは、レンダープロセスがゼロ以外の終了ステータスで終了したときに発行されます。terminationStatus はプロセスの終了ステータス、exitCode はプロセスが終了したステータスコードです。

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

このシグナルは QtWebEngine 1.2 で導入されました。

RenderProcessTerminationStatusも参照してください


[since QtWebEngine 1.9] selectClientCertificate(WebEngineClientCertificateSelection clientCertificateSelection)

このシグナルは、WebサイトがSSLクライアント証明書を要求し、システムのクライアント証明書ストアに1つ以上の証明書が見つかったときに発行されます。

このシグナルの処理は非同期で、証明書が選択されるか、clientCertificateSelection の最後のコピーが破棄されるまでロードが待機します。

シグナルが処理されない場合、clientCertificateSelection は自動的に破棄され、ローディングはクライアント証明書なしで続行される。

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

このシグナルは QtWebEngine 1.9 で導入されました。

WebEngineClientCertificateSelectionも参照してください


[since QtWebEngine 1.10] tooltipRequested(TooltipRequest request)

このシグナルは、Web ページが指定された位置にツールチップを表示するためにrequest を送信したときに発行されます。

注意: デフォルトのツールチップが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要があります。

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

このシグナルは QtWebEngine 1.10 で導入されました。

TooltipRequestも参照してください


[since QtWebEngine 6.3] touchSelectionMenuRequested(TouchSelectionMenuRequest *request)

このシグナルは、指定した位置でタッチ選択メニューが要求されたときに発せられます。

request は、TouchSelectionMenuRequest タイプのメソッドを使用して処理できる。

注: デフォルトのタッチ選択メニューが表示されないようにするには、シグナルハンドラがrequest.accepted = true を呼び出す必要がある。

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

このシグナルは QtWebEngine 6.3 で導入されました。

TouchSelectionMenuRequestも参照してください


[since QtWebEngine 1.3] wasRecentlyAudibleChanged(bool wasRecentlyAudible)

このシグナルは、wasRecentlyAudible で指定されたページの可聴状態が、オーディオの再生や停止によって変更されたときに発行されます。

注: このシグナルは、setAudioMuted メソッドを呼び出したときにも出力されます。

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

このシグナルは QtWebEngine 1.3 で導入されました。


[since QtWebEngine 6.7] webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

このシグナルは、WebAuth 認証機能が認証プロセス中にユーザとの対話を要求したときに発行されます。これらのリクエストは、ユーザにダイアログを表示することで処理されます。

request には、WebAuth UX リクエストを完了するために必要な情報と API が含まれています。

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

このシグナルは QtWebEngine 6.7 で導入されました。

QWebEngineWebAuthUxRequestも参照してください


[since QtWebEngine 1.2] windowCloseRequested()

このシグナルは、JavaScript のwindow.close() 呼び出しなどで、ページが Web ブラウザのウィンドウを閉じるよう要求するたびに発行されます。

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

このシグナルは QtWebEngine 1.2 で導入されました。


[since QtWebEngine 6.8] zoomFactorChanged(qreal factor)

このシグナルは、ページのズームfactor が変更されるたびに発行されます。

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

このシグナルは QtWebEngine 6.8 で導入されました。

zoomFactorも参照してください


メソッドの説明

void runJavaScript(string script, int worldId, variant callback)

void runJavaScript(string script, variant callback)

ウェブビューのコンテンツで指定されたscript を実行します。

callback パラメータはオプションです。コールバック関数が指定されている場合は、スクリプトの実行終了後に呼び出されます。

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

結果値として JavaScript から返されるのは、プレーン データのみです。サポートされるデータ型には、すべてのJSONデータ型のほか、たとえばDateArrayBuffer があります。サポートされていないデータ型には、FunctionPromise などがあります。

ページ上で実行される他のスクリプトとの衝突を避けるため、スクリプトが実行されるワールドはworldId で指定できる。ワールドIDは0256 の間でなければならない。world IDを省略すると、スクリプトはMainWorld で実行される。

警告: ウェブ・コンテンツのレンダリングがブロックされる可能性があるため、コールバック関数内で長いルーチンを実行しないでください。

スクリプトの注入の詳細については、スクリプトの注入を参照してください。スクリプトを注入する別の方法については、WebEngineView::userScripts を参照してください。


[since QtWebEngine 2.0] void acceptAsNewWindow(QWebEngineNewWindowRequest *request)

このビューでrequest を開き、newWindowRequested シグナルを処理します。

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

newWindowRequestedも参照してください


WebEngineAction action(WebAction action)

指定されたWebAction action に対するWebEngineAction を返します。WebEngineView はアクションの実装も行い、トリガー時に対応するアクションがビューで実行されるようにします。

var copyAction = webEngineView.action(WebEngineView.Copy);

WebEngineAction参照して ください。


[since QtWebEngine 6.8] webEngineFrame findFrameByName(string name)

指定されたname を持つフレームを返します。同じ名前のフレームが複数ある場合、どれを返すかは任意です。フレームが見つからなかった場合は、invalid のフレームを返します。

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


[since QtWebEngine 1.1] void findText(string subString)

指定された文字列subString をページ内で検索します。文字列の検索が完了すると、findTextFinished() シグナルが発行されます。

検索ハイライトを消去するには、空の文字列を渡します。

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

findTextFinished()も参照してください


[since QtWebEngine 1.1] void findText(string subString, FindFlags options)

指定された文字列options を使用して、ページ内の指定された文字列subString を検索します。findTextFinished() シグナルは、文字列検索が完了したときに発せられます。

検索ハイライトを消去するには、空の文字列を渡します。

findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);

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

findTextFinished()も参照してください


[since QtWebEngine 1.1] void findText(string subString, FindFlags options, variant resultCallback)

指定された文字列options を使用して、ページ内の指定された文字列subString を検索します。findTextFinished() シグナルは、文字列検索が完了したときに発せられます。

検索ハイライトを消去するには、空の文字列を渡します。

resultCallback は整数のパラメータを取らなければならない。このシグナルは、subString で見つかった出現回数とともに呼び出されます。

findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) {
    if (matchCount > 0)
        console.log("'Qt' tokens found:", matchCount);
});

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

findTextFinished()も参照してください


[since QtWebEngine 1.1] void fullScreenCancelled()

即座にisFullScreen プロパティをfalse に設定します。 ウィンドウシステムがアプリケーションをフルスクリーンモードから強制的に離脱させるときに、ブラウザエンジンに通知するために使用できます。

ApplicationWindow {
    onVisibilityChanged: {
        if (webEngineView.isFullScreen && visibility != Window.FullScreen)
            webEngineView.fullScreenCancelled()
    }

    WebEngineView {
        id: webEngineView
        // ...
    }
}

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

isFullScreenfullScreenRequested()も参照してください


void goBack()

可能であれば、ブラウザのセッション履歴を後戻りします。この関数はwindow.history.back() DOM メソッドと同等です。

canGoBackも参照


[since QtWebEngine 1.1] void goBackOrForward(int offset)

offset が正の場合、現在のセッション履歴内で指定したオフセットページ数分進む。offsetが負の場合は戻る。offset が無効な場合、ページは変更されません。

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

goBack() およびgoForward()も参照してください


void goForward()

可能であれば、ブラウザのセッション履歴内を進みます。この関数はwindow.history.forward() DOM メソッドと同等です。


void loadHtml(string html, url baseUrl)

指定されたhtml をウェブ・ビューのコンテンツとして読み込みます。

このメソッドは、URL 経由で HTML ページを参照するurl プロパティに代わる低レベルの代替手段を提供します。

baseUrl はオプションで、参照される画像やスタイルシートなど、ドキュメント内の相対 URL を解決するために使用されます。例えば、 がベースURLである から取得される場合、相対URLである で参照される画像は にあるはずです。html http://www.example.com/documents/overview.html diagram.png http://www.example.com/documents/diagram.png

urlも参照のこと


[since QtWebEngine 1.3] void printToPdf(const string filePath, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation)

WebEngineView のカ レ ン ト 内容を PDF 文書へ印字 し 、 それをfilePath の下に格納 し ます。文書のサ イ ズはpageSizeId の値で決定 さ れ、 その向き はorientation で決定 さ れます。

こ の メ ソ ッ ド は、 Web ページ を PDF へ印刷す る ための非同期要求を発行 し 、 ただちに返 り ます。リクエストの結果を知るには、シグナルpdfPrintingFinished() に接続します。

pageSizeId を省略すると、デフォルトはA4 になります。orientation を省略すると、デフォルトはPortrait になります。

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

pdfPrintingFinished()も参照してください


[since QtWebEngine 1.3] void printToPdf(variant resultCallback, PrintedPageSizeId pageSizeId, PrintedPageOrientation orientation)

WebEngineView の現在の内容を PDF ドキュメントに印刷し、バイト配列で返します。文書のサ イ ズはpageSizeId の値で決定 さ れ、 その向き はorientation で決定 さ れます。

resultCallback は文字列パ ラ メ タ を と る 必要があ り ます。この文字列には、印刷に成功した場合はドキュメントのデータが格納され、そうでない場合は空の文字列が格納されます。

pageSizeId を省略すると、デフォルトはA4 になります。orientation を省略すると、デフォルトはPortrait になります。

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


void reload()

現在のページをリロードします。この関数はwindow.location.reload() DOM メソッドと同等です。

reloadAndBypassCache()も参照してください


[since QtWebEngine 1.1] void reloadAndBypassCache()

現在のページをリロードし、キャッシュされたコンテンツは無視します。

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

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


[since QtWebEngine 1.3] void replaceMisspelledWord(const QString &replacement)

現在のスペルミスの単語をreplacement で置き換えます。

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


[since QtWebEngine 6.6] void save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format)

現在のウェブページをディスクに保存します。

ウェブページは、指定されたformatfilePath に保存されます。

これは以下のアクションのショートカットです:

  • Save Web アクションをトリガーします。
  • 次のダウンロード項目を受け入れ、指定されたファイルパスと 保存形式を設定します。

この関数は、Web ページに対して非同期ダウンロード要求を発行し、すぐに戻ります。

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

QWebEngineDownloadRequest::SavePageFormatも参照してください


[since QtWebEngine 1.2] void setActiveFocusOnPress(bool arg)

argtrue の場合、クリックした Web エンジンビューにアクティブフォーカスを設定します。false に設定することで、フォーカスを得るべきでない UI 要素を Web エンジンビューで作成することができます。これはハイブリッド UI で便利です。

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

activeFocusOnPressactiveFocusOnPressChangedWebEngineSettings::focusOnNavigationEnabledも参照してください


void stop()

現在のページの読み込みを停止します。


[since QtWebEngine 1.2] void triggerWebAction(WebAction action)

Web アクションaction をトリガーします。

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

WebActionも参照してください


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