QWebEngineView Class

メンバ関数ドキュメント

[explicit] QWebEngineView::QWebEngineView(QWidget *parent = nullptr)

parent を親として空のウェブビューを構築します。

load()も参照ください 。

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

parent を親とするpage を含むウェブビューを構築します。

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

load() およびsetPage()も参照してください 。

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

parent を親として、profile を使用して空のウェブビューを構築します。

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

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

[virtual noexcept] QWebEngineView::~QWebEngineView()

ウェブビューを破壊する。

[slot] void QWebEngineView::back()

ナビゲートリンクによって構築されたドキュメントリストの前のドキュメントをロードする便利なスロット。前のドキュメントがない場合は何もしない。

と等価です：

    view->page()->triggerAction(QWebEnginePage::Back);

forward() およびpageAction()も参照 。

[override virtual protected] void QWebEngineView::closeEvent(QCloseEvent *event)

再実装：QWidget::closeEvent(QCloseEvent *event)。

[override virtual protected] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

再実装：QWidget::contextMenuEvent(QContextMenuEvent *event)。

QMenu *QWebEngineView::createStandardContextMenu()

標準コンテキストメニューを作成し、そのポインタを返します。

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

この関数は、ページが与えられたtype の新しいウィンドウを作成しようとするたびに、関連するQWebEnginePage のcreateWindow() メソッドから呼び出される。例えば、新しいウィンドウでドキュメントを開くJavaScriptリクエストが発行されたときなどです。

QWebEnginePage::createWindow()も参照 。

[override virtual protected] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

再実装：QWidget::dragEnterEvent(QDragEnterEvent *event)。

[override virtual protected] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

再実装：QWidget::dragLeaveEvent(QDragLeaveEvent *event)。

[override virtual protected] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

再実装：QWidget::dragMoveEvent(QDragMoveEvent *event)。

[override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)

再実装：QWidget::dropEvent(QDropEvent *event)。

[override virtual protected] bool QWebEngineView::event(QEvent *ev)

再実装：QWidget::event(QEvent *event)。

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

指定 さ れた文字列options を用いて、 ページ内の指定 さ れた文字列subString を検索 し ます。

選択を解除するには、空の文字列を渡します。

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

selectedText() およびselectionChanged()も参照してください 。

[static, since 6.2] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

page に関連付けられたビューがあれば、それを返します。

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

page() およびsetPage()も参照してください 。

[slot] void QWebEngineView::forward()

ナビゲートリンクによって構築されたドキュメントリストの次のドキュメントをロードする便利なスロット。次のドキュメントがない場合は何もしません。

と等価です：

    view->page()->triggerAction(QWebEnginePage::Forward);

back() およびpageAction()も参照 。

[override virtual protected] void QWebEngineView::hideEvent(QHideEvent *event)

再実装：QWidget::hideEvent(QHideEvent *event).

QWebEngineHistory *QWebEngineView::history() const

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

と等価です：

    view->page()->history();

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

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

icon(),iconUrl(),iconUrlChanged()も参照してください 。

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

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

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

[since 6.2] QWebEngineContextMenuRequest *QWebEngineView::lastContextMenuRequest() const

現在のコンテキスト・メニューに関する追加データを返します。これは、contextMenuEvent() を呼び出している間のみ有効であることが保証されます。

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

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

void QWebEngineView::load(const QUrl &url)

指定されたurl を読み込み、表示する。

load(),setUrl(),url(),urlChanged(),QUrl::fromUserInput()も参照 。

void QWebEngineView::load(const QWebEngineHttpRequest &request)

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

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

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

このシグナルは、ページのロードが終了したときに発せられる。ok は、ロードが成功したかエラーが発生したかを示す。

loadStarted()も参照 。

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

このシグナルは、埋め込まれた画像やスクリプトなど、ウェブビューの要素の読み込みが完了するたびに発行されます。そのため、このシグナルはウェブビューの読み込みの進捗を追跡します。

