Vue d'ensemble du contrôle WebBrowser

  • Article

Le WebBrowser contrôle fournit un wrapper managé pour le contrôle ActiveX WebBrowser. Le wrapper managé vous permet d’afficher des pages web dans vos applications clientes Windows Forms. Vous pouvez utiliser le WebBrowser contrôle pour dupliquer les fonctionnalités de navigation web Internet Explorer dans votre application ou désactiver la fonctionnalité Internet Explorer par défaut et utiliser le contrôle en tant que visionneuse de documents HTML simple. Vous pouvez également utiliser le contrôle pour ajouter des éléments d’interface utilisateur DHTML à votre formulaire et masquer le fait qu’ils sont hébergés dans le WebBrowser contrôle. Cette approche vous permet de combiner en toute transparence des contrôles Web avec des contrôles Windows Forms dans une seule application.

Propriétés, méthodes et événements fréquemment utilisés

Le WebBrowser contrôle a plusieurs propriétés, méthodes et événements que vous pouvez utiliser pour implémenter des contrôles trouvés dans Internet Explorer. Par exemple, vous pouvez utiliser la Navigate méthode pour implémenter une barre d’adresses, et les GoBackméthodes GoForward, Stopet Refresh les méthodes pour implémenter des boutons de navigation dans une barre d’outils. Vous pouvez gérer l’événement Navigated pour mettre à jour la barre d’adresses avec la valeur de la Url propriété et la barre de titre avec la valeur de la DocumentTitle propriété.

Si vous souhaitez générer votre propre contenu de page au sein de votre application, vous pouvez définir la DocumentText propriété. Si vous connaissez le modèle DOM (Document Object Model) HTML, vous pouvez également manipuler le contenu de la page Web active via la Document propriété. Avec cette propriété, vous pouvez stocker et modifier des documents en mémoire au lieu de naviguer entre les fichiers.

La Document propriété vous permet également d’appeler des méthodes implémentées dans le code de script de page web à partir du code de votre application cliente. Pour accéder au code de votre application cliente à partir de votre code de script, définissez la ObjectForScripting propriété. L’objet que vous spécifiez est accessible par votre code de script en tant qu’objet window.external .

Nom Description
Propriété Document Obtient un objet qui fournit un accès géré au modèle d’objet de document HTML (DOM) de la page Web active.
ÉvénementDocumentCompleted Se produit lorsqu’une page Web termine le chargement.
Propriété DocumentText Obtient ou définit le contenu HTML de la page Web active.
Propriété DocumentTitle Obtient le titre de la page Web active.
Méthode GoBack Accède à la page précédente dans l’historique.
Méthode GoForward Accède à la page suivante dans l’historique.
Méthode Navigate Accède à l'URL spécifiée.
ÉvénementNavigating Se produit avant le début de la navigation, ce qui permet l’annulation de l’action.
Propriété ObjectForScripting Obtient ou définit un objet que le code de script de page web peut utiliser pour communiquer avec votre application.
Méthode Print Imprime la page Web active.
Méthode Refresh Recharge la page web active.
Méthode Stop Arrête la navigation actuelle et arrête les éléments de page dynamiques tels que les sons et l’animation.
Propriété Url Obtient ou définit l’URL de la page Web active. La définition de cette propriété permet au contrôle d’accéder à la nouvelle URL.

Voir aussi