QWebEnginePage Class

Documentation des fonctions membres

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

Construit une QWebEnginePage vide avec le parent parent.

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

Construit une page vide de moteur web dans le profil de moteur web profile avec le parent parent.

Si le profil n'est pas le profil par défaut, l'appelant doit s'assurer que le profil reste actif aussi longtemps que la page.

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

Détruit la page web.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

Cette fonction est appelée lors de la réception d'une demande de navigation vers le site url au moyen du type de navigation spécifié type. isMainFrame indique si la demande correspond au cadre principal ou à un cadre enfant. Si la fonction renvoie true, la demande de navigation est acceptée et url est chargé. L'implémentation par défaut accepte toutes les demandes de navigation.

Les demandes de navigation peuvent être déléguées à l'application Qt au lieu d'être traitées par le moteur de traitement HTML en surchargeant cette fonction. Cela est nécessaire lorsqu'un document HTML est utilisé dans le cadre de l'interface utilisateur et non pour afficher des données externes, par exemple lors de l'affichage d'une liste de résultats.

La classe QWebEngineUrlRequestInterceptor offre d'autres options pour intercepter et manipuler les demandes.

QAction *QWebEnginePage::action(QWebEnginePage::WebAction action) const

Renvoie un QAction pour le WebAction action spécifié.

L'action appartient à QWebEnginePage mais vous pouvez personnaliser son apparence en modifiant ses propriétés.

L'action retournée n'a pas d'icône stylisée par défaut. Utilisez QWebEngineView::pageAction() pour obtenir une action avec une icône stylisée par défaut.

QWebEnginePage prend également en charge l'implémentation de l'action, de sorte qu'au moment du déclenchement, l'action correspondante est exécutée sur la page.

Voir aussi triggerAction().

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

Ce signal est émis lorsque l'état de la page muted change.

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

Ce signal est émis lorsque l'accès à requestUrl nécessite une authentification. authenticator doit être utilisé pour transmettre le nom d'utilisateur et le mot de passe pour la connexion.

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

Ce signal est émis lorsqu'une erreur de certificat invalide est soulevée lors du chargement d'une demande donnée.

Le paramètre certificateError contient des informations sur le certificat et les détails de l'erreur. Il permet également d'ignorer l'erreur et de terminer la demande ou d'arrêter le chargement de la demande.

Voir aussi QWebEngineCertificateError.

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

Cette fonction est appelée lorsque le contenu web demande un nom de fichier, par exemple lorsque l'utilisateur clique sur un bouton de téléchargement de fichier dans un formulaire HTML.

mode indique si un seul ou plusieurs fichiers doivent être renvoyés.

Un nom de fichier suggéré peut être fourni comme première entrée de oldFiles. acceptedMimeTypes est ignoré par l'implémentation par défaut, mais peut être utilisé par les surcharges.

[virtual protected] QWebEnginePage *QWebEnginePage::createWindow(QWebEnginePage::WebWindowType type)

Cette fonction est appelée pour créer une nouvelle fenêtre de la taille spécifiée type. Par exemple, lorsqu'un programme JavaScript demande d'ouvrir un document dans une nouvelle fenêtre.

Si la nouvelle fenêtre peut être créée, l'objet QWebEnginePage de la nouvelle fenêtre est renvoyé ; dans le cas contraire, un pointeur nul est renvoyé.

Si la vue associée à la page web est un objet QWebEngineView, l'implémentation par défaut transmet la demande à QWebEngineView::createWindow() ; sinon, elle renvoie un pointeur nul.

Si cet appel n'est pas implémenté ou ne renvoie pas de nouvelle page, newWindowRequested() est émis pour traiter la demande.

Voir également QWebEngineView::createWindow() et newWindowRequested().

[signal, since 6.7] void QWebEnginePage::desktopMediaRequested(const QWebEngineDesktopMediaRequest &request)

