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 を返します。