QWebEngineProfile Class

Dokumentation der Mitgliedsfunktionen

[explicit] QWebEngineProfile::QWebEngineProfile(QObject *parent = nullptr)

Konstruiert ein neues Off-the-Record-Profil mit dem übergeordneten parent.

Ein Off-the-Record-Profil hinterlässt keinen Datensatz auf dem lokalen Rechner und hat keine dauerhaften Daten oder einen Cache. Daher kann der HTTP-Cache nur im Speicher sein und die Cookies können nur nicht-persistent sein. Der Versuch, diese Einstellungen zu ändern, hat keine Auswirkung.

Siehe auch isOffTheRecord().

[explicit] QWebEngineProfile::QWebEngineProfile(const QString &storageName, QObject *parent = nullptr)

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

Der Speichername muss eindeutig sein.

Ein festplattenbasiertes QWebEngineProfile sollte beim oder vor dem Beenden der Anwendung zerstört werden, da sonst der Cache und die persistenten Daten möglicherweise nicht vollständig auf die Festplatte geschrieben werden.

Siehe auch storageName().

QString QWebEngineProfile::cachePath() const

Gibt den für Caches verwendeten Pfad zurück.

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

Siehe auch setCachePath(), storageName(), und QStandardPaths::writableLocation().

void QWebEngineProfile::clearAllVisitedLinks()

Löscht alle Links aus der Datenbank der besuchten Links.

Siehe auch clearVisitedLinks().

void QWebEngineProfile::clearHttpCache()

Entfernt die Cache-Einträge des Profils.

Siehe auch QWebEngineProfile::clearHttpCacheCompleted().

[signal, since 6.7] void QWebEngineProfile::clearHttpCacheCompleted()

Dieses Signal wird ausgegeben, wenn die Operation clearHttpCache() abgeschlossen ist.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QWebEngineProfile::clearHttpCache().

void QWebEngineProfile::clearVisitedLinks(const QList<QUrl> &urls)

Löscht die Links in urls aus der Datenbank der besuchten Links.

Siehe auch clearAllVisitedLinks().

QWebEngineClientCertificateStore *QWebEngineProfile::clientCertificateStore()

Gibt den Client-Zertifikatspeicher des Profils zurück.

[since 6.8] QWebEngineClientHints *QWebEngineProfile::clientHints() const

Gibt die Client-Hinweis-Einstellungen zurück, die mit diesem Browsing-Kontext verbunden sind.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch QWebEngineClientHints.

QWebEngineCookieStore *QWebEngineProfile::cookieStore()

Gibt den Cookie-Speicher für dieses Profil zurück.

[static] QWebEngineProfile *QWebEngineProfile::defaultProfile()

Gibt das Standardprofil zurück.

Das Standardprofil ist "off-the-record".

Siehe auch storageName().

QString QWebEngineProfile::downloadPath() const

Der Pfad zu dem Ort, an dem die heruntergeladenen Dateien gespeichert werden.

Siehe auch setDownloadPath() und QStandardPaths::writableLocation().

[signal] void QWebEngineProfile::downloadRequested(QWebEngineDownloadRequest *download)

Dieses Signal wird ausgesendet, wenn ein Download ausgelöst wurde. Das Argument download enthält den Status des Downloads. Der Download muss explizit mit QWebEngineDownloadRequest::accept() angenommen werden, sonst wird er standardmäßig abgebrochen. Das Download-Element ist dem Profil übergeordnet. Wird es nicht akzeptiert, wird es unmittelbar nach der Signalausgabe gelöscht. Dieses Signal kann nicht mit einer Warteschlangenverbindung verwendet werden.

Siehe auch QWebEngineDownloadRequest und QWebEnginePage::download().

QString QWebEngineProfile::httpAcceptLanguage() const

Gibt den Wert des HTTP-Request-Header-Feldes "Accept-Language" zurück.

Siehe auch setHttpAcceptLanguage().