Ce signal est émis lorsqu'une application web demande l'accès au contenu d'un écran.

L'argument request contient des références aux modèles de données pour les fenêtres et les écrans disponibles pour la capture. Pour accepter la demande, le gestionnaire du signal peut appeler QWebEngineDesktopMediaRequest::selectScreen() ou QWebEngineDesktopMediaRequest::selectWindow().

Cette fonction a été introduite dans Qt 6.7.

[since 6.6] QString QWebEnginePage::devToolsId() const

Renvoie l'identifiant de l'hôte des outils de développement associé à cette page.

Si le débogage à distance est activé (voir Qt WebEngine Developer Tools), l'identifiant peut être utilisé pour construire l'URL permettant de se connecter au websocket de l'outil de développement : ws://localhost:<debugging-port>/devtools/page/<id>). Le websocket peut être utilisé pour interagir avec la page à l'aide du protocole DevTools.

Cette fonction a été introduite dans Qt 6.6.

QWebEnginePage *QWebEnginePage::devToolsPage() const

Renvoie la page qui héberge les outils de développement de cette page, le cas échéant.

Renvoie nullptr si aucune page d'outils de développement n'est définie.

Voir également setDevToolsPage() et inspectedPage().

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

Télécharge la ressource à partir de l'emplacement indiqué par url dans un fichier local.

Si filename est indiqué, il est utilisé comme nom de fichier suggéré. S'il est relatif, le fichier est enregistré à l'emplacement de téléchargement standard sous le nom indiqué. S'il s'agit d'un QString vide ou nul, le nom de fichier par défaut est utilisé.

Cette commande émettra QWebEngineProfile::downloadRequested() une fois que le téléchargement aura commencé.

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

Réimplémente : QObject::event(QEvent *e).

[signal, since 6.4] void QWebEnginePage::fileSystemAccessRequested(QWebEngineFileSystemAccessRequest request)

Ce signal est émis lorsque la page web demande l'accès à des fichiers ou répertoires locaux.

L'objet de demande request peut être utilisé pour accepter ou rejeter la demande.

Cette fonction a été introduite dans Qt 6.4.

[since 6.8] std::optional<QWebEngineFrame> QWebEnginePage::findFrameByName(QAnyStringView name)

Renvoie le cadre portant le nom name. S'il y a plusieurs cadres avec le même nom, celui qui est renvoyé est arbitraire. Si aucun cadre n'a été trouvé, la fonction renvoie std::nullopt.

Cette fonction a été introduite dans Qt 6.8.

void QWebEnginePage::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

Recherche la chaîne spécifiée, subString, dans la page, à l'aide de l'adresse options. Le signal findTextFinished() est émis lorsqu'une recherche de chaîne est terminée.

Pour effacer la mise en évidence de la recherche, il suffit de passer une chaîne vide.

La commande resultCallback doit prendre un paramètre QWebEngineFindTextResult.