現在の値はprogress によって提供され、0 から 100 の範囲で変化します。これはQProgressBar のデフォルトの範囲です。

loadStarted() およびloadFinished()も参照して ください。

[signal] void QWebEngineView::loadStarted()

このシグナルは、ページの新規ロードが開始されたときに発せられる。

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

QWebEnginePage *QWebEngineView::page() const

基になるウェブページへのポインタを返します。

setPage()も参照ください 。

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

指定されたウェブアクションaction をカプセル化したQAction へのポインタを返します。この関数は、QAction にデフォルトのアイコンがない場合、そのアイコンを設定します。

[signal, since 6.2] void QWebEngineView::pdfPrintingFinished(const QString &filePath, bool success)

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

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

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

[since 6.2] void QWebEngineView::print(QPrinter *printer)

ページのカ レ ン ト 内容を一時的な PDF 文書へレンダリングし、printer を用いてそれを印刷する。

PDF文書の作成と印刷の設定は、printer オブジェクトから取得されます。

終了すると、成功の場合はtrue 、失敗の場合はfalse のシグナルprintFinished() が発せられます。

printFinished() が発行されるまでprinter が有効であることを確認するのはユーザーの責任です。

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

[signal, since 6.2] void QWebEngineView::printFinished(bool success)

このシグナルは、print （）で要求された印刷が終了したときに発せられる。パラメータsuccess は、成功の場合はtrue 、失敗の場合はfalse となります。

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

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

[signal, since 6.2] void QWebEngineView::printRequested()

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

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

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

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

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

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

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

printRequested() およびprint()も参照してください 。

[since 6.2] void QWebEngineView::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() に接続します。

指定されたファイルパスに既にファイルが存在する場合は、上書きされます。

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

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

[since 6.2] void QWebEngineView::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 デー タ が格納 さ れ、 そ う でなければバ イ ト 配列は空にな り ます。

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

[slot] void QWebEngineView::reload()

現在の文書をリロードする。

stop()、pageAction()、loadStarted()も参照 。

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

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

[signal] void QWebEngineView::selectionChanged()

このシグナルは選択範囲が変わるたびに発せられる。

selectedText()も参照 。

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

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

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

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

load()、setHtml()、QWebEnginePage::toHtml()も参照のこと 。

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

ウェブビューのコンテンツを、指定されたhtml コンテンツに設定します。

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

HTMLドキュメントは即座にロードされますが、外部オブジェクトは非同期にロードされます。

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

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

load()、setContent()、QWebEnginePage::toHtml()、QWebEnginePage::setContent()も参照 。

void QWebEngineView::setPage(QWebEnginePage *page)

page をウェブビューの新しいウェブページにします。

提供されたページの親QObject はオブジェクトの所有者のままです。現在のページがウェブビューの子である場合、そのページは削除されます。

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

QWebEngineSettings *QWebEngineView::settings() const

ビューまたはページ固有の設定オブジェクトへのポインタを返します。

と等価です：

    view->page()->settings();

[override virtual protected] void QWebEngineView::showEvent(QShowEvent *event)

再実装：QWidget::showEvent(QShowEvent *event)。

[override virtual] QSize QWebEngineView::sizeHint() const

QWidget::sizeHint 。

[slot] void QWebEngineView::stop()

ドキュメントの読み込みを停止する便利なスロット。

と等価である：

    view->page()->triggerAction(QWebEnginePage::Stop);

reload()、pageAction()、loadFinished()も参照のこと 。

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

このシグナルは、ビューのtitle が変更されるたびに発行される。

title()も参照 。

void QWebEngineView::triggerPageAction(QWebEnginePage::WebAction action, bool checked = false)

指定されたaction をトリガーする。チェック可能なアクションであれば、指定されたchecked の状態が想定される。

以下の例では、copy アクションをトリガし、選択されたテキストをクリップボードにコピーします。

    view->triggerPageAction(QWebEnginePage::Copy);

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

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

このシグナルは、ビューのurl が変更されたときに発行される。

url() およびload()も参照 。