QWebEngineFrame Class

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

ページの 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 、スクリプト・インジェクションも参照してください 。

QList<QWebEngineFrame> QWebEngineFrame::children() const

フレームの子のリストを任意の順序で返します。

フレームが見つからなかった場合は、空のリストを返します。

QString QWebEngineFrame::htmlName() const

フレームのname HTML 属性の値、または何もない場合は空文字列を返します。

フレームが見つからない場合は、NULLQString を返します。

nameも参照してください 。

bool QWebEngineFrame::isMainFrame() const

このオブジェクトがページのメインフレームを表している場合はtrue を返し、そうでない場合はfalse を返します。

bool QWebEngineFrame::isValid() const

このオブジェクトが既存のフレームを表している場合はtrue を返し、そうでない場合はfalse を返す。

一度無効となったフレームが再び有効になることはありません。

QString QWebEngineFrame::name() const

フレーム名を返します。つまり、JavaScript のwindow.name で返されるものです。

フレームが見つからない場合は、NULLQString を返します。

htmlNameも参照してください 。

[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 デー タ を内容 と し て持ち、 そ う でなければバ イ ト 配列は空にな り ます。

QSizeF QWebEngineFrame::size() const

ビューポート内のフレームのサイズを返す。

フレームが見つからない場合はQSizeF()を返す。

QUrl QWebEngineFrame::url() const

このフレームに現在読み込まれているコンテンツの URL を返す。

フレームが見つからない場合は、空のQUrl を返します。