int QWebEngineProfile::httpCacheMaximumSize() const

Gibt die maximale Größe des HTTP-Caches in Bytes zurück.

Gibt 0 zurück, wenn die Größe automatisch von QtWebEngine kontrolliert wird.

Siehe auch setHttpCacheMaximumSize() und httpCacheType().

QWebEngineProfile::HttpCacheType QWebEngineProfile::httpCacheType() const

Gibt den Typ des verwendeten HTTP-Caches zurück.

Wenn das Profil off-the-record ist, wird MemoryHttpCache zurückgegeben.

Siehe auch setHttpCacheType() und cachePath().

QString QWebEngineProfile::httpUserAgent() const

Gibt den User-Agent-String zurück, der mit HTTP gesendet wird, um den Browser zu identifizieren.

Siehe auch setHttpUserAgent() und Windows Application Manifest.

void QWebEngineProfile::installUrlSchemeHandler(const QByteArray &scheme, QWebEngineUrlSchemeHandler *handler)

Registriert einen Handler handler für das benutzerdefinierte URL-Schema scheme im Profil.

Es ist erforderlich, das Schema beim Start der Anwendung zunächst bei QWebEngineUrlScheme::registerScheme zu registrieren.

bool QWebEngineProfile::isOffTheRecord() const

Gibt true zurück, wenn es sich um ein Off-the-Record-Profil handelt, das keinen Datensatz auf dem Computer hinterlässt.

Dadurch werden Cookies und HTTP-Cache im Speicher gehalten, aber auch alle anderen normalerweise dauerhaften Daten werden im Speicher gehalten.

[since 6.5] bool QWebEngineProfile::isPushServiceEnabled() const

Gibt true zurück, wenn der Push-Messaging-Dienst aktiviert ist.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch setPushServiceEnabled().

bool QWebEngineProfile::isSpellCheckEnabled() const

Gibt true zurück, wenn die Rechtschreibprüfung aktiviert ist; andernfalls wird false zurückgegeben.

Siehe auch setSpellCheckEnabled().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listAllPermissions() const

Gibt eine QList von QWebEnginePermission Objekten zurück, von denen jedes eine einzelne, derzeit im Berechtigungsspeicher vorhandene Berechtigung darstellt. Die zurückgegebene Liste enthält alle zuvor gewährten/verweigerten Berechtigungen für dieses Profil, sofern sie von einem persistenten Typ sind.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch queryPermission(), QWebEnginePermission::PermissionType, und QWebEnginePermission::isPersistent().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForOrigin(const QUrl &securityOrigin) const

Gibt eine QList von QWebEnginePermission Objekten zurück, von denen jedes eine einzelne, derzeit im Berechtigungsspeicher vorhandene Berechtigung darstellt. Die zurückgegebene Liste enthält alle zuvor gewährten/entzogenen Berechtigungen, die mit einem bestimmten securityOrigin für dieses Profil verbunden sind, sofern sie von einem dauerhaften Typ sind.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch queryPermission(), QWebEnginePermission::PermissionType, und QWebEnginePermission::isPersistent().

[since 6.8] QList<QWebEnginePermission> QWebEngineProfile::listPermissionsForPermissionType(QWebEnginePermission::PermissionType permissionType) const

Gibt eine QList von QWebEnginePermission Objekten zurück, von denen jedes eine einzelne Berechtigung darstellt, die derzeit im Berechtigungsspeicher vorhanden ist. Die zurückgegebene Liste enthält alle zuvor gewährten/verweigerten Berechtigungen der angegebenen permissionType. Wenn der permissionType nicht persistent ist, ist die Liste leer.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch queryPermission(), QWebEnginePermission::PermissionType, und QWebEnginePermission::isPersistent().

QWebEngineProfile::PersistentCookiesPolicy QWebEngineProfile::persistentCookiesPolicy() const

