QWebEngineExtensionManager Class
애플리케이션이 파일 시스템에서 Chrome 확장 프로그램을 설치 및 로드할 수 있는 QWebEngineExtensionManager 클래스입니다. 더 보기...
| 헤더: | #include <QWebEngineExtensionManager> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
| 이후: | Qt 6.10 |
| 상속합니다: | QObject |
속성
- extensions : const QList<QWebEngineExtensionInfo>
- installPath : const QString
공용 함수
| 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는 크롬 확장 프로그램을 로드하거나 설치할 수 있습니다. 확장 프로그램은 loadExtension 을 통해 로드할 수 있습니다. 이 방법으로 로드된 확장 프로그램은 연결된 프로필에 기억되지 않으므로 새 브라우징 세션마다 수동으로 로드해야 합니다. 브라우저 세션 간에 확장 프로그램을 보존하기 위해 애플리케이션은 installExtension 을 통해 압축 또는 압축 해제된 확장 프로그램을 설치할 수 있습니다. 이 경우 관리자가 프로필의 디렉터리에 확장 프로그램의 압축을 풀고 거기에서 로드합니다. 설치된 확장 프로그램은 프로필이 초기화된 후 시작 시 항상 로드됩니다.
extensions()로 로드된 확장 프로그램에 액세스하여 QWebEngineExtensionInfo 목록을 제공하거나 관리자의 시그널에 연결하여 로드 또는 설치 프로세스의 상태에 대한 알림을 받을 수 있습니다.
각 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()로 쿼리할 수 있습니다.
설치 관리자는 압축 또는 압축 해제된 확장 프로그램을 설치할 수 있습니다. 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 인수는 확장 기능의 활성화 또는 비활성화 여부를 결정합니다.
참고: 행아웃 및 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 신호가 발생합니다.
참고: 행아웃 및 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.
