QWebEngineExtensionManager Class

QWebEngineExtensionManager クラスは、アプリケーションが Chrome 拡張機能をファイルシステムからインストールしたりロードしたりできるようにします。詳細...

ヘッダー #include <QWebEngineExtensionManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
以来:Qt 6.10
継承: QObject

プロパティ

パブリック関数

QList<QWebEngineExtensionInfo> extensions() const
void installExtension(const QString &path)
QString installPath() const
void loadExtension(const QString &path)
void setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)
void uninstallExtension(const QWebEngineExtensionInfo &extension)
void unloadExtension(const QWebEngineExtensionInfo &extension)

再実装された保護された関数

virtual bool event(QEvent *e) override

詳細説明

QWebEngineExtensionManager は、Chrome 拡張機能をロードまたはインストールできます。拡張機能はloadExtension 経由でロードできます。この方法でロードされた拡張機能は、関連付けられたプロファイルに記憶されないため、新しいブラウジング セッションごとに手動でロードする必要があります。閲覧セッション間で拡張機能を保持するために、アプリケーションはinstallExtension 経由で圧縮または解凍された拡張機能をインストールできます。この場合、マネージャは拡張機能をプロファイルのディレクトリに解凍し、そこからロードします。インストールされた拡張機能はプロファイルが初期化された後、常に起動時にロードされます。

QWebEngineExtensionInfo のリストを提供するextensions() を使ってロードされた拡張機能にアクセスしたり、マネージャのシグナルに接続してロードやインストールプロセスの状態を通知したりできます。

QWebEngineProfile はそれ自身のQWebEngineExtensionManager を持つので、同じプロファイルを共有するすべてのページは同じエクステンションも共有します。拡張機能は記録外のプロファイルにはロードできません。

注: ManifestV3 拡張機能のみがサポートされ、他のバージョンはロードもインストールもされません。

QWebEngineProfile::extensionManager およびQWebEngineExtensionInfoも参照して ください。

プロパティのドキュメント

[read-only] extensions : const QList<QWebEngineExtensionInfo>

ロードされている拡張子のリストを返します。

関数にアクセスします:

QList<QWebEngineExtensionInfo> extensions() const

QWebEngineExtensionInfoも参照のこと

[read-only] installPath : const QString

拡張機能がインストールされているディレクトリのパスを返します。

アクセス関数:

QString installPath() const

installExtension() およびQWebEngineExtensionInfo::isInstalled()も参照

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

[override virtual protected] bool QWebEngineExtensionManager::event(QEvent *e)

再インプリメント:QObject::event(QEvent *e).

[invokable] void QWebEngineExtensionManager::installExtension(const QString &path)

path からプロファイルのディレクトリに拡張機能をインストールし、ロードします。

QWebEngineExtensionManager::installFinished シグナルは、拡張機能がインストールされた後、またはインストールが失敗した後に発行されます。インストールが成功した場合はQWebEngineExtensionInfo::isInstalled() が真を返し、失敗した場合はQWebEngineExtensionInfo::error() にインストールが失敗した情報が含まれます。

インストールが成功すると、拡張機能は無効な状態でロードされます。インストールされたエクステンションは、起動のたびに無効な状態で自動的にロードされます。インストール・パスはinstallPath() で問い合わせることができる。

インストーラは、zip または解凍された拡張機能をインストールできます。path パラメータは、拡張機能のマニフェストファイルを含むディレクトリまたは zip ファイルを指す必要があります。トップレベルのディレクトリにマニフェストがない場合、インストールプロセスは中断されます。

すでにロードまたはインストールされている拡張機能を同じパスからインストールすると、新しい拡張機能がインストールされます。

注意: この関数はメタオブジェクトシステムおよび QML から呼び出すことができます。Q_INVOKABLE を参照してください。

QWebEngineExtensionInfo::isInstalled(),QWebEngineExtensionInfo::error(),installPath()も参照して ください。

[invokable] void QWebEngineExtensionManager::loadExtension(const QString &path)

からアンパックされた拡張機能をロードします。path

QWebEngineExtensionManager::loadFinished シグナルは、拡張機能がロードされたとき、またはロードに失敗したときに発行されます。ロードが成功した場合、QWebEngineExtensionInfo::isLoaded() は真を返します。そうでない場合、QWebEngineExtensionInfo::error() はロードに失敗した情報を含みます。

拡張機能は常に無効な状態でロードされるため、ユーザーは手動で有効にする必要があります。すでにロードされている拡張モジュールを同じパスからロードすると、その拡張モジュールは再ロードされます。

注意: この関数はメタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

QWebEngineExtensionInfo::isLoaded() およびQWebEngineExtensionInfo::error()も参照して ください。

[invokable] void QWebEngineExtensionManager::setExtensionEnabled(const QWebEngineExtensionInfo &extension, bool enabled)

実行時にextension をオン/オフできるようにする。

enabled 引数は、拡張機能を有効にするか無効にするかを決定する。

注: HangoutsやPDFのような内部拡張機能を無効にすることも可能です。

注意 :この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

QWebEngineExtensionInfo::isEnabled()も参照して ください。

[invokable] void QWebEngineExtensionManager::uninstallExtension(const QWebEngineExtensionInfo &extension)

をアンインストールします。extension

インストールパスから拡張機能のファイルを削除し、拡張機能をアンロードします。処理が終了すると QWebEngineExtensionManager::uninstallFinished シグナルが発行されます。

注意: この関数はメタオブジェクトシステムや QML から呼び出すことができます。Q_INVOKABLE を参照してください。

QWebEngineExtensionManager::installPath(),QWebEngineExtensionInfo::isInstalled(),QWebEngineExtensionInfo::error()も参照して ください。

[invokable] void QWebEngineExtensionManager::unloadExtension(const QWebEngineExtensionInfo &extension)

をアンロードする。extension

拡張機能のすべてのデータをメモリから削除します。

アンロード処理が終了すると、QWebEngineExtensionManager::unloadFinished シグナルが発行されます。

注意 : Hangouts や PDF のような内部拡張機能をアンロードすることも可能ですが、それらは他のインストール済み拡張機能と同様に次回起動時にロードされます。

注意: この関数はメタオブジェクトシステムやQMLから呼び出すことができます。Q_INVOKABLE を参照してください。

QWebEngineExtensionInfo::isLoaded()も参照して ください。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.