Gibt die aktuelle Richtlinie für dauerhafte Cookies zurück.

Wenn das Profil off-the-record ist, wird NoPersistentCookies zurückgegeben.

Siehe auch setPersistentCookiesPolicy().

[since 6.8] QWebEngineProfile::PersistentPermissionsPolicy QWebEngineProfile::persistentPermissionsPolicy() const

Gibt die aktuelle Richtlinie für dauerhafte Berechtigungen zurück.

Off-the-record-Profile dürfen keine Daten auf der Festplatte speichern, daher können sie nur StoreInMemory oder AskEveryTime zurückgeben.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch QWebEngineProfile::PersistentPermissionsPolicy und setPersistentPermissionsPolicy().

QString QWebEngineProfile::persistentStoragePath() const

Gibt den Pfad zurück, der zum Speichern dauerhafter Daten für den Browser und Webinhalte verwendet wird.

Persistente Daten umfassen persistente Cookies, lokalen HTML5-Speicher und besuchte Links.

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

Siehe auch setPersistentStoragePath(), storageName(), und QStandardPaths::writableLocation().

[since 6.8] QWebEnginePermission QWebEngineProfile::queryPermission(const QUrl &securityOrigin, QWebEnginePermission::PermissionType permissionType) const

Gibt ein Objekt QWebEnginePermission zurück, das einer einzelnen Berechtigung für die angegebenen securityOrigin und permissionType entspricht. Das Objekt kann verwendet werden, um den aktuellen Status der Berechtigung abzufragen oder sie zu ändern. Es ist nicht erforderlich, dass eine Berechtigung bereits existiert; das zurückgegebene Objekt kann auch verwendet werden, um eine Berechtigung vorab zu erteilen, wenn bekannt ist, dass eine Website sie verwendet.

Sie können dies verwenden, um eine Berechtigung eines nicht-persistenten Typs vorab zu erteilen. Dadurch bleibt die Berechtigung im Status "gewährt" (oder "verweigert"), bis sie das nächste Mal von einer Website mit dem entsprechenden Ursprung angefordert wird. Zu diesem Zeitpunkt ist die Lebensdauer der Berechtigung an die Lebensdauer dieser speziellen Webseite gebunden, und das Wegnavigieren wird die Berechtigung ungültig machen.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch listAllPermissions(), listPermissionsForOrigin(), listPermissionsForPermissionType(), und QWebEnginePermission::PermissionType.

void QWebEngineProfile::removeAllUrlSchemeHandlers()

Entfernt alle im Profil installierten benutzerdefinierten URL-Schema-Handler.

void QWebEngineProfile::removeUrlScheme(const QByteArray &scheme)

Entfernt das benutzerdefinierte URL-Schema scheme aus dem Profil.

Siehe auch removeUrlSchemeHandler().

void QWebEngineProfile::removeUrlSchemeHandler(QWebEngineUrlSchemeHandler *handler)

Entfernt den benutzerdefinierten URL-Schema-Handler handler aus dem Profil.

Siehe auch removeUrlScheme().

[since 6.2] void QWebEngineProfile::requestIconForIconURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &)> iconAvailableCallback) const

Fordert ein Symbol mit dem angegebenen url aus der Datenbank an. Jedes Profil hat seine eigene Icon-Datenbank, die im permanenten Speicher abgelegt ist, so dass auf die gespeicherten Icons auch ohne Netzwerkverbindung zugegriffen werden kann. Das Icon muss zuvor geladen worden sein, um in der Datenbank gespeichert zu werden.

url gibt die URL des Icons an. Falls mehr als ein Icon verfügbar ist, wird dasjenige zurückgegeben, dessen Größe am nächsten an desiredSizeInPixel liegt. Das Ergebnis-Symbol wird auf desiredSizeInPixel verkleinert. Wenn desiredSizeInPixel 0 ist, wird das größte verfügbare Symbol zurückgegeben.

