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 エンジン プロファイルprofile 内の空の Web エンジン ページを、親parent と共に構築します。

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

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

Web ページを破棄します。

[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フォームのファイルアップロードボタンをユーザーがクリックした結果など、Webコンテンツがファイル名を要求するときに呼び出されます。

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

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

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

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

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

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

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

QWebEngineView::createWindow() およびnewWindowRequested()も参照 。

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

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

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

この関数は 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)

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

リクエストオブジェクト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 。これは、JavaScriptなどで発生します。

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プログラムがWebブラウザのコンソールにmessage 。

例えば、評価エラーの場合、lineNumber と同様に、sourceID でソース URL を提供することができます。

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

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

Console Loggingも参照してください 。

[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 によって提供され、QProgressBar のデフォルト範囲である 0 から 100 の範囲で変化します。 すべての子フレームからの変化を累積します。

[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 が発行され、ウェブエンジンの別ウィンドウにページがロードされたときに発行されます。これは、現在のページがwindow.open への JavaScript 呼び出しによって明示的に要求したためか、ユーザーが 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 = {})

ページのカ レ ン ト 内容を PDF 文書へ レ ン ダ リ ング し 、 PDF デー タ を含むバ イ ト 配列を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

現在読み込まれているWebページをディスクに保存する。

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

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

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

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

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

QWebEngineScriptCollection &QWebEnginePage::scripts()

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

さ ら に、 ページはQWebEngineProfile::scripts() で追加 さ れた ス ク リ プ ト を実行す る こ と も あ り ます。

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

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

このシグナルは、Webサイトが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())

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

コンテンツで参照される外部オブジェクトは、baseUrl からの相対 URL に配置されます。相対 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

このページが使用する Web チャネルインスタンスへのポインタを返します。このチャネルは自動的に、このページの JavaScript コンテキストでqt.webChannelTransport として公開されている、Chromium IPC 上の内部ウェブエンジントランスポートメカニズムを使用します。

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

[signal] void QWebEnginePage::windowCloseRequested()

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

RequestClose も参照 。

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

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

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

zoomFactor() とsetZoomFactor()も 参照してください。