Par exemple, il n'est pas sûr d'utiliser l'instance ou correspondante à l'intérieur :

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](const QWebEngineFindTextResult &result) {
        if (result.numberOfMatches() == 0) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

Voir aussi findTextFinished().

[signal] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

Ce signal est émis lorsqu'une recherche de chaîne de caractères sur une page est terminée. result est le résultat de la recherche de chaîne de caractères.

Voir aussi findText().

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

Ce signal est émis lorsque la page web demande à passer en mode plein écran pour un élément web, généralement un élément vidéo.

L'objet de requête fullScreenRequest peut être utilisé pour accepter ou rejeter la requête.

Si la demande est acceptée, l'élément demandant le mode plein écran remplira la fenêtre de visualisation, mais c'est à l'application de rendre la vue plein écran ou de déplacer la page vers une vue qui est plein écran.

Voir aussi QWebEngineSettings::FullScreenSupportEnabled.

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

Ce signal est émis chaque fois que le document souhaite modifier la position et la taille de la page à geom. Cela peut se produire, par exemple, par le biais de JavaScript.

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

Renvoie un pointeur sur l'historique des pages web naviguées de la vue.

[signal] void QWebEnginePage::iconChanged(const QIcon &icon)

Ce signal est émis lorsque l'icône ("favicon") associée à la page est modifiée. La nouvelle icône est spécifiée par icon.

Voir aussi icon(), iconUrl() et iconUrlChanged().

[signal] void QWebEnginePage::iconUrlChanged(const QUrl &url)

Ce signal est émis lorsque l'URL de l'icône ("favicon") associée à la page est modifiée. La nouvelle URL est spécifiée par url.

Voir aussi iconUrl(), icon() et iconChanged().

QWebEnginePage *QWebEnginePage::inspectedPage() const

Renvoie la page que cette page est en train d'inspecter, le cas échéant.

Renvoie nullptr si cette page n'est pas une page d'outils de développement.

Voir également setInspectedPage() et devToolsPage().

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

Cette fonction est appelée chaque fois qu'un programme JavaScript s'exécutant dans un cadre affilié à securityOrigin appelle la fonction alert() avec le message msg.

L'implémentation par défaut affiche le message msg avec QMessageBox::information.

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

Cette fonction est appelée chaque fois qu'un programme JavaScript s'exécutant dans un cadre affilié à securityOrigin appelle la fonction confirm() avec le message msg. Elle renvoie true si l'utilisateur confirme le message, sinon elle renvoie false.

Elle est également appelée lorsque le gestionnaire onbeforeunload demande une confirmation avant de quitter une page.

L'implémentation par défaut exécute la requête en utilisant QMessageBox::information avec les boutons QMessageBox::Ok et QMessageBox::Cancel.

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

Cette fonction est appelée lorsqu'un programme JavaScript tente d'imprimer le site message sur la console du navigateur web.

Par exemple, en cas d'erreur d'évaluation, l'URL source peut être fournie dans sourceID ainsi que dans lineNumber.

level indique la gravité de l'événement qui a déclenché le message. En d'autres termes, il s'agit de savoir si le message a été déclenché par une erreur ou un événement moins grave.

L'implémentation par défaut enregistre les messages dans un fichier js logging category .

Voir également Console Logging.

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

Cette fonction est appelée chaque fois qu'un programme JavaScript s'exécutant dans un cadre affilié à securityOrigin tente d'inviter l'utilisateur à entrer des données. Le programme peut fournir un message facultatif, msg, ainsi qu'une valeur par défaut pour la saisie dans defaultValue.

Si l'invite a été annulée par l'utilisateur, l'implémentation doit renvoyer false; sinon, le résultat doit être écrit sur result et true doit être renvoyé. Si l'invite n'a pas été annulée par l'utilisateur, l'implémentation doit renvoyer true et la chaîne de résultat ne doit pas être nulle.

L'implémentation par défaut utilise QInputDialog::getText().

[signal] void QWebEnginePage::linkHovered(const QString &url)

Ce signal est émis lorsque la souris survole un lien. url contient l'URL cible du lien.

void QWebEnginePage::load(const QUrl &url)

Charge url dans cette page.

Voir aussi setUrl(), setHtml() et setContent().

void QWebEnginePage::load(const QWebEngineHttpRequest &request)

Emet le message request spécifié et charge la réponse.

Voir aussi load(), setUrl(), url(), urlChanged() et QUrl::fromUserInput().

[signal] void QWebEnginePage::loadFinished(bool ok)

Ce signal est émis lorsque le chargement du contenu de la page est terminé. Ce signal est indépendant de l'exécution du script ou du rendu de la page. ok indique si le chargement a réussi ou si une erreur s'est produite.

Voir également loadStarted() et acceptNavigationRequest().

[signal] void QWebEnginePage::loadProgress(int progress)

Ce signal est émis lorsque l'état de progression global change. La valeur actuelle est fournie par progress et va de 0 à 100, ce qui correspond à la plage par défaut de QProgressBar. Il accumule les changements de tous les cadres enfants.

[signal] void QWebEnginePage::loadStarted()

Ce signal est émis lorsqu'une page commence à charger du contenu.

Voir aussi loadFinished() et acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

Ce signal est émis lorsque le chargement de la page spécifiée par loadingInfo commence, se termine ou échoue.

Cette fonction a été introduite dans Qt 6.2.

[since 6.8] QWebEngineFrame QWebEnginePage::mainFrame()

Cadre principal, de premier niveau, de la page. Tous les autres cadres de cette page sont accessibles en tant qu'enfants du cadre principal.

Cette fonction a été introduite dans Qt 6.8.

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

Ce signal est émis lors de la navigation en même temps que l'appel à acceptNavigationRequest(). Il peut être utilisé pour accepter ou ignorer le request. La valeur par défaut est d'accepter.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

Ce signal est émis lorsque request est utilisé pour charger une page dans une fenêtre séparée du moteur web. Cela peut être dû au fait que la page actuelle l'a demandé explicitement par le biais d'un appel JavaScript à window.open, ou au fait que l'utilisateur a cliqué sur un lien tout en maintenant Shift, Cmd/Ctrl, ou une combinaison intégrée qui déclenche l'ouverture de la page dans une nouvelle fenêtre.

Le signal est traité en appelant openIn() avec la nouvelle page sur la requête. Si ce signal n'est pas traité, le chargement demandé échouera.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi createWindow() et QWebEngineNewWindowRequest::openIn().

[signal] void QWebEnginePage::pdfPrintingFinished(const QString &filePath, bool success)

Ce signal est émis lorsque l'impression de la page web dans un fichier PDF est terminée. filePath contiendra le chemin d'accès au fichier dont la création a été demandée, et success sera true si le fichier a été créé avec succès et false dans le cas contraire.

Voir aussi printToPdf().

[signal, since 6.8] void QWebEnginePage::permissionRequested(QWebEnginePermission permission)

Ce signal est émis lorsqu'un site web demande à utiliser une fonctionnalité (par exemple, accès à la géolocalisation, autorisation d'envoyer des notifications). L'objet permission peut être interrogé pour connaître l'URL requérante et le QWebEnginePermission::Feature qu'elle demande, ainsi que pour accorder ou refuser la permission.

