QWebEnginePage Class

メンバ関数ドキュメント

ページのDOMが構築されているかどうかをチェックせずに、scriptSource に含まれるJavaScriptコードを実行する。スクリプトの実行方法をもっと制御する必要がある場合は、代わりにscripts() の使用を検討してください。

ページ上で実行される他のスクリプトとの衝突を避けるため、スクリプトが実行されるワールドはworldId で指定される。ワールドIDの値は、QWebEngineScript::ScriptWorldId で提供されるものと同じで、0 と256 の間にある。world IDを省略すると、スクリプトはMainWorld で実行される。

スクリプトが実行されると、最後に実行されたステートメントの結果でresultCallback が呼び出される。resultCallback は、関数ポインタ、ファンクタ、ラムダのいずれかであり、QVariant パラメータを取ることが期待される。例えば

page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

JavaScriptから結果値として返せるのは、プレーンなデータだけです。サポートされるデータ型には、すべてのJSONデータ型と、例えばDate 、ArrayBuffer 。サポートされていないデータ型には、Function やPromise などがあります。

scripts()、QWebEngineScript::ScriptWorldId 、QWebEngineFrame::runJavaScript 、およびスクリプト・インジェクションも参照してください 。

[explicit] QWebEnginePage::QWebEnginePage(QObject *parent = nullptr)

空の QWebEnginePage を親parent で構築します。

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

空の Web エン ジ ン ページ を、 親プ ロ フ ァ イ ルparent を持つ Web エン ジ ン プ ロ フ ァ イ ルprofile 内に構築 し ます。

プロファイルがデフォルトのプロファイルでない場合、呼び出し元はページが存続する限りプロファイルが存続するようにしなければなりません。

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

ウェブページを破壊する。

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

この関数は、指定されたナビゲーションタイプtype によって、指定されたurl にナビゲートする要求を受け取ると呼び出される。isMainFrame は、要求がメインフレームに対応するか、子フレームに対応するかを示す。この関数がtrue を返した場合、ナビゲーション要求は受け入れられ、url がロードされます。デフォルトの実装では、すべてのナビゲーション要求を受け入れます。

ナビゲーション要求は、この関数をオーバーロードすることで、HTMLハンドラエンジンに処理させる代わりに、Qtアプリケーションに委譲することができます。これは、HTMLドキュメントをユーザーインターフェースの一部として使用し、外部データを表示しない場合（例えば、結果のリストを表示する場合など）に必要です。

QWebEngineUrlRequestInterceptor クラスは、リクエストをインターセプトして操作するためのさらなる オプションを提供します。

QAction *QWebEnginePage::action(QWebEnginePage::WebAction action) const

指定されたWebAction action のQAction を返します。

アクションはQWebEnginePage によって所有されますが、プロパティを変更することで見た目をカスタマイズできます。

返されるアクションには、デフォルトのアイコンはありません。デフォルトのスタイルのアイコンを持つアクションを持つには、QWebEngineView::pageAction() を使用してください。

QWebEnginePage また、アクションの実装も行いますので、トリガーが発生すると、対応するアクションがページ上で実行されます。

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

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

このシグナルは、ページのmuted ステートが変更されたときに発行されます。

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

このシグナルは、requestUrl へのアクセスに認証が必要な場合に発せられる。authenticator を使用して、接続用のユーザー名とパスワードを渡す必要がある。

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

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

certificateError パラメータは証明書とエラーの詳細についての情報を含む。また、 エラーを無視してリクエストを完了したり、リクエストのロードを中止したり する方法も提供する。

QWebEngineCertificateErrorも参照してください 。

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

この関数は、HTMLフォームのファイルアップロードボタンをユーザーがクリックした結果など、ウェブコンテンツがファイル名を要求したときに呼び出されます。

mode は、返されるファイルが1つだけなのか複数なのかを示します。

oldFiles acceptedMimeTypes はデフォルトの実装では無視されますが、オーバーライドによって使用される可能性があります。

[virtual protected] QWebEnginePage *QWebEnginePage::createWindow(QWebEnginePage::WebWindowType type)

この関数は、指定されたtype の新しいウィンドウを作成するために呼び出される。たとえば、JavaScript プログラムが新しいウィンドウでドキュメントを開くように要求した場合などです。

新しいウィンドウを作成できる場合は、新しいウィンドウのQWebEnginePage が返され、そうでない場合は null ポインタが返されます。

