QWebEngineFrame Class

メンバー関数ドキュメント

[invokable] void QWebEngineFrame::printToPdf(const QString &filePath)

フレームの現在の内容をPDF文書にレンダリングし、filePath で指定された場所に保存します。印刷は、ページサイズ A4、縦レイアウトを使用し、全ページを含みます。

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

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

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

void QWebEngineFrame::printToPdf(const std::function<void (const QByteArray &)> &callback)

フレームの現在の内容を PDF ドキュメントにレンダリングし、PDF データを含むバイト配列をcallback へのパラメータとして返します。印刷は、ページサイズ A4、ポートレートレイアウトを使用し、全ページを含みます。

callback は、QByteArray への const 参照を引数 と し て取 る 必要があ り ます。印刷が成功 し た と き は、 こ のバ イ ト 配列は PDF デー タ を内容 と し て持ち、 そ う でなければバ イ ト 配列は空にな り ます。

ページの DOM が構築されているかどうかをチェックせずに、script に含まれる JavaScript コードをこのフレーム上で実行する。ページ上で実行される他のスクリプトとの衝突を避けるため、スクリプトが実行されるワールドはworldId で指定される。ワールドIDの値は、QWebEngineScript::ScriptWorldId で提供されるものと同じで、0 と256 の間にあります。world IDを省略すると、スクリプトはMainWorld で実行されます。スクリプトが実行されると、callback が最後に実行されたステートメントの結果で呼び出されます。callback は、関数ポインタ、ファンクタ、ラムダのいずれかにすることができ、QVariant パラメータを取ることが期待されます。例えば

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

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

QWebEngineScript::ScriptWorldId 、QWebEnginePage::runJavaScript 、スクリプト・インジェクションも参照してください 。