Cette fonction a été introduite dans Qt 6.8.

[signal] void QWebEnginePage::printRequested()

Ce signal est émis lorsque la méthode JavaScript window.print() est appelée dans le cadre principal ou que l'utilisateur a appuyé sur le bouton d'impression du plugin de visualisation PDF. Généralement, le gestionnaire du signal peut simplement appeler printToPdf().

Depuis la version 6.8, ce signal n'est émis que pour le cadre principal, au lieu d'être émis pour tout cadre demandant une impression.

Voir aussi printToPdf() et printRequestedByFrame().

[signal, since 6.8] void QWebEnginePage::printRequestedByFrame(QWebEngineFrame frame)

Ce signal est émis lorsque la méthode JavaScript window.print() est appelée sur frame. Si le cadre est le cadre principal, printRequested est émis à la place.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi printRequested(), printToPdf() et QWebEngineFrame::printToPdf().

void QWebEnginePage::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Rend le contenu actuel de la page dans un document PDF et l'enregistre à l'emplacement spécifié à l'adresse filePath. La taille et l'orientation de la page du document PDF produit sont tirées des valeurs spécifiées à l'adresse layout, tandis que l'éventail des pages imprimées est tiré de l'adresse ranges, la valeur par défaut étant l'impression de toutes les pages.

Cette méthode émet une requête asynchrone pour l'impression de la page web en PDF et renvoie immédiatement. Pour être informé du résultat de la demande, connectez-vous au signal pdfPrintingFinished().