ウェブ・ページに関連付けられたビューがQWebEngineView オブジェクトの場合、デフォルトの実装ではリクエストをQWebEngineView::createWindow() に転送します。

この呼び出しが実装されていないか、新しいページを返さない場合、newWindowRequested()がリクエストを処理するために発行される。

QWebEngineView::createWindow() とnewWindowRequested()も参照してください 。

[signal, since 6.7] void QWebEnginePage::desktopMediaRequested(const QWebEngineDesktopMediaRequest &request)

このシグナルは、Webアプリケーションがディスプレイのコンテンツへのアクセスを要求したときに発行される。

引数request は、キャプチャ可能なウィンドウとスクリーンのデータモデルへの参照を保持します。要求を受け入れるために、シグナルハンドラはQWebEngineDesktopMediaRequest::selectScreen() またはQWebEngineDesktopMediaRequest::selectWindow() を呼び出します。

この関数はQt 6.7で導入されました。

[since 6.6] QString QWebEnginePage::devToolsId() const

このページに関連付けられた開発者ツールホストの ID を返します。

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

この関数は Qt 6.6 で導入されました。

QWebEnginePage *QWebEnginePage::devToolsPage() const

このページの開発者ツールをホストしているページがあれば、それを返します。

開発者ツールページが設定されていない場合はnullptr を返します。

setDevToolsPage() およびinspectedPage()も参照 ください。

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

url で指定された場所からリソースをローカルファイルにダウンロードする。

filename が指定された場合、それが推奨ファイル名として使用される。それが相対的な場合、ファイルは与えられた名前で標準のダウンロード場所に保存されます。NULLまたは空のQString の場合、デフォルトのファイル名が使用される。

これは、ダウンロード開始後にQWebEngineProfile::downloadRequested() を発行する。

[override virtual] bool QWebEnginePage::event(QEvent *e)

再インプリメント：QObject::event(QEvent *e).

[signal, since 6.4] void QWebEnginePage::fileSystemAccessRequested(QWebEngineFileSystemAccessRequest request)

このシグナルは、ウェブ・ページがローカル・ファイルやディレクトリーへの アクセスを要求したときに発せられる。

リクエストオブジェクトrequest を使って、リクエストを許可または拒否することができます。

この関数は Qt 6.4 で導入されました。

[since 6.8] std::optional<QWebEngineFrame> QWebEnginePage::findFrameByName(QAnyStringView name)

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

この関数は Qt 6.8 で導入されました。

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

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

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

resultCallback はQWebEngineFindTextResult パラメータを取らなければならない。

