QWebEngineView Class

Documentation des fonctions membres

[explicit] QWebEngineView::QWebEngineView(QWidget *parent = nullptr)

Construit une vue web vide avec le parent parent.

Voir aussi load().

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

Construit une vue web contenant page avec le parent parent.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi load() et setPage().

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

Construit une vue web vide en utilisant profile avec le parent parent.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi load().

[virtual noexcept] QWebEngineView::~QWebEngineView()

Détruit la vue web.

[slot] void QWebEngineView::back()

Fente de commodité qui charge le document précédent dans la liste des documents construits par les liens de navigation. Ne fait rien s'il n'y a pas de document précédent.

Il est équivalent à :

view->page()->triggerAction(QWebEnginePage::Back);

Voir aussi forward() et pageAction().

[override virtual protected] void QWebEngineView::closeEvent(QCloseEvent *event)

Réimplémente : QWidget::closeEvent(QCloseEvent *event).

[override virtual protected] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

Réimplémente : QWidget::contextMenuEvent(QContextMenuEvent *event).

QMenu *QWebEngineView::createStandardContextMenu()

Crée un menu contextuel standard et renvoie un pointeur vers celui-ci.

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

Cette fonction est appelée à partir de la méthode createWindow() de la page associée QWebEnginePage chaque fois que la page veut créer une nouvelle fenêtre de la page type donnée. Par exemple, lorsqu'une demande JavaScript d'ouverture d'un document dans une nouvelle fenêtre est émise.

Voir également QWebEnginePage::createWindow().

[override virtual protected] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

Réimplémente : QWidget::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

Réimplémente : QWidget::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

Réimplémente : QWidget::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)

Réimplémente : QWidget::dropEvent(QDropEvent *event).

[override virtual protected] bool QWebEngineView::event(QEvent *ev)

Réimplémente : QWidget::event(QEvent *event).

void QWebEngineView::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, en utilisant la chaîne donnée options.

Pour effacer la sélection, il suffit de passer une chaîne vide.

L'adresse resultCallback doit prendre un paramètre QWebEngineFindTextResult.

Voir aussi selectedText() et selectionChanged().

[static, since 6.2] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

Renvoie la vue, s'il y en a une, associée à page.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi page() et setPage().

[slot] void QWebEngineView::forward()

Emplacement pratique qui charge le document suivant dans la liste des documents établie par les liens de navigation. Ne fait rien s'il n'y a pas de document suivant.

Il est équivalent à :

view->page()->triggerAction(QWebEnginePage::Forward);

Voir aussi back() et pageAction().

[override virtual protected] void QWebEngineView::hideEvent(QHideEvent *event)

Réimplémente : QWidget::hideEvent(QHideEvent *event).

QWebEngineHistory *QWebEngineView::history() const

Renvoie un pointeur sur l'historique des pages web parcourues dans la vue.

C'est l'équivalent de :

view->page()->history();

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

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

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

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

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

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

[since 6.2] QWebEngineContextMenuRequest *QWebEngineView::lastContextMenuRequest() const

Renvoie des données supplémentaires sur le menu contextuel actuel. La validité de ces données n'est garantie que lors de l'appel à contextMenuEvent().

Cette fonction a été introduite dans Qt 6.2.

Voir aussi createStandardContextMenu().

void QWebEngineView::load(const QUrl &url)

Charge le site url spécifié et l'affiche.

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

void QWebEngineView::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 QWebEngineView::loadFinished(bool ok)

Ce signal est émis lorsque le chargement de la page est terminé. ok indique si le chargement a réussi ou si une erreur s'est produite.

Voir également loadStarted().

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

Ce signal est émis chaque fois qu'un élément de la vue web termine son chargement, comme une image intégrée ou un script. Il suit donc la progression collective du chargement de la vue web.

La valeur actuelle est fournie par progress et va de 0 à 100, ce qui correspond à la plage par défaut de QProgressBar.

Voir également loadStarted() et loadFinished().

[signal] void QWebEngineView::loadStarted()

Ce signal est émis lorsqu'un nouveau chargement de la page est lancé.

Voir également loadProgress() et loadFinished().

QWebEnginePage *QWebEngineView::page() const

Renvoie un pointeur sur la page web sous-jacente.

Voir aussi setPage().

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

Renvoie un pointeur vers QAction qui encapsule l'action web spécifiée action. Cette fonction attribue également une icône stylisée par défaut à l'adresse QAction s'il n'y en a pas.