Si un fichier existe déjà dans le chemin d'accès fourni, il sera écrasé.

Voir aussi pdfPrintingFinished().

void QWebEnginePage::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Rend le contenu actuel de la page dans un document PDF et renvoie un tableau d'octets contenant les données PDF en tant que paramètre de resultCallback. La taille et l'orientation de la page du document PDF produit sont tirées des valeurs spécifiées dans layout, tandis que la plage de pages imprimées est tirée de ranges, la valeur par défaut étant l'impression de toutes les pages.

L'adresse resultCallback doit prendre en paramètre une référence const à une adresse QByteArray. Si l'impression a réussi, ce tableau d'octets contiendra les données PDF, sinon, le tableau d'octets sera vide.

QWebEngineProfile *QWebEnginePage::profile() const

Renvoie le profil du moteur web auquel la page appartient.

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

Ce signal est émis lorsque l'accès à requestUrl via proxyHost nécessite une authentification pour le proxy. authenticator doit être utilisé pour transmettre le nom d'utilisateur et le mot de passe pour la connexion.

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

Ce signal est émis lorsque l'état audible de la page, recentlyAudible, change en raison de la lecture ou de l'arrêt de l'audio.

Si une page web contient deux vidéos lancées en séquence, ce signal n'est émis qu'une seule fois pour que la première vidéo génère du son. Après l'arrêt des deux vidéos, le signal est émis lorsque le dernier son est généré. Cela signifie que le signal est émis à la fois lorsque tout type de son est généré et lorsque tout est complètement silencieux dans une page web, quel que soit le nombre de flux audio.

Des émissions de signaux parasites peuvent également se produire. Par exemple, lorsque le son est arrêté, ce signal est émis d'abord avec une valeur de true, puis avec une valeur de false. En outre, lorsque l'audio commence à jouer, le signal est émis deux fois avec une valeur de true.

Voir aussi recentlyAudible.

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

Ce signal est émis lorsque la page web tente d'enregistrer un protocole personnalisé à l'aide de l'API registerProtocolHandler.