例えば

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](const QWebEngineFindTextResult &result) {
        if (result.numberOfMatches() == 0) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

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

[signal] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

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

findText()も参照 。

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

このシグナルは、ウェブページがウェブ要素（通常はビデオ要素）に対してフルスクリーンモードにするリクエストを発行したときに発せられます。

リクエストオブジェクトfullScreenRequest を使用して、リクエストを承認または拒否できます。

リクエストが受け入れられた場合、フルスクリーンを要求する要素はビューポートいっぱいに表示されますが、ビューをフルスクリーンにするか、ページをフルスクリーンのビューに移動するかはアプリケーション次第です。

QWebEngineSettings::FullScreenSupportEnabledも参照してください 。

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

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

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

閲覧履歴へのポインタを返します。

[signal] void QWebEnginePage::iconChanged(const QIcon &icon)

このシグナルは、ページに関連付けられたアイコン("favicon")が変更されたときに発せられる。新しいアイコンはicon で指定されます。

icon(),iconUrl(),iconUrlChanged()も参照 。

[signal] void QWebEnginePage::iconUrlChanged(const QUrl &url)

このシグナルは、ページに関連付けられたアイコン("favicon")のURLが変更されたときに発行される。新しいURLはurl で指定されます。

iconUrl(),icon(),iconChanged()も参照 。

QWebEnginePage *QWebEnginePage::inspectedPage() const

このページが検査しているページがあれば、それを返します。

このページが開発者ツールページでない場合はnullptr を返します。

setInspectedPage() およびdevToolsPage()も参照 。

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

この関数は、securityOrigin のフレームで実行されている JavaScript プログラムが、msg というメッセージとともにalert() 関数を呼び出すたびに呼び出されます。

デフォルトの実装では、メッセージmsg をQMessageBox::information で表示します。

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

この関数は、securityOrigin のフレームで実行されている JavaScript プログラムが、msg というメッセージとともにconfirm() 関数を呼び出すたびに呼び出されます。ユーザーがメッセージを確認した場合はtrue を返し、そうでない場合はfalse を返します。

また、onbeforeunload ハンドラがページを離れる前に確認を要求するときにも呼び出されます。

デフォルトの実装では、QMessageBox::Ok とQMessageBox::Cancel ボタンを使って、QMessageBox::information を使ってクエリを実行します。

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

この関数は、JavaScriptプログラムがウェブ・ブラウザのコンソールにmessage 。

例えば、評価エラーの場合、sourceID にソースURLが提供され、lineNumber.

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

Qt 5.6以降、デフォルトの実装では、メッセージはjs logging category に記録されます。

コンソールログも参照してください 。

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

この関数は、securityOrigin のフレームで実行されている JavaScript プログラムが、ユーザーに入力を促そうとするたびに呼び出されます。プログラムは、defaultValue の入力のデフォルト値と同様に、オプションのメッセージmsg を提供することができる。

プロンプトがユーザーによってキャンセルされた場合、実装はfalse を返すべきである。そうでない場合、結果はresult に書き込まれ、true が返されるべきである。プロンプトがユーザーによってキャンセルされなかった場合、実装はtrue を返すべきである。

デフォルトの実装ではQInputDialog::getText() を使用する。

[signal] void QWebEnginePage::linkHovered(const QString &url)

このシグナルは、マウスがリンクの上に乗ったときに発せられる。url にはリンクのターゲットURLが含まれる。

void QWebEnginePage::load(const QUrl &url)

url をこのページにロードする。

setUrl()、setHtml()、setContent()も参照の こと。

void QWebEnginePage::load(const QWebEngineHttpRequest &request)

指定されたrequest を発行し、応答をロードする。

load()、setUrl()、url()、urlChanged()、QUrl::fromUserInput()も参照のこと 。

[signal] void QWebEnginePage::loadFinished(bool ok)

このシグナルは、ページがコンテンツの読み込みを終了したときに発行される。このシグナルは、スクリプトの実行やページのレンダリングとは無関係です。ok は、ロードが成功したか、エラーが発生したかを示します。

loadStarted() およびacceptNavigationRequest()も参照のこと 。

[signal] void QWebEnginePage::loadProgress(int progress)

このシグナルは、グローバル進捗ステータスが変化したときに発せられる。現在の値はprogress によって提供され、0 から 100 の範囲でスケーリングされます。これはQProgressBar のデフォルト範囲です。 このシグナルは、すべての子フレームからの変更を累積します。

[signal] void QWebEnginePage::loadStarted()

このシグナルは、ページがコンテンツの読み込みを開始したときに発せられる。

loadFinished() およびacceptNavigationRequest()も参照 。

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

このシグナルは、loadingInfo で指定されたページのロードが開始、終了、または失敗したときに発行される。

この関数は Qt 6.2 で導入されました。

[since 6.8] QWebEngineFrame QWebEnginePage::mainFrame()

ページのメインとなる最上位のフレーム。このページの他のすべてのフレームは、メインフレームの子としてアクセスできます。

この関数は Qt 6.8 で導入されました。

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

このシグナルは、acceptNavigationRequest()の呼び出しとともにナビゲーション時に発せられる。requestデフォルトはacceptです。

この関数は Qt 6.2 で導入されました。

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

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

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

このシグナルは、リクエストの新しいページでopenIn()を呼び出すことで処理される。このシグナルが処理されない場合、リクエストされたロードは失敗します。

この関数は Qt 6.2 で導入されました。

createWindow() およびQWebEngineNewWindowRequest::openIn()も参照してください 。

[signal] void QWebEnginePage::pdfPrintingFinished(const QString &filePath, bool success)

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

printToPdf()も参照 。

[signal, since 6.8] void QWebEnginePage::permissionRequested(QWebEnginePermission permission)

このシグナルは、ウェブサイトがある機能（例：ジオロケーションアクセス、通知の送信許可）の利用を要求したときに発行されます。permission オブジェクトは、要求している URL とQWebEnginePermission::Feature を照会し、許可を与えるか拒否するかを決定します。

この関数は Qt 6.8 で導入されました。

[signal] void QWebEnginePage::printRequested()

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

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

printToPdf() およびprintRequestedByFrame()も参照して ください。

[signal, since 6.8] void QWebEnginePage::printRequestedByFrame(QWebEngineFrame frame)

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

この関数は Qt 6.8 で導入されました。

printRequested(),printToPdf(),QWebEngineFrame::printToPdf()も参照してください 。

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

ページのカ レ ン ト 内容を PDF 文書に レ ン ダ リ ング し 、filePath で指定 さ れてい る場所に保存 し ます。生成 さ れ る PDF 文書のページサ イ ズ と 向 き は、layout で指定 さ れてい る 値か ら 取得 さ れ、 印字 さ れ る ページ の範囲はranges か ら 取得 さ れます。

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

与え ら れた フ ァ イ ルパ ス に フ ァ イ ルがすでに存在 し てい る と き は、 その フ ァ イ ルは上書 き さ れます。

pdfPrintingFinished()も参照 。

void QWebEnginePage::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

resultCallback生成 さ れ る PDF 文書のページサ イ ズ と 向 き はlayout で指定 さ れてい る 値か ら 採 ら れ、 印字 さ れ る ページ の範囲はranges か ら 採 ら れます。

resultCallback は、QByteArray への const 参照を引数 と し て取 る 必要があ り ます。印刷が成功 し た と き は、 こ のバ イ ト 配列は PDF デー タ を含んでお り 、 そ う でない と き はバ イ ト 配列は空にな り ます。

QWebEngineProfile *QWebEnginePage::profile() const

ページが属するウェブエンジンプロファイルを返します。

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

このシグナルは、proxyHost を経由してrequestUrl にアクセスする際に、プロキシの認証が必要な場合に発行される。authenticator を使用して、接続用のユーザー名とパスワードを渡す必要がある。

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

このシグナルは、ページの可聴状態（recentlyAudible ）が変化したときに発行される。

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

このシグナルは、ウェブページがregisterProtocolHandlerAPIを使ってカスタムプロトコルを登録しようとしたときに発せられる。

リクエストオブジェクトrequest を使って、リクエストを受け入れるか拒否するかを指定できます：

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(window(), tr("Permission Request"),
                                        tr("Allow %1 to open all %2 links?")
                                                .arg(request.origin().host())
                                                .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

[signal] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

このシグナルは、基礎となるレンダリングプロセスのPIDpid が変更されたときに発行される。

[signal] void QWebEnginePage::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

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

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

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

現在スペルミスのある単語はQWebEngineContextMenuRequest::misspelledWord() に、置換候補はQWebEngineContextMenuRequest::spellCheckerSuggestions() にある。

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

現在ロードされているウェブページをディスクに保存する。

ウェブページは指定されたformat のfilePath に保存されます。

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

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

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

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

QWebEngineScriptCollection &QWebEnginePage::scripts()

ページに注入されたスクリプトのコレクションを返します。

さらに、ページはQWebEngineProfile::scripts() を通して追加されたスクリプトも実行するかもしれません。

QWebEngineScriptCollection 、QWebEngineScript 、およびスクリプト・インジェクションも参照してください 。

[signal] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

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

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

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

QWebEngineClientCertificateSelectionも参照のこと 。

[signal] void QWebEnginePage::selectionChanged()

このシグナルは、対話的またはプログラム的に選択範囲が変更されるたびに発行されます。例えば、選択アクションでtriggerAction() を呼び出した場合などです。

selectedText()も参照 。

void QWebEnginePage::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

ウェブページのコンテンツをdata に設定します。引数mimeType が空の場合、コンテンツはtext/plain,charset=US-ASCII であるとみなされます。

コンテンツで参照される外部オブジェクトは、baseUrl からの相対位置にあります。相対 URL を持つ外部オブジェクトを読み込むには、baseUrl を空にすることはできません。

data 外部オブジェクトは非同期にロードされます。

toHtml() およびsetHtml()も参照の こと。

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

devToolsPage をこのページの開発者ツールにバインドする。devToolsPage をトリガーとして、開発者ツールで内部 URL に移動する。

これは、this を引数としてdevToolsPage でsetInspectedPage() を呼び出すのと同じである。

devToolsPage() およびsetInspectedPage()も参照 。

void QWebEnginePage::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

このページのコンテンツをhtml に設定する。baseUrl はオプションで、参照される画像やスタイルシートなど、ドキュメント内の相対 URL を解決するために使われる。

html は即座に読み込まれます。外部オブジェクトは非同期に読み込まれます。

html のスクリプトが、モーダルな JavaScript アラートダイアログによってブロックされるなどして、デフォルトのスクリプトタイムアウト (現在は 10 秒) よりも長く実行された場合、このメソッドはタイムアウト後できるだけ早く戻り、後続のhtml はすべて非同期で読み込まれます。

このメソッドを使用する場合、ウェブエンジンは JavaScript プログラムやスタイルシートなどの外部リソースが、特に指定されない限り UTF-8 でエンコードされていると仮定します。例えば、外部スクリプトのエンコーディングは、HTMLのscriptタグのcharset属性で指定できます。また、ウェブ・サーバーがエンコーディングを指定することもできます。

これはsetContent(html, "text/html", baseUrl) と同等の便利な関数です。

toHtml()、setContent()、load()も参照のこと 。

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

このページを、page の開発者ツールである内部URLにナビゲートする。

これは、page でthis を引数としてsetDevToolsPage() を呼び出すのと同じである。

inspectedPage() およびsetDevToolsPage()も参照のこと 。

void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

URL リクエストをインターセプトするために、リクエストインターセプ ターinterceptor を登録する。

ページはポインタの所有権を持ちません。このインターセプターはプロファイルのインターセプターの後に呼ばれ、プロファイルのインターセプターとは異なり、このページからの URL リクエストのみがインターセプトされます。元のリクエストがすでにプロファイルインターセプターによってブロックされたりリダイレクトされたりしている場合は、このインターセプターによってインターセプトされることはありません。

リクエストインターセプターの設定を解除するには、nullptr を設定してください。

QWebEngineUrlRequestInfo とQWebEngineProfile::setUrlRequestInterceptor()も参照してください 。

void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

このページが使用するウェブチャネルのインスタンスをchannel に設定し、Chromium IPC メッセージを使用してウェブエンジンのトランスポートに接続します。トランスポートは JavaScript の世界worldId でqt.webChannelTransport として公開されており、Qt WebChannel JavaScript API を使用するときに使用します。

webChannel() およびQWebEngineScript::ScriptWorldIdも参照して ください。

QWebEngineSettings *QWebEnginePage::settings() const

ページの設定オブジェクトへのポインタを返します。

[signal] void QWebEnginePage::titleChanged(const QString &title)

このシグナルはページのタイトルが変更されるたびに発せられる。title 、新しいタイトルを指定する。

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

void QWebEnginePage::toHtml(const std::function<void (const QString &)> &resultCallback) const

HTMLタグとBODYタグで囲まれたページの内容をHTMLとして取得する非同期メソッド。成功すると、ページのコンテンツとともにresultCallback 。

setHtml() およびtoPlainText()も参照してください 。

void QWebEnginePage::toPlainText(const std::function<void (const QString &)> &resultCallback) const

HTMLの書式をすべて取り除いたプレーンテキストに変換されたページの内容を取得する非同期メソッド。成功すると、resultCallback がページの内容とともに呼び出される。

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

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = false)

この関数は、指定されたaction 。また、ユーザーがコンテキストメニュー項目などでアクションをトリガーした場合にも、Qt WebEngine によって呼び出される。

action がチェック可能なアクションの場合、checked はアクションがトグルされるかどうかを指定します。

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

[signal] void QWebEnginePage::urlChanged(const QUrl &url)

このシグナルは、ページタイトルを受け取ったときに、ページのURLとともに発せられる。新しいURLはurl で指定される。

url()も参照 。

[signal, since 6.7] void QWebEnginePage::webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

このシグナルは、WebAuth 認証モジュールが認証処理中にユーザの操作を必要とする場合に発行されます。これらのリクエストは、ユーザーにダイアログを表示することで処理されます。

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

この関数は Qt 6.7 で導入されました。

QWebEngineWebAuthUxRequestも参照して ください。

QWebChannel *QWebEnginePage::webChannel() const

このページが使用するウェブチャネルのインスタンスへのポインタ、または何も設定されていない場合は null ポインタを返します。このチャネルは、Chromium IPC を介したウェブエンジン内部のトランスポート機構を自動的に使用します。この機構は、このページの JavaScript コンテキストでqt.webChannelTransport として公開されています。

setWebChannel()も参照 。

[signal] void QWebEnginePage::windowCloseRequested()

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

RequestCloseも参照してください 。

[signal, since 6.8] void QWebEnginePage::zoomFactorChanged(qreal factor)

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

この関数は Qt 6.8 で導入されました。

zoomFactor() およびsetZoomFactor()も参照してください 。