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)

再リンプルメント: (QDragLeaveEvent *event)：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 &)>())

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

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

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

基礎となる Web ページへのポインタを返します。

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()

このシグナルは、JavaScriptのwindow.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 = {})

ページのカ レ ン ト 内容を PDF 文書へ レ ン ダ リ ング し 、 PDF デー タ を含むバ イ ト 配列を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の外部オブジェクトをロードするために、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 を Web ビューの新しい Web ページにします。

提供されたページの親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()も 参照してください。