Diese Funktion ist asynchron und das Ergebnis wird von iconAvailableCallback zurückgegeben. Der Callback wird aufgerufen, wenn eine Anforderung für ein Symbol durchgeführt wird. Wenn das angeforderte Symbol verfügbar ist, ist der erste Parameter (mit dem Typ QIcon) das Ergebnis. Andernfalls ist er null.

Der zweite Parameter speichert die URL des angeforderten Icons. Er ist leer, wenn das Symbol nicht abgerufen werden kann.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch requestIconForPageURL().

[since 6.2] void QWebEngineProfile::requestIconForPageURL(const QUrl &url, int desiredSizeInPixel, std::function<void (const QIcon &, const QUrl &, const QUrl &)> iconAvailableCallback) const

Fordert ein Symbol für eine zuvor geladene Seite mit diesem Profil aus der Datenbank an. Jedes Profil hat seine eigene Icon-Datenbank, die im persistenten Speicher abgelegt ist, so dass auf die gespeicherten Icons auch ohne Netzwerkverbindung zugegriffen werden kann. Das Icon muss zuvor geladen worden sein, um in der Datenbank gespeichert zu werden.

url gibt die URL der Seite an, für die das Icon angefordert wird. Falls mehr als ein Icon verfügbar ist, wird dasjenige zurückgegeben, dessen Größe der von desiredSizeInPixel am nächsten kommt. Das Ergebnis-Symbol wird auf desiredSizeInPixel verkleinert. Wenn desiredSizeInPixel 0 ist, wird das größte verfügbare Symbol zurückgegeben.

Diese Funktion ist asynchron und das Ergebnis wird von iconAvailableCallback zurückgegeben. Der Callback wird aufgerufen, wenn eine Anforderung für ein Symbol durchgeführt wird. Wenn das angeforderte Symbol verfügbar ist, ist der erste Parameter (mit dem Typ QIcon) das Ergebnis. Andernfalls ist er null.

Der zweite Parameter speichert die URL des angeforderten Icons. Er ist leer, wenn das Symbol nicht abgerufen werden kann.

Der dritte Parameter speichert die URL der Seite, der das Icon zugeordnet ist.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch requestIconForIconURL().

QWebEngineScriptCollection *QWebEngineProfile::scripts() const

Gibt die Sammlung von Skripten zurück, die in alle Seiten injiziert werden, die dieses Profil teilen.

Siehe auch QWebEngineScriptCollection, QWebEngineScript, QWebEnginePage::scripts(), und Script Injection.

void QWebEngineProfile::setCachePath(const QString &path)

Setzt den für Festplatten-Caches verwendeten Standardpfad außer Kraft und setzt ihn auf path.

Wird er auf die Zeichenfolge null gesetzt, wird der Standardpfad wiederhergestellt.

Siehe auch cachePath().

void QWebEngineProfile::setDownloadPath(const QString &path)

Setzt den Standardpfad, der für den Download-Speicherort verwendet wird, außer Kraft und setzt ihn auf path.

Wird er auf die Zeichenfolge null gesetzt, wird der Standardpfad wiederhergestellt.

Siehe auch downloadPath().

void QWebEngineProfile::setHttpAcceptLanguage(const QString &httpAcceptLanguage)

Setzt den Wert des HTTP-Request-Header-Feldes Accept-Language auf httpAcceptLanguage.

Siehe auch httpAcceptLanguage().

void QWebEngineProfile::setHttpCacheMaximumSize(int maxSize)

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

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

Siehe auch httpCacheMaximumSize() und setHttpCacheType().

void QWebEngineProfile::setHttpCacheType(QWebEngineProfile::HttpCacheType httpCacheType)

Setzt den HTTP-Cachetyp auf httpCacheType.

Siehe auch httpCacheType(), setCachePath(), und clearHttpCache().

void QWebEngineProfile::setHttpUserAgent(const QString &userAgent)

