QWebEngineProfileBuilder Class

Die Klasse QWebEngineProfileBuilder bietet eine Möglichkeit, QWebEngineProfile zu konstruieren. Mehr...

Kopfzeile: #include <QWebEngineProfileBuilder>
CMake: find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake: QT += webenginecore
Seit: Qt 6.9

Öffentliche Funktionen

QWebEngineProfile *createProfile(const QString &storageName, QObject *parent = nullptr) const
QWebEngineProfileBuilder &setCachePath(const QString &path)
QWebEngineProfileBuilder &setHttpCacheMaximumSize(int maxSizeInBytes)
QWebEngineProfileBuilder &setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)
QWebEngineProfileBuilder &setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy persistentCookiePolicy)
QWebEngineProfileBuilder &setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy persistentPermissionPolicy)
QWebEngineProfileBuilder &setPersistentStoragePath(const QString &path)

Statische öffentliche Mitglieder

QWebEngineProfile *createOffTheRecordProfile(QObject *parent = nullptr)

Detaillierte Beschreibung

Ein QWebEngineProfileBuilder erzeugt eine Instanz der Klasse QWebEngineProfile. Einige Eigenschaften des Profils müssen in einem Aufruf initialisiert werden und sollten während der Lebensdauer des Profils nicht geändert werden. Der Web-Engine-Profil-Builder überwacht dies einfach.

Dokumentation der Mitgliedsfunktionen

[static] QWebEngineProfile *QWebEngineProfileBuilder::createOffTheRecordProfile(QObject *parent = nullptr)

Erstellt ein Off-the-Record-Profil mit dem übergeordneten Objekt parent, das keinen Datensatz auf dem lokalen Rechner hinterlässt und keine dauerhaften Daten oder Cache hat. Dadurch werden Cookies, dauerhafte Daten und HTTP-Cache im Speicher gespeichert

QWebEngineProfile *QWebEngineProfileBuilder::createProfile(const QString &storageName, QObject *parent = nullptr) const

Konstruiert ein Profil mit dem Speichernamen storageName und dem übergeordneten parent.

Der Speichername wird verwendet, um jedem plattenbasierten Profil ein eigenes Unterverzeichnis für persistente Daten und den Cache zu geben. Der Speicherort muss während der Lebensdauer der Anwendung eindeutig sein. Es liegt in der Verantwortung des Benutzers, die Erstellung von Profilen mit demselben Speicherort zu verhindern, was zu einem beschädigten Browser-Cache führen kann.

Ein festplattenbasiertes QWebEngineProfile sollte vor dem Beenden der Anwendung zerstört werden, da sonst der Cache und die dauerhaften Daten möglicherweise nicht vollständig auf die Festplatte gespült werden.

Hinweis: Wenn beim Erstellen eines plattenbasierten Profils der Datenpfad bereits von einem anderen Profil verwendet wird, gibt die Funktion einen Null-Zeiger zurück.

Siehe auch QWebEngineProfile::storageName().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setCachePath(const QString &path)

Setzt den für den Cache verwendeten Pfad auf path.

Standardmäßig befindet sich dieser Pfad unterhalb von StandardPaths::CacheLocation in einem QtWebengine/StorageName spezifischen Unterverzeichnis.

Siehe auch QWebEngineProfile::cachePath() und QStandardPaths::writableLocation().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setHttpCacheMaximumSize(int maxSizeInBytes)

Setzt die maximale Größe des HTTP-Caches auf maxSizeInBytes bytes.

Die Einstellung 0 bedeutet, dass die Größe automatisch von QtWebEngine gesteuert wird.

Siehe auch QWebEngineProfile::httpCacheMaximumSize() und setHttpCacheType().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

Setzt den HTTP-Cache-Typ auf httpCacheType.

Siehe auch QWebEngineProfile::httpCacheType() und setCachePath().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy persistentCookiePolicy)

Setzt die Richtlinie für dauerhafte Cookies auf persistentCookiePolicy.

Siehe auch QWebEngineProfile::persistentCookiesPolicy().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy persistentPermissionPolicy)

Legt die Richtlinie für dauerhafte Berechtigungen auf persistentPermissionPolicy fest.

Siehe auch QWebEngineProfile::persistentPermissionsPolicy().

QWebEngineProfileBuilder &QWebEngineProfileBuilder::setPersistentStoragePath(const QString &path)

Legt den Pfad für die Speicherung dauerhafter Daten für den Browser und Webinhalte auf path fest. Zu den dauerhaften Daten gehören dauerhafte Cookies, lokaler HTML5-Speicher und besuchte Links.

Standardmäßig befindet sich dieser Pfad unterhalb von QStandardPaths::DataLocation in einem QtWebengine/StorageName spezifischen Unterverzeichnis.

Hinweis: Verwenden Sie QStandardPaths::writableLocation(QStandardPaths::DataLocation) um den QStandardPaths::DataLocation Pfad zu erhalten.

Siehe auch QWebEngineProfile::persistentStoragePath() und QStandardPaths::writableLocation().

© 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.