L'objet de requête request peut être utilisé pour accepter ou rejeter la requête :

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(window(), tr("Permission Request"),
                                        tr("Allow %1 to open all %2 links?")
                                                .arg(request.origin().host())
                                                .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

[signal] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

Ce signal est émis lorsque le PID du processus de rendu sous-jacent, pid, change.

[signal] void QWebEnginePage::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

Ce signal est émis lorsque le processus de rendu se termine avec un état de sortie non nul. terminationStatus est l'état de fin du processus et exitCode est le code d'état avec lequel le processus s'est terminé.

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

Remplacez le mot actuellement mal orthographié par replacement.

Le mot actuellement mal orthographié peut être trouvé dans QWebEngineContextMenuRequest::misspelledWord(), et les remplacements suggérés dans QWebEngineContextMenuRequest::spellCheckerSuggestions().

Exécute le code JavaScript contenu dans scriptSource sans vérifier si le DOM de la page a été construit. Si vous avez besoin de plus de contrôle sur la manière dont le script est exécuté, envisagez d'utiliser scripts() à la place.

Pour éviter les conflits avec d'autres scripts exécutés sur la page, le monde dans lequel le script est exécuté est spécifié par worldId. Les valeurs de l'ID du monde sont les mêmes que celles fournies par QWebEngineScript::ScriptWorldId, et entre 0 et 256. Si vous omettez l'ID world, le script est exécuté dans le monde MainWorld.

Lorsque le script a été exécuté, resultCallback est appelé avec le résultat de la dernière instruction exécutée. resultCallback peut être un pointeur de fonction, un foncteur ou un lambda, et il est censé prendre un paramètre QVariant. Par exemple :

page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

Seules des données simples peuvent être renvoyées par JavaScript en tant que valeur de résultat. Les types de données pris en charge comprennent tous les types de données JSON ainsi que, par exemple, Date et ArrayBuffer. Les types de données non pris en charge sont, par exemple, Function et Promise.

Voir également scripts(), QWebEngineScript::ScriptWorldId, QWebEngineFrame::runJavaScript, et Script Injection.

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

Enregistre la page web actuellement chargée sur le disque.

La page web est enregistrée à l'adresse filePath dans l'emplacement spécifié format.

Il s'agit d'un raccourci pour les actions suivantes :

• Déclencher l'action Enregistrer la page web.
• Accepter l'élément de téléchargement suivant et définir le chemin d'accès au fichier et le format d'enregistrement spécifiés.

Cette fonction émet une demande de téléchargement asynchrone pour la page web et renvoie immédiatement.

Voir aussi QWebEngineDownloadRequest::SavePageFormat.

QWebEngineScriptCollection &QWebEnginePage::scripts()

Renvoie la collection de scripts injectés dans la page.

En outre, une page peut également exécuter des scripts ajoutés par l'intermédiaire de QWebEngineProfile::scripts().

Voir également QWebEngineScriptCollection, QWebEngineScript, et Script Injection.

[signal] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

Ce signal est émis lorsqu'un site web demande un certificat client SSL et qu'un ou plusieurs ont été trouvés dans le magasin de certificats clients du système.

Le traitement de ce signal est asynchrone, et le chargement sera en attente jusqu'à ce qu'un certificat soit sélectionné, ou que la dernière copie de clientCertificateSelection soit détruite.

Si le signal n'est pas traité, clientCertificateSelection est automatiquement détruit et le chargement se poursuit sans certificat client.

Voir aussi QWebEngineClientCertificateSelection.

[signal] void QWebEnginePage::selectionChanged()

Ce signal est émis chaque fois que la sélection change, que ce soit de manière interactive ou programmatique. Par exemple, en appelant triggerAction() avec une action de sélection.

Voir aussi selectedText().

void QWebEnginePage::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

Définit le contenu de la page web à data. Si l'argument mimeType est vide, il est supposé que le contenu est text/plain,charset=US-ASCII.

Les objets externes référencés dans le contenu sont situés par rapport à baseUrl. Pour que les objets externes dont l'URL est relative soient chargés, baseUrl ne doit pas être vide.

Le site data est chargé immédiatement ; les objets externes sont chargés de manière asynchrone.

Voir aussi toHtml() et setHtml().

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

Lie devToolsPage aux outils de développement de cette page. Déclenche devToolsPage pour naviguer vers une URL interne avec les outils de développement.

Cela revient à appeler setInspectedPage() sur devToolsPage avec this comme argument.

Voir également devToolsPage() et setInspectedPage().

void QWebEnginePage::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

Définit le contenu de cette page à html. baseUrl est facultatif et utilisé pour résoudre les URL relatives dans le document, telles que les images ou les feuilles de style référencées.

La page html est chargée immédiatement ; les objets externes sont chargés de manière asynchrone.

Si un script dans html s'exécute plus longtemps que le délai d'attente par défaut (actuellement 10 secondes), par exemple parce qu'il est bloqué par une boîte de dialogue d'alerte JavaScript modale, cette méthode renverra dès que possible après le délai d'attente et toutes les pages html suivantes seront chargées de manière asynchrone.

Lorsqu'il utilise cette méthode, le moteur web suppose que les ressources externes, telles que les programmes JavaScript ou les feuilles de style, sont codées en UTF-8, sauf indication contraire. Par exemple, le codage d'un script externe peut être spécifié par l'attribut charset de la balise HTML script. Il est également possible que le codage soit spécifié par le serveur web.

Il s'agit d'une fonction de commodité équivalente à setContent(html, "text/html", baseUrl).

Voir aussi toHtml(), setContent() et load().

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

Navigue cette page vers une URL interne qui est l'outil de développement de page.

Cela revient à appeler setDevToolsPage() sur page avec this comme argument.

Voir également inspectedPage() et setDevToolsPage().

void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Enregistre l'intercepteur de requêtes interceptor pour intercepter les requêtes URL.

La page n'est pas propriétaire du pointeur. Cet intercepteur est appelé après tous les intercepteurs du profil et, contrairement aux intercepteurs de profil, seules les demandes d'URL provenant de cette page sont interceptées. Si la requête originale a déjà été bloquée ou redirigée par l'intercepteur de profil, elle ne sera pas interceptée par cet intercepteur.

Pour désactiver l'intercepteur de requêtes, définissez un nullptr.

Voir également QWebEngineUrlRequestInfo et QWebEngineProfile::setUrlRequestInterceptor().

void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

Définit l'instance de canal web à utiliser par cette page à channel et la connecte au transport du moteur web en utilisant les messages IPC de Chromium. Le transport est exposé dans le monde JavaScript worldId en tant que qt.webChannelTransport, qui devrait être utilisé lors de l'utilisation de l'API JavaScriptQt WebChannel .

Voir également webChannel() et QWebEngineScript::ScriptWorldId.

QWebEngineSettings *QWebEnginePage::settings() const

Renvoie un pointeur sur l'objet de paramétrage de la page.

[signal] void QWebEnginePage::titleChanged(const QString &title)

Ce signal est émis lorsque le titre de la page change. La chaîne title indique le nouveau titre.

Voir également title().

void QWebEnginePage::toHtml(const std::function<void (const QString &)> &resultCallback) const

Méthode asynchrone permettant de récupérer le contenu de la page au format HTML, entre les balises HTML et BODY. En cas de succès, resultCallback est appelé avec le contenu de la page.

Voir aussi setHtml() et toPlainText().

void QWebEnginePage::toPlainText(const std::function<void (const QString &)> &resultCallback) const

Méthode asynchrone permettant de récupérer le contenu de la page converti en texte brut, dépourvu de tout formatage HTML. En cas de succès, resultCallback est appelé avec le contenu de la page.

Voir aussi toHtml().

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = false)