Setzt den Standard-Benutzer-Agenten-String außer Kraft und setzt ihn auf userAgent.

Siehe auch httpUserAgent().

void QWebEngineProfile::setNotificationPresenter(std::function<void (std::unique_ptr<QWebEngineNotification>)> notificationPresenter)

Legt die Funktion notificationPresenter fest, die für die Darstellung gesendeter Benachrichtigungen zuständig ist.

Siehe auch QWebEngineNotification.

void QWebEngineProfile::setPersistentCookiesPolicy(QWebEngineProfile::PersistentCookiesPolicy newPersistentCookiesPolicy)

Setzt die Richtlinie für dauerhafte Cookies auf newPersistentCookiesPolicy.

Siehe auch persistentCookiesPolicy().

[since 6.8] void QWebEngineProfile::setPersistentPermissionsPolicy(QWebEngineProfile::PersistentPermissionsPolicy newPersistentPermissionsPolicy)

Setzt die Richtlinie für dauerhafte Berechtigungen auf newPersistentPermissionsPolicy.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch QWebEngineProfile::PersistentPermissionsPolicy und persistentPermissionsPolicy().

void QWebEngineProfile::setPersistentStoragePath(const QString &path)

Setzt den Standardpfad für die Speicherung persistenter Web-Engine-Daten außer Kraft.

Wenn path auf die Zeichenfolge null gesetzt wird, wird der Standardpfad wiederhergestellt.

Siehe auch persistentStoragePath().

[since 6.5] void QWebEngineProfile::setPushServiceEnabled(bool enable)

Aktiviert den Push-Messaging-Dienst, wenn enable true ist, andernfalls wird er deaktiviert.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch isPushServiceEnabled().

void QWebEngineProfile::setSpellCheckEnabled(bool enable)

Aktiviert die Rechtschreibprüfung, wenn enable true ist, andernfalls wird sie deaktiviert.

Siehe auch isSpellCheckEnabled().

void QWebEngineProfile::setSpellCheckLanguages(const QStringList &languages)

Legt die aktuelle Liste von languages für die Rechtschreibprüfung fest. Jede Sprache sollte mit dem Namen des .bdic Wörterbuchs übereinstimmen. Zum Beispiel wird die Sprache en-US die Wörterbuchdatei en-US.bdic laden.

Wie die Wörterbuchdateien durchsucht werden, ist in der Dokumentation der Rechtschreibprüfung beschrieben.

Weitere Informationen über das Kompilieren von .bdic Wörterbüchern finden Sie im Spellchecker-Beispiel.

Siehe auch spellCheckLanguages().

void QWebEngineProfile::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Registriert ein Request Interceptor Singleton interceptor zum Abfangen von URL-Anfragen.

Das Profil übernimmt nicht das Eigentum an dem Zeiger.

Siehe auch QWebEngineUrlRequestInfo und QWebEngineUrlRequestInterceptor.

QWebEngineSettings *QWebEngineProfile::settings() const

Gibt die Standardeinstellungen für alle Seiten dieses Profils zurück.

QStringList QWebEngineProfile::spellCheckLanguages() const

Gibt die Liste der von der Rechtschreibprüfung verwendeten Sprachen zurück.

Siehe auch setSpellCheckLanguages().

QString QWebEngineProfile::storageName() const

Gibt den Speichernamen für das Profil zurück.

Der Speichername wird verwendet, um jedem Profil, das den Datenträger verwendet, separate Unterverzeichnisse für persistente Daten und Cache zu geben.

const QWebEngineUrlSchemeHandler *QWebEngineProfile::urlSchemeHandler(const QByteArray &scheme) const

Gibt das benutzerdefinierte URL-Schema-Handler-Register für das URL-Schema scheme zurück.

bool QWebEngineProfile::visitedLinksContainsUrl(const QUrl &url) const

Gibt true zurück, wenn url von diesem Profil als besuchter Link betrachtet wird.