[signal, since 6.2] void QWebEngineView::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.

Cette fonction a été introduite dans Qt 6.2.

Voir également printToPdf().

[since 6.2] void QWebEngineView::print(QPrinter *printer)

Rend le contenu actuel de la page dans un document PDF temporaire, puis l'imprime à l'aide de printer.

Les paramètres de création et d'impression du document PDF seront récupérés à partir de l'objet printer.

Une fois l'opération terminée, le signal printFinished() est émis avec la valeur true en cas de succès ou false en cas d'échec.

Il incombe à l'utilisateur de s'assurer que l'objet printer reste valide jusqu'à ce que printFinished() soit émis. Si la page est détruite avant l'émission de printFinished(), l'impression se poursuivra en arrière-plan pendant un court moment. Les utilisateurs doivent s'assurer que l'imprimante reste valide jusqu'à ce que son état ne soit plus actif.

Cette fonction a été introduite dans Qt 6.2.

[signal, since 6.2] void QWebEngineView::printFinished(bool success)

Ce signal est émis lorsque l'impression demandée avec print() est terminée. Le paramètre success est true en cas de succès ou false en cas d'échec.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi print().

[signal, since 6.2] void QWebEngineView::printRequested()

Ce signal est émis lorsque la méthode JavaScript window.print() est appelée 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 print().

Depuis la version 6.8, ce signal n'est émis que pour la trame principale, au lieu d'être émis pour toute trame demandant une impression.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi printRequestedByFrame() et print().

[signal, since 6.8] void QWebEngineView::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() et print().

[since 6.2] void QWebEngineView::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é.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi pdfPrintingFinished().

[since 6.2] void QWebEngineView::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.

Cette fonction a été introduite dans Qt 6.2.

[slot] void QWebEngineView::reload()

Recharge le document actuel.

Voir aussi stop(), pageAction() et loadStarted().

[signal] void QWebEngineView::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é.

[signal] void QWebEngineView::selectionChanged()

Ce signal est émis chaque fois que la sélection change.

Voir également selectedText().

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

Définit le contenu de la vue 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.

Les données sont chargées immédiatement ; les objets externes sont chargés de manière asynchrone.

Voir également load(), setHtml() et QWebEnginePage::toHtml().

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

Définit le contenu de la vue Web en fonction du contenu html spécifié.

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. Par exemple, si html est récupéré à partir de http://www.example.com/documents/overview.html, qui est l'URL de base, une image référencée avec l'URL relative, diagram.png, devrait se trouver à http://www.example.com/documents/diagram.png.

Le document HTML est chargé immédiatement, tandis que les objets externes sont chargés de manière asynchrone.

Lorsque cette méthode est utilisée, Qt WebEngine 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. Le codage peut également être spécifié par le serveur web.

Il s'agit d'une fonction de commodité équivalente à setContent(html, "text/html;charset=UTF-8", baseUrl).

Voir également load(), setContent(), QWebEnginePage::toHtml() et QWebEnginePage::setContent().

void QWebEngineView::setPage(QWebEnginePage *page)

Fait de page la nouvelle page web de la vue web.

Le parent QObject de la page fournie reste propriétaire de l'objet. Si la page actuelle est un enfant de la vue Web, elle sera supprimée.

Voir également page().

QWebEngineSettings *QWebEngineView::settings() const

Renvoie un pointeur sur l'objet de paramétrage spécifique à la vue ou à la page.

Il est équivalent à :

view->page()->settings();

[override virtual protected] void QWebEngineView::showEvent(QShowEvent *event)

Réimplémente : QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QWebEngineView::sizeHint() const

Réimplémente une fonction d'accès à la propriété : QWidget::sizeHint.

[slot] void QWebEngineView::stop()

Emplacement pratique qui arrête le chargement du document.

Il est équivalent à :

view->page()->triggerAction(QWebEnginePage::Stop);

Voir aussi reload(), pageAction() et loadFinished().

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

Ce signal est émis lorsque le site title de la vue change.

Voir également title().

void QWebEngineView::triggerPageAction(QWebEnginePage::WebAction action, bool checked = false)

Déclenche l'action spécifiée action. S'il s'agit d'une action vérifiable, l'état checked spécifié est pris en compte.

L'exemple suivant déclenche l'action de copie et copie donc tout texte sélectionné dans le presse-papiers.

view->triggerPageAction(QWebEnginePage::Copy);

Voir également pageAction().

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

Ce signal est émis lorsque le site url de la vue change.

Voir également url() et load().