Cette fonction peut être appelée pour déclencher l'action spécifiée action. Elle est également appelée par Qt WebEngine si l'utilisateur déclenche l'action, par exemple par le biais d'un élément de menu contextuel.

Si action est une action vérifiable, checked indique si l'action est activée ou non.

Voir aussi action().

[signal] void QWebEnginePage::urlChanged(const QUrl &url)

Ce signal est émis avec l'URL de la page lorsque le titre de la page est reçu. La nouvelle URL est spécifiée par url.

Voir aussi url().

[signal, since 6.7] void QWebEnginePage::webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

Ce signal est émis lorsqu'un authentificateur WebAuth a besoin d'une interaction avec l'utilisateur au cours du processus d'authentification. Ces demandes sont traitées en affichant une boîte de dialogue à l'utilisateur.

Le site request contient les informations et l'API nécessaires pour compléter la demande WebAuth UX.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi QWebEngineWebAuthUxRequest.

QWebChannel *QWebEnginePage::webChannel() const

Renvoie un pointeur sur l'instance de canal web utilisée par cette page ou un pointeur nul si aucun n'a été défini. Ce canal utilise automatiquement le mécanisme de transport interne du moteur web sur Chromium IPC qui est exposé dans le contexte JavaScript de cette page en tant que qt.webChannelTransport.

Voir également setWebChannel().

[signal] void QWebEnginePage::windowCloseRequested()

Ce signal est émis lorsque la page demande la fermeture de la fenêtre du navigateur web, par exemple par l'intermédiaire de l'appel JavaScript window.close().

Voir également RequestClose.

[signal, since 6.8] void QWebEnginePage::zoomFactorChanged(qreal factor)

Ce signal est émis lorsque le zoom factor de la page change.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi zoomFactor() et setZoomFactor().