WebEngineView QML Type
WebEngineView は、QML アプリケーション内で Web コンテンツをレンダリングします。詳細...
Import Statement: | import QtWebEngine |
Since: | QtWebEngine 1.0 |
Inherits: |
プロパティ
- ErrorDomain : enumeration
- FindFlags : enumeration
- JavaScriptConsoleMessageLevel : enumeration
- LifecycleState : enumeration
(since QtWebEngine 1.10)
- LoadStatus : enumeration
- PrintedPageOrientation : enumeration
(since QtWebEngine 1.3)
- PrintedPageSizeId : enumeration
(since QtWebEngine 1.3)
- RenderProcessTerminationStatus : enumeration
(since QtWebEngine 1.2)
- WebAction : enumeration
(since QtWebEngine 1.2)
- activeFocusOnPress : bool
(since QtWebEngine 1.2)
- audioMuted : bool
(since QtWebEngine 1.3)
- backgroundColor : color
(since QtWebEngine 1.2)
- canGoBack : bool
- canGoForward : bool
- contentsSize : size
(since QtWebEngine 1.3)
- devToolsId : WebEngineView
(since QtWebEngine 6.6)
- devToolsView : WebEngineView
(since QtWebEngine 1.7)
- history : WebEngineHistory
(since QtWebEngine 1.1)
- icon : url
- inspectedView : WebEngineView
(since QtWebEngine 1.7)
- isFullScreen : bool
(since QtWebEngine 1.1)
- lifecycleState : LifecycleState
(since QtWebEngine 1.10)
- loadProgress : int
- loading : bool
- mainFrame : webEngineFrame
(since QtWebEngine 6.8)
- profile : WebEngineProfile
(since QtWebEngine 1.1)
- recentlyAudible : bool
(since QtWebEngine 1.3)
- recommendedState : LifecycleState
(since QtWebEngine 1.10)
- renderProcessPid : qint64
(since QtWebEngine 1.11)
- scrollPosition : point
(since QtWebEngine 1.3)
- settings : WebEngineSettings
(since QtWebEngine 1.1)
- title : string
- touchHandleDelegate : Component
(since QtWebEngine 6.4)
- url : url
- userScripts : WebEngineScriptCollection
(since QtWebEngine 1.1)
- webChannel : QQmlWebChannel
(since QtWebEngine 1.1)
- webChannelWorld : int
(since QtWebEngine 1.3)
- zoomFactor : real
(since QtWebEngine 1.1)
シグナル
- activeFocusOnPressChanged(bool activeFocusOnPress)
(since QtWebEngine 1.2)
- audioMutedChanged(bool muted)
(since QtWebEngine 1.3)
- authenticationDialogRequested(AuthenticationDialogRequest request)
(since QtWebEngine 1.4)
- backgroundColorChanged()
(since QtWebEngine 1.2)
- certificateError(WebEngineCertificateError error)
(since QtWebEngine 1.1)
- colorDialogRequested(ColorDialogRequest request)
(since QtWebEngine 1.4)
- contextMenuRequested(ContextMenuRequest request)
(since QtWebEngine 1.4)
- fileDialogRequested(FileDialogRequest request)
(since QtWebEngine 1.4)
- findTextFinished(FindTextResult result)
(since QtWebEngine 1.10)
- fullScreenRequested(FullScreenRequest request)
(since QtWebEngine 1.1)
- geometryChangeRequested(rect geometry, rect frameGeometry)
(since QtWebEngine 1.7)
- javaScriptConsoleMessage(JavaScriptConsoleMessageLevel level, string message, int lineNumber, string sourceID)
- javaScriptDialogRequested(JavaScriptDialogRequest request)
(since QtWebEngine 1.4)
- linkHovered(url hoveredUrl)
- loadingChanged(WebEngineLoadingInfo loadingInfo)
- navigationRequested(WebEngineNavigationRequest request)
- newWindowRequested(WebEngineNewWindowRequest request)
(since QtWebEngine 2.0)
- pdfPrintingFinished(string filePath, bool success)
(since QtWebEngine 1.5)
- permissionRequested(webEnginePermission permission)
(since QtWebEngine 6.8)
- printRequested()
(since QtWebEngine 1.8)
- printRequestedByFrame(webEngineFrame frame)
(since QtWebEngine 6.8)
- recentlyAudibleChanged(bool recentlyAudible)
(since QtWebEngine 1.3)
- registerProtocolHandlerRequested(RegisterProtocolHandlerRequest request)
(since QtWebEngine 1.7)
- renderProcessPidChanged(qint64 pid)
(since QtWebEngine 1.11)
- renderProcessTerminated(RenderProcessTerminationStatus terminationStatus, int exitCode)
(since QtWebEngine 1.2)
- selectClientCertificate(WebEngineClientCertificateSelection clientCertificateSelection)
(since QtWebEngine 1.9)
- tooltipRequested(TooltipRequest request)
(since QtWebEngine 1.10)
- touchSelectionMenuRequested(TouchSelectionMenuRequest *request)
(since QtWebEngine 6.3)
- wasRecentlyAudibleChanged(bool wasRecentlyAudible)
(since QtWebEngine 1.3)
- webAuthUxRequested(QWebEngineWebAuthUxRequest *request)
(since QtWebEngine 6.7)
- windowCloseRequested()
(since QtWebEngine 1.2)
- zoomFactorChanged(qreal factor)
(since QtWebEngine 6.8)
メソッド
- 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.InternalErrorDomain | Qt WebEngine によるコンテンツの解釈に失敗しました。 |
WebEngineView.ConnectionErrorDomain | ネットワーク接続の不具合によるエラー。 |
WebEngineView.CertificateErrorDomain | SSL/TLS 証明書に関するエラー。 |
WebEngineView.HttpErrorDomain | HTTP 接続に関するエラー。 |
WebEngineView.FtpErrorDomain | FTP 接続に関するエラー。 |
WebEngineView.DnsErrorDomain | DNS 接続に関するエラー。 |
FindFlags : enumeration |
JavaScriptConsoleMessageLevel : enumeration |
JavaScript のコンソール・メッセージの重大度を示します:
定数 | 説明 |
---|---|
WebEngineView.InfoMessageLevel | メッセージは純粋に参考情報であり、無視しても問題ありません。 |
WebEngineView.WarningMessageLevel | メッセージは注意が必要な問題があることを示しています。 |
WebEngineView.ErrorMessageLevel | Message はエラーが発生したことを示します。 |
LifecycleState : enumeration |
この列挙型は、ページのライフサイクル状態を記述します:
定数 | 説明 |
---|---|
WebEngineView.LifecycleState.Active | 通常状態。 |
WebEngineView.LifecycleState.Frozen | ほとんどのHTMLタスクソースが中断される、CPU使用率が低い状態。 |
WebEngineView.LifecycleState.Discarded | 閲覧コンテキスト全体が破棄される、リソース使用率が非常に低い状態。 |
このプロパティは QtWebEngine 1.10 で導入されました。
lifecycleState 、Page Lifecycle API 、WebEngine Lifecycle Exampleも参照してください 。
LoadStatus : enumeration |
ページのロード状態を反映します:
定数 | 説明 |
---|---|
WebEngineView.LoadStartedStatus | ページの読み込み中。 |
WebEngineView.LoadStoppedStatus | ページの読み込みは、stop ()メソッド、または Chromium のローダーコードやネットワークスタックによって停止されました。 |
WebEngineView.LoadSucceededStatus | ページは正常にロードされ、現在はロードされていません。 |
WebEngineView.LoadFailedStatus | ページの読み込みに失敗し、現在読み込み中ではありません。 |
PrintedPageOrientation : enumeration |
WebEngineView の内容から作成される PDF 文書の向きを記述します。列挙値はQPageLayout::Orientation からマップされ、 と一致しなければならない。
定数 | 説明 |
---|---|
WebEngineView.Portrait | ドキュメントは縦向きで作成されます。 |
WebEngineView.Landscape | ドキュメントは横向きで作成されます。 |
このプロパティは QtWebEngine 1.3 で導入されました。
WebEngineView::printToPdf()も参照してください 。
PrintedPageSizeId : enumeration |
この列挙型は、Postscript PPD 標準で定義されている、利用可能なページサイズを列挙します。
列挙値はQPageSize::PageSizeId からマッピングされ、 と一致しなければなりません。これらはQPagedPaintDevice とQPrinter にも重複している。
定義されているサイズは以下のとおりです:
定数 | 説明 |
---|---|
WebEngineView.A0 | 841 x 1189 mm |
WebEngineView.A1 | 594 x 841 mm |
WebEngineView.A2 | 420 x 594 mm |
WebEngineView.A3 | 297 x 420 mm |
WebEngineView.A4 | 210 x 297 mm、8.26 x 11.69インチ |
WebEngineView.A5 | 148 x 210 mm |
WebEngineView.A6 | 105 x 148 mm |
WebEngineView.A7 | 74 x 105 mm |
WebEngineView.A8 | 52 x 74 mm |
WebEngineView.A9 | 37 x 52 mm |
WebEngineView.B0 | 1000 x 1414 mm |
WebEngineView.B1 | 707 x 1000 mm |
WebEngineView.B2 | 500 x 707 mm |
WebEngineView.B3 | 353 x 500 mm |
WebEngineView.B4 | 250 x 353 mm |
WebEngineView.B5 | 176 x 250 mm、6.93 x 9.84インチ |
WebEngineView.B6 | 125 x 176 mm |
WebEngineView.B7 | 88 x 125 mm |
WebEngineView.B8 | 62 x 88 mm |
WebEngineView.B9 | 44 x 62 mm |
WebEngineView.B10 | 31 x 44 mm |
WebEngineView.C5E | 163 x 229 mm |
WebEngineView.Comm10E | 105 x 241 mm、米国共通10封筒 |
WebEngineView.DLE | 110 x 220 mm |
WebEngineView.Executive | 7.5 x 10インチ、190.5 x 254 mm |
WebEngineView.Folio | 210 x 330 mm |
WebEngineView.Ledger | 431.8 x 279.4 mm |
WebEngineView.Legal | 8.5 x 14インチ、215.9 x 355.6 mm |
WebEngineView.Letter | 8.5 x 11インチ、215.9 x 279.4 mm |
WebEngineView.Tabloid | 279.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 |
レンダリングプロセスが終了したステータスを記述します:
定数 | 説明 |
---|---|
WebEngineView.NormalTerminationStatus | レンダリングプロセスが正常に終了した。 |
WebEngineView.AbnormalTerminationStatus | レンダープロセスは、ゼロ以外の終了ステータスで終了しました。 |
WebEngineView.CrashedTerminationStatus | レンダープロセスは、セグメンテーションフォールトなどでクラッシュした。 |
WebEngineView.KilledTerminationStatus | レンダープロセスがSIGKILL やタスクマネージャの kill などで強制終了した。 |
このプロパティは QtWebEngine 1.2 で導入されました。
WebAction : enumeration |
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 |
ビューが押されたときにアクティブフォーカスを得るかどうかを指定します。デフォルト値はtrue
です。
このプロパティは QtWebEngine 1.2 で導入されました。
audioMuted : bool |
backgroundColor : color |
WebEngineView ドキュメントの本文の後ろにある背景の色を変更します。"transparent"
、または半透明の色に設定することで、ドキュメントを透かして見たり、ハイブリッドアプリのウェブコンテンツに合わせて、読み込み中に表示される可能性のある白いフラッシュを防ぐことができます。
デフォルト値は白です。
このプロパティは QtWebEngine 1.2 で導入されました。
canGoBack : bool |
以前のセッション履歴エントリがある場合はtrue
を返し、そうでない場合はfalse
を返します。
canGoForward : bool |
後続のセッション履歴エントリがある場合はtrue
を、それ以外の場合はfalse
を返します。
contentsSize : size |
ページコンテンツのサイズ。
このプロパティは QtWebEngine 1.3 で導入されました。
devToolsId : WebEngineView |
このページに関連付けられている開発者ツールホストの ID。
リモートデバッグが有効になっている場合 (Qt WebEngine Developer Tools を参照)、この id を使用して開発者ツールのウェブソケットに接続する URL を作成できます:ws://localhost:<debugggin-port>/devtools/page/<id>)
。この Web ソケットは、DevTools プロトコルを使用してページと対話するために使用できます。
このプロパティは QtWebEngine 6.6 で導入されました。
devToolsView : WebEngineView |
このプロパティは、QtWebEngine 6.6で導入されました。このプロパティを新しいビューに設定すると、そのビューは開発者ツールのある内部 URL に移動し、このビューにバインドされます。
このプロパティは QtWebEngine 1.7 で導入されました。
inspectedViewも参照してください 。
history : WebEngineHistory |
icon : url |
ファビコンまたはショートカットアイコンとしても知られている、現在表示されている 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 |
このビューが現在表示しているビュー。このプロパティを設定すると、ビューセットの開発者ツールを持つ内部URLに移動します。
デベロッパーツールが表示されていない場合は、このプロパティを設定しないことをお勧めします。そうしないと、インスペクションされたWebEngineView にデバッグ情報が表示される可能性があります。
このプロパティは QtWebEngine 1.7 で導入されました。
devToolsViewも参照してください 。
isFullScreen : bool |
ウェブビューがフルスクリーンモードであればtrue
を返し、そうでなければfalse
を返します。
このプロパティは QtWebEngine 1.1 で導入されました。
fullScreenRequested() およびfullScreenCancelled()も参照して ください。
lifecycleState : LifecycleState |
ページの現在のライフサイクル状態。
セッターによって以下の制限が強制されます:
- 可視ページは
Active
の状態を維持しなければなりません。 - ページがdevToolsView によって検査されている場合、両方のページは
Active
状態のままでなければなりません。 Discarded
状態のページはActive
状態にのみ遷移できる。これはページの再読み込みを引き起こす。
これらはライフサイクル状態に関する唯一のハード制限ですが、推奨されるソフト制限についてはrecommendedState も参照してください。
このプロパティは QtWebEngine 1.10 で導入されました。
recommendedState 、Page Lifecycle API、WebEngine Lifecycle Exampleも参照して ください。
loadProgress : int |
読み込まれたページのデータ量を、0
から100
までの整数パーセンテージで表します。
loading : bool |
HTML ページが現在読み込まれている場合はtrue
を、そうでない場合はfalse
を返します。
mainFrame : webEngineFrame |
ページのメイン、トップレベルのフレーム。このページの他のすべてのフレームは、メインフレームの子としてアクセスできます。
このプロパティは QtWebEngine 6.8 で導入されました。
profile : WebEngineProfile |
recentlyAudible : bool |
現在のページの可聴状態(オーディオが最近再生されたか、されていないか)を返します。
このプロパティは QtWebEngine 1.3 で導入されました。
audioMuted およびrecentlyAudibleChanged も参照して ください。
recommendedState : LifecycleState |
ページのライフサイクル状態の推奨限界値。
ライフサイクル状態を推奨状態よりも低いリソース使用量に設定すると、バックグラウンドのオーディオ再生が停止したり、HTML フォームの入力が失われるなどの副作用が発生する可能性があります。しかし、ライフサイクル状態をより高いリソース状態に設定することは、完全に安全です。
このプロパティは QtWebEngine 1.10 で導入されました。
lifecycleState 、Page Lifecycle API 、WebEngine Lifecycle Exampleも参照してください 。
renderProcessPid : qint64 |
現在のページのメインフレームに割り当てられているレンダリングプロセスのプロセス ID(PID)を返します。
まだ利用可能なレンダープロセスがない場合は、0
が返されます。
このプロパティは QtWebEngine 1.11 で導入されました。
renderProcessPidChangedも参照してください 。
scrollPosition : point |
ページコンテンツのスクロール位置。
このプロパティは QtWebEngine 1.3 で導入されました。
settings : WebEngineSettings |
title : string |
現在表示されている HTML ページのタイトル。これは、<title>
タグの内容を反映した読み取り専用の値です。
touchHandleDelegate : Component |
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 |
ビューに関連付けられたユーザースクリプトのコレクション。
このプロパティは QtWebEngine 1.1 で導入されました。
WebEngineScriptCollection も参照して ください。
webChannel : QQmlWebChannel |
このビューが使用するウェブチャネルのインスタンス。このチャネルは、自動的に Chromium IPC を介した内部QtWebEngine トランスポートメカニズムを使用し、レンダリングしているページの javascript コンテキストでqt.webChannelTransport
として公開されます。このトランスポートオブジェクトは、Qt WebChannel JavaScript API を使用してQWebChannel の JavaScript 対応部分をインスタンス化するときに使用されます。
注意: ビューは、割り当てられた webChannel オブジェクトの所有権を持ちません。
このプロパティは QtWebEngine 1.1 で導入されました。
webChannelWorld : int |
このビューが使用する Web チャネルインスタンスがインストールされている JavaScript のワールド。world は0
から256
の間の数字でなければなりません。
このプロパティは QtWebEngine 1.3 で導入されました。
zoomFactor : real |
ビューのズーム係数。有効な値は0.25
から5.0
の範囲です。デフォルトの係数は1.0
です。
このプロパティは QtWebEngine 1.1 で導入されました。
シグナルの説明
|
このシグナルは、activeFocusOnPress の値が変化した時に発行されます。このシグナルは、ビューが押されたときにアクティブフォーカスを得るかどうかを指定します。
注: 対応するハンドラはonActiveFocusOnPressChanged
です。
このシグナルは QtWebEngine 1.2 で導入されました。
activeFocusOnPress とsetActiveFocusOnPress()も参照してください 。
|
このシグナルは、muted の値が変更されたときに発行されます。値はaudioMuted プロパティで指定します。
注 : 特定の HTML5 audio / video 要素がミュートされることと混同しないでください。
注: 対応するハンドラはonAudioMutedChanged
です。
このシグナルは QtWebEngine 1.3 で導入されました。
audioMuted およびrecentlyAudibleChangedも参照して ください。
|
このシグナルは、認証ダイアログが要求されたときに発行されます。
request は、AuthenticationDialogRequest タイプのメソッドを使用して処理できます。
注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要があります。その後に必ずAuthenticationDialogRequest::dialogAccept() またはAuthenticationDialogRequest::dialogReject() をコールしてください。
注: 対応するハンドラはonAuthenticationDialogRequested
です。
このシグナルは QtWebEngine 1.4 で導入されました。
|
このシグナルは、Webエンジンのビューの背景色が変更されたときに発行されます。
注: 対応するハンドラはonBackgroundColorChanged
です。
このシグナルは QtWebEngine 1.2 で導入されました。
|
このシグナルは、リクエストのロード中に無効な証明書エラーerror が発生したときに発行されます。
証明書エラーは、WebEngineCertificateError 型のメソッドを使用して処理できます。
注: 対応するハンドラはonCertificateError
です。
このシグナルは QtWebEngine 1.1 で導入されました。
|
このシグナルは、カラーピッカーダイアログが要求されたときに発せられます。
request は、ColorDialogRequest タイプのメソッドを使用して処理できます。
注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要があります。その後に必ずColorDialogRequest::dialogAccept() かColorDialogRequest::dialogReject() をコールしてください。
注: 対応するハンドラはonColorDialogRequested
です。
このシグナルは QtWebEngine 1.4 で導入されました。
|
このシグナルはコンテキストメニューが要求されたときに発せられます。
request は、ContextMenuRequest タイプのプロパティを使用して処理できます。
注意: デフォルトのコンテキストメニューが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要があります。
注: 対応するハンドラはonContextMenuRequested
です。
このシグナルは QtWebEngine 1.4 で導入されました。
|
このシグナルは、ファイルピッカーダイアログが要求されたときに発せられます。
request は、FileDialogRequest タイプのメソッドを使用して処理できます。
注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要があります。その後に必ずFileDialogRequest::dialogAccept() またはFileDialogRequest::dialogReject() をコールしてください。
注: 対応するハンドラはonFileDialogRequested
です。
このシグナルは QtWebEngine 1.4 で導入されました。
|
このシグナルは、ページ上の文字列検索が完了したときに発行されます。result は文字列検索の結果です。
注意: 対応するハンドラはonFindTextFinished
です。
このシグナルは QtWebEngine 1.10 で導入されました。
findText() およびFindTextResultも参照してください 。
|
このシグナルは、ウェブページが JavaScript API を通してフルスクリーンモード用のrequest を発行したときに発せられます。
注: 対応するハンドラはonFullScreenRequested
です。
このシグナルは QtWebEngine 1.1 で導入されました。
isFullScreenも参照してください 。
このシグナルは、ドキュメントがページの位置とサイズを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 で導入されました。
このシグナルは、JavaScriptプログラムがWebブラウザのコンソールにmessage 。
例えば、評価エラーの場合、ソース URL はlineNumber と同様にsourceID で提供されるかもしれません。
level は、メッセージのトリガーとなったイベントの重大度、つまりエラーによってトリガーされたのか、それほど重大でないイベントによってトリガーされたのかを示します。
ハンドラが指定されない場合、ビューはメッセージをjs
logging category に記録します。
注: 対応するハンドラはonJavaScriptConsoleMessage
です。
Console Loggingも参照してください 。
|
このシグナルはJavaScriptのダイアログが要求されたときに発せられます。
request はJavaScriptDialogRequest タイプのメソッドで処理できます。
注意: デフォルトのダイアログが表示されないようにするには、シグナルハンドラが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
。
loading 、LoadStatus 、ErrorDomainも参照のこと 。
navigationRequested(WebEngineNavigationRequest request) |
このシグナルは、ナビゲーション・リクエストrequest が発行されたときに発せられる。
注: 対応するハンドラはonNavigationRequested
です。
|
このシグナルは、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("http://qt.io")">'); } 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も参照してください 。
このシグナルは、ウェブページのPDFファイルへの印刷が終了したときに発行されます。filePath には、ファイルの作成が要求されたパスが格納され、success には、ファイルの作成に成功した場合はtrue
が、そうでない場合はfalse
が格納されます。
注: 対応するハンドラはonPdfPrintingFinished
です。
このシグナルは QtWebEngine 1.5 で導入されました。
printToPdf()も参照してください 。
|
このシグナルは、Webサイトがパーミッション要求(例:ジオロケーションアクセス、通知の送信許可)を発行したときに発行されます。permission 、要求しているURLとWebEnginePermission.PermissionType
、パーミッションの許可・不許可を問い合わせることができます。
注: 対応するハンドラはonPermissionRequested
です。
このシグナルは QtWebEngine 6.8 で導入されました。
|
このシグナルは、メインフレーム上でJavaScriptwindow.print()
メソッドが呼び出されたとき、またはユーザーがPDFビューアープラグインの印刷ボタンを押したときに発せられます。通常、シグナルハンドラは単純にprintToPdf() を呼び出すことができます。
QtWebEngine 6.8以降、このシグナルは、印刷を要求するどのフレームに対しても発せられるのではなく、メインフレームに対してのみ発せられるようになりました。
注: 対応するハンドラはonPrintRequested
です。
このシグナルは QtWebEngine 1.8 で導入されました。
printToPdfも参照してください 。
|
このシグナルは、JavaScript のwindow.print()
メソッドがframe で呼び出されたときに出力されます。フレームがメインフレームの場合、代わりにprintRequested
が発行されます。
注意: 対応するハンドラはonPrintRequestedByFrame
です。
このシグナルは QtWebEngine 6.8 で導入されました。
printRequestedも参照してください 。
|
このシグナルは、recentlyAudible で指定されたページの可聴状態が、オーディオの再生や停止によって変更されたときに発行されます。
注: このシグナルは、audioMuted プロパティが変更されたときにも発行されます。また、オーディオが一時停止された場合、このシグナルは、オーディオが一時停止された瞬間から約2秒遅れて発信されます。
ウェブページに2つの動画が含まれ、それが順番に開始される場合、このシグナルは、最初の動画が音を発生するときに1回だけ発せられます。両方の動画が停止した後、最後に音が発生した時点で信号が発せられる。つまり、音声ストリームの数に関係なく、ウェブページ内で何らかの音が発生したときも、すべてが完全に無音になったときも、この信号が発せられることになります。
また、信号のスプリアスも発生する可能性があります。例えば、サウンドが停止すると、このシグナルはまずtrue
という値で発せられ、次にfalse
という値で発せられます。さらに、オーディオの再生が始まると、このシグナルはtrue
という値で2回発せられます。
注: 対応するハンドラはonRecentlyAudibleChanged
です。
このシグナルは QtWebEngine 1.3 で導入されました。
recentlyAudibleも参照してください 。
|
このシグナルは、ウェブページがregisterProtocolHandler request を発行してカスタムプロトコルを登録しようとしたときに発行されます。
注意: 対応するハンドラはonRegisterProtocolHandlerRequested
です。
このシグナルは QtWebEngine 1.7 で導入されました。
RegisterProtocolHandlerRequestも参照してください 。
|
レンダリングプロセスがまだない場合、0
が返されます。このシグナルは、ページの基礎となるレンダリングプロセスのpid (プロセス ID) が変更されたときに発行されます。
注: 対応するハンドラはonRenderProcessPidChanged
です。
このシグナルは QtWebEngine 1.11 で導入されました。
renderProcessPidも参照してください 。
|
このシグナルは、レンダープロセスがゼロ以外の終了ステータスで終了したときに発行されます。terminationStatus はプロセスの終了ステータス、exitCode はプロセスが終了したステータスコードです。
注: 対応するハンドラはonRenderProcessTerminated
です。
このシグナルは QtWebEngine 1.2 で導入されました。
RenderProcessTerminationStatusも参照してください 。
|
このシグナルは、WebサイトがSSLクライアント証明書を要求し、システムのクライアント証明書ストアに1つ以上の証明書が見つかったときに発行されます。
このシグナルの処理は非同期で、証明書が選択されるか、clientCertificateSelection の最後のコピーが破棄されるまでロードが待機します。
シグナルが処理されない場合、clientCertificateSelection は自動的に破棄され、ローディングはクライアント証明書なしで続行される。
注意: 対応するハンドラはonSelectClientCertificate
です。
このシグナルは QtWebEngine 1.9 で導入されました。
WebEngineClientCertificateSelectionも参照してください 。
|
このシグナルは、Web ページが指定された位置にツールチップを表示するためにrequest を送信したときに発行されます。
注意: デフォルトのツールチップが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要があります。
注: 対応するハンドラはonTooltipRequested
です。
このシグナルは QtWebEngine 1.10 で導入されました。
TooltipRequestも参照してください 。
|
このシグナルは、指定した位置でタッチ選択メニューが要求されたときに発せられます。
request は、TouchSelectionMenuRequest タイプのメソッドを使用して処理できる。
注: デフォルトのタッチ選択メニューが表示されないようにするには、シグナルハンドラがrequest.accepted = true
を呼び出す必要がある。
注: 対応するハンドラはonTouchSelectionMenuRequested
です。
このシグナルは QtWebEngine 6.3 で導入されました。
TouchSelectionMenuRequestも参照してください 。
|
このシグナルは、wasRecentlyAudible で指定されたページの可聴状態が、オーディオの再生や停止によって変更されたときに発行されます。
注: このシグナルは、setAudioMuted メソッドを呼び出したときにも出力されます。
注: 対応するハンドラはonWasRecentlyAudibleChanged
です。
このシグナルは QtWebEngine 1.3 で導入されました。
|
このシグナルは、WebAuth 認証機能が認証プロセス中にユーザとの対話を要求したときに発行されます。これらのリクエストは、ユーザにダイアログを表示することで処理されます。
request には、WebAuth UX リクエストを完了するために必要な情報と API が含まれています。
注意: 対応するハンドラはonWebAuthUxRequested
です。
このシグナルは QtWebEngine 6.7 で導入されました。
QWebEngineWebAuthUxRequestも参照してください 。
|
このシグナルは、JavaScript のwindow.close()
呼び出しなどで、ページが Web ブラウザのウィンドウを閉じるよう要求するたびに発行されます。
注: 対応するハンドラはonWindowCloseRequested
です。
このシグナルは QtWebEngine 1.2 で導入されました。
|
このシグナルは、ページのズームfactor が変更されるたびに発行されます。
注: 対応するハンドラはonZoomFactorChanged
です。
このシグナルは QtWebEngine 6.8 で導入されました。
zoomFactorも参照してください 。
メソッドの説明
ウェブビューのコンテンツで指定されたscript を実行します。
callback パラメータはオプションです。コールバック関数が指定されている場合は、スクリプトの実行終了後に呼び出されます。
runJavaScript("document.title", function(result) { console.log(result); });
結果値として JavaScript から返されるのは、プレーン データのみです。サポートされるデータ型には、すべてのJSONデータ型のほか、たとえばDate
やArrayBuffer
があります。サポートされていないデータ型には、Function
やPromise
などがあります。
ページ上で実行される他のスクリプトとの衝突を避けるため、スクリプトが実行されるワールドはworldId で指定できる。ワールドIDは0
と256
の間でなければならない。world
IDを省略すると、スクリプトはMainWorld
で実行される。
警告: ウェブ・コンテンツのレンダリングがブロックされる可能性があるため、コールバック関数内で長いルーチンを実行しないでください。
スクリプトの注入の詳細については、スクリプトの注入を参照してください。スクリプトを注入する別の方法については、WebEngineView::userScripts を参照してください。
|
このビューでrequest を開き、newWindowRequested シグナルを処理します。
このメソッドは QtWebEngine 2.0 で導入されました。
newWindowRequestedも参照してください 。
WebEngineAction action(WebAction action) |
指定されたWebAction action に対するWebEngineAction を返します。WebEngineView はアクションの実装も行い、トリガー時に対応するアクションがビューで実行されるようにします。
var copyAction = webEngineView.action(WebEngineView.Copy);
WebEngineAction も参照して ください。
|
指定されたname を持つフレームを返します。同じ名前のフレームが複数ある場合、どれを返すかは任意です。フレームが見つからなかった場合は、invalid のフレームを返します。
このメソッドは QtWebEngine 6.8 で導入されました。
|
指定された文字列subString をページ内で検索します。文字列の検索が完了すると、findTextFinished() シグナルが発行されます。
検索ハイライトを消去するには、空の文字列を渡します。
このメソッドは QtWebEngine 1.1 で導入されました。
findTextFinished()も参照してください 。
|
指定された文字列options を使用して、ページ内の指定された文字列subString を検索します。findTextFinished() シグナルは、文字列検索が完了したときに発せられます。
検索ハイライトを消去するには、空の文字列を渡します。
findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);
このメソッドは QtWebEngine 1.1 で導入されました。
findTextFinished()も参照してください 。
指定された文字列options を使用して、ページ内の指定された文字列subString を検索します。findTextFinished() シグナルは、文字列検索が完了したときに発せられます。
検索ハイライトを消去するには、空の文字列を渡します。
resultCallback は整数のパラメータを取らなければならない。このシグナルは、subString で見つかった出現回数とともに呼び出されます。
findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) { if (matchCount > 0) console.log("'Qt' tokens found:", matchCount); });
このメソッドは QtWebEngine 1.1 で導入されました。
findTextFinished()も参照してください 。
|
即座にisFullScreen
プロパティをfalse
に設定します。 ウィンドウシステムがアプリケーションをフルスクリーンモードから強制的に離脱させるときに、ブラウザエンジンに通知するために使用できます。
ApplicationWindow { onVisibilityChanged: { if (webEngineView.isFullScreen && visibility != Window.FullScreen) webEngineView.fullScreenCancelled() } WebEngineView { id: webEngineView // ... } }
このメソッドは QtWebEngine 1.1 で導入されました。
isFullScreen とfullScreenRequested()も参照してください 。
void goBack() |
可能であれば、ブラウザのセッション履歴を後戻りします。この関数はwindow.history.back()
DOM メソッドと同等です。
canGoBackも参照 。
|
void goForward() |
可能であれば、ブラウザのセッション履歴内を進みます。この関数はwindow.history.forward()
DOM メソッドと同等です。
指定された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も参照のこと 。
|
WebEngineView のカ レ ン ト 内容を PDF 文書へ印字 し 、 それをfilePath の下に格納 し ます。文書のサ イ ズはpageSizeId の値で決定 さ れ、 その向き はorientation で決定 さ れます。
こ の メ ソ ッ ド は、 Web ページ を PDF へ印刷す る ための非同期要求を発行 し 、 ただちに返 り ます。リクエストの結果を知るには、シグナルpdfPrintingFinished() に接続します。
pageSizeId を省略すると、デフォルトはA4
になります。orientation を省略すると、デフォルトはPortrait
になります。
このメソッドは QtWebEngine 1.3 で導入されました。
pdfPrintingFinished()も参照してください 。
|
WebEngineView の現在の内容を PDF ドキュメントに印刷し、バイト配列で返します。文書のサ イ ズはpageSizeId の値で決定 さ れ、 その向き はorientation で決定 さ れます。
resultCallback は文字列パ ラ メ タ を と る 必要があ り ます。この文字列には、印刷に成功した場合はドキュメントのデータが格納され、そうでない場合は空の文字列が格納されます。
pageSizeId を省略すると、デフォルトはA4
になります。orientation を省略すると、デフォルトはPortrait
になります。
このメソッドは QtWebEngine 1.3 で導入されました。
void reload() |
現在のページをリロードします。この関数はwindow.location.reload()
DOM メソッドと同等です。
reloadAndBypassCache()も参照してください 。
|
|
現在のスペルミスの単語をreplacement で置き換えます。
このメソッドは QtWebEngine 1.3 で導入されました。
|
現在のウェブページをディスクに保存します。
ウェブページは、指定されたformat のfilePath に保存されます。
これは以下のアクションのショートカットです:
- Save Web アクションをトリガーします。
- 次のダウンロード項目を受け入れ、指定されたファイルパスと 保存形式を設定します。
この関数は、Web ページに対して非同期ダウンロード要求を発行し、すぐに戻ります。
このメソッドは QtWebEngine 6.6 で導入されました。
QWebEngineDownloadRequest::SavePageFormatも参照してください 。
|
arg がtrue
の場合、クリックした Web エンジンビューにアクティブフォーカスを設定します。false
に設定することで、フォーカスを得るべきでない UI 要素を Web エンジンビューで作成することができます。これはハイブリッド UI で便利です。
このメソッドは QtWebEngine 1.2 で導入されました。
activeFocusOnPress 、activeFocusOnPressChanged 、WebEngineSettings::focusOnNavigationEnabledも参照してください 。
void stop() |
現在のページの読み込みを停